@hoilab/ada-cli 0.84.21 → 0.84.22

package/CHANGELOG.md

@@ -2,9 +2,27 @@
 
 ## [Unreleased]
 
+### Added
+
+- Added transcript usage notices for compaction and branch summaries when cache miss notices are enabled.
+
 ### Fixed
 
+- Fixed UTF-8 BOM markers preventing frontmatter and user configuration files from loading ([#8337](https://github.com/earendil-works/pi/issues/8337)).
+- Fixed invalid settings files being easy to miss during interactive startup by rendering warnings with the file path inside the TUI ([#7829](https://github.com/earendil-works/pi/issues/7829)).
+- Fixed the subagent example repeatedly prompting before running project-local agents in trusted repositories ([#8261](https://github.com/earendil-works/pi/issues/8261)).
+- Added `session_compact_failed` extension events so compaction failures and aborts expose their reason, retry state, source, and error message to handlers ([#8175](https://github.com/earendil-works/pi/issues/8175)).
+- Fixed npm package update checks treating older registry versions as available updates, preventing `pi update` from downgrading already-newer installed packages ([#8226](https://github.com/earendil-works/pi/issues/8226)).
+- Fixed built-in llama.cpp models disappearing from `/model` when `/llama` refreshed a configured server under `PI_OFFLINE`, and included idle-slept `sleeping` router models in the selectable catalog ([#8167](https://github.com/earendil-works/pi/issues/8167)).
+- Fixed `pi.registerFlag()` accepting default values that do not match the declared flag type ([#8064](https://github.com/earendil-works/pi/issues/8064)).
 - Fixed Z.AI Coding Plan defaults referencing the removed GLM-5.1 model ([#8096](https://github.com/earendil-works/pi/issues/8096)).
+- Fixed repeated ambiguous truncated-response recovery being mislabeled as context overflow ([#8130](https://github.com/earendil-works/pi/issues/8130)).
+- Fixed duplicate fullscreen right-click paste in VS Code-based terminals on Windows ([#8186](https://github.com/earendil-works/pi/issues/8186)).
+- Fixed llama.cpp login guidance to direct users to `/llama` before `/model` when no local models are loaded ([#8203](https://github.com/earendil-works/pi/issues/8203)).
+- Fixed hung pi.dev model catalog requests consuming the entire refresh deadline without retrying ([#8198](https://github.com/earendil-works/pi/issues/8198)).
+- Fixed inherited Xiaomi model catalogs listing shut-down MiMo V2 models in `/model` and `--list-models` ([#8187](https://github.com/earendil-works/pi/issues/8187)).
+- Fixed branch summary entries recording the navigation destination in `fromId` instead of the pre-navigation source leaf.
+- Fixed threshold auto-compaction being skipped when providers omit streaming usage data ([#8328](https://github.com/earendil-works/pi/issues/8328)).
 
 ## [0.84.2] - 2026-08-14
 
@@ -36,6 +54,8 @@
 
 ### Fixed
 
+- Fixed root Markdown files such as `README.md` and `AGENTS.md` in skill directories being reported as broken skills unless they declare valid skill frontmatter ([#7805](https://github.com/earendil-works/pi/issues/7805)).
+- Fixed single-object `edit` tool inputs failing validation by accepting them as one-edit arrays in both coding-agent and harness edit tools ([#7835](https://github.com/earendil-works/pi/issues/7835)).
 - Fixed managed-tool downloads delaying TUI startup and hiding diagnostics in fullscreen mode by mounting the TUI first and showing download progress and warnings inside it.
 - Fixed opening a model selector immediately after startup cancelling and restarting the in-progress model catalog refresh.
 - Fixed inherited GitHub Copilot login triggering API rate limits while enabling model policies by limiting concurrent policy updates ([#6187](https://github.com/earendil-works/pi/issues/6187)).

package/README.es.md

@@ -0,0 +1,163 @@
+<p align="center">
+<pre>
+  █████╗ ██████╗  █████╗
+ ██╔══██╗██╔══██╗██╔══██╗
+ ███████║██║  ██║███████║
+ ██╔══██║██║  ██║██╔══██║
+ ██║  ██║██████╔╝██║  ██║
+ ╚═╝  ╚═╝╚═════╝ ╚═╝  ╚═╝
+</pre>
+</p>
+
+<h3 align="center">Ada CLI — el agente de código autónomo de nivel enterprise</h3>
+
+<p align="center">
+  <a href="https://discord.com/invite/3cU7Bz4UPx"><img alt="Discord" src="https://img.shields.io/badge/discord-community-5865F2?style=flat-square&logo=discord&logoColor=white" /></a>
+  <a href="https://www.npmjs.com/package/@hoilab/ada-cli"><img alt="npm" src="https://img.shields.io/npm/v/@hoilab/ada-cli?style=flat-square" /></a>
+</p>
+
+<p align="center"><a href="README.md">🇬🇧 English</a> · 🇪🇸 Español</p>
+
+> Ada CLI es el fork de HOILAB de [pi.dev](https://pi.dev) (`earendil-works/pi`): el binario `pi` pasa a ser `ada-cli`, la configuración se mueve a `~/.ada/`, y el fork se sincroniza automáticamente con upstream cada día para que los parches de seguridad y los modelos nuevos lleguen sin demora. Ver [ADA-CLI.md](../../ADA-CLI.md) para la mecánica completa de sincronización. Los issues y PRs de contribuidores nuevos se cierran automáticamente por defecto — ver [CONTRIBUTING.md](../../CONTRIBUTING.md).
+
+---
+
+Ada CLI es un agente de código construido sobre el núcleo mínimo y probado de pi.dev, con un **Ada Intelligence Engine** añadido encima: persecución autónoma de objetivos con un juez obligatorio que exige evidencia, workflows paralelos en sandbox, un grafo de trazabilidad que bloquea el "hecho" sin evidencia observada, memoria durable entre sesiones con log de auditoría a prueba de manipulación y escaneo de PII, secretos cifrados, y una app de escritorio nativa — todo conectado al mismo `settings.json` que ya usa tu terminal.
+
+Donde la mayoría de agentes de código te piden confiar en un chat largo sin más, Ada está construido para ser **auditable**: cada acción autónoma tiene evidencia citada detrás, o no ocurre.
+
+- **Todo es opcional e inspeccionable.** El núcleo se mantiene tan mínimo como el de pi.dev — cuatro tools (`read`, `write`, `edit`, `bash`) por defecto. Autonomía, memoria y orquestación son capas opcionales que puedes desactivar en `settings.json`.
+- **La autonomía exige un contrato aprobado.** El [Goal Engine](#ada-intelligence-engine) no toca el código hasta que apruebas su plan con `/goal approve`, ejecuta fases TDD fijas, y nunca marca un trabajo como `done` sin que un juez cite la evidencia.
+- **Nada está "hecho" solo porque el modelo lo diga.** El [Work Graph](#ada-intelligence-engine) bloquea dar algo por completado sin evidencia observada — un test que pasa, un diff real, un comando verificado — nunca una afirmación en el transcript.
+- **La memoria es compliance-ready por defecto.** El [Memory Engine](#ada-intelligence-engine) bloquea datos PII antes de escribirlos en disco y mantiene un log de auditoría encadenado (hash-chain) de cada escritura y rechazo.
+- **Los secretos nunca tocan el contexto del modelo.** El [Vault](#ada-intelligence-engine) integrado es un almacén local cifrado, compartido entre el CLI, la app de escritorio y los subagentes de una sesión desbloqueada.
+- **Los equipos tienen una GUI, no solo terminal.** La app [Ada Desktop](../../desktop/) (Tauri + Next.js) usa exactamente el mismo SDK y la misma configuración que el CLI — sin producto paralelo que mantener.
+- **Extensible en vez de opinada.** Sin MCP integrado por defecto, sin framework de sub-agentes forzado, sin popups de permisos — construye exactamente el flujo que necesitas con [extensiones](docs/extensions.md), [skills](docs/skills.md), o [paquetes de Ada](docs/packages.md) de terceros. Ver [Filosofía](#filosofía).
+
+## Primeros pasos
+
+```bash
+npm install -g --ignore-scripts @hoilab/ada-cli
+```
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+ada-cli
+```
+
+O autentica con una suscripción existente: ejecuta `ada-cli` y luego `/login`. La primera vez que arrancas en un proyecto nuevo, Ada pide confiar en la carpeta — ver [Project Trust](docs/security.md).
+
+Guía completa: [Quickstart](docs/quickstart.md) · [Proveedores y modelos](docs/providers.md) · [Windows](docs/windows.md) · [Termux](docs/termux.md) · [tmux](docs/tmux.md)
+
+## Pensado para enterprise
+
+- **Autonomía gobernada.** Los modos de permiso (`ask` / `auto` / `plan` / `full`) y los frenos `askBefore` del Goal Engine bloquean acciones irreversibles (publicar, borrar, gastar) tras aprobación explícita, tanto en el CLI como en la app de escritorio.
+- **Evidencia por encima de afirmaciones.** Tanto el juez del Goal Engine como los gates del Work Graph exigen evidencia citada y observada antes de contar algo como completo — ningún run autónomo puede marcarse "hecho" en silencio.
+- **Privacidad y auditoría integradas.** `memoryPrivacyLevel: "strict"` (por defecto) bloquea PII antes de persistirla; cada escritura, rechazo y búsqueda de memoria queda encadenada (hash-chain) en un log de auditoría vía `/memory-audit` — pensado para sostener obligaciones de RGPD/AI Act sin herramientas adicionales.
+- **Aislamiento de secretos.** Las credenciales del Vault nunca entran en el contexto de prompt del modelo ni tocan disco sin cifrar.
+- **Runs presupuestados y acotados.** Toda superficie autónoma (Goal Engine, Workflows) impone límites de turnos, detección de bucles repetidos, un stop-file como interruptor de emergencia, y presupuestos de tokens/coste — sin gasto abierto.
+- **Desplegable como CLI o escritorio.** Mismo SDK, mismo `settings.json`, mismo rastro de auditoría, trabaje tu equipo en terminal o en una GUI.
+- **Siempre al día automáticamente.** Una sincronización diaria determinista (`scripts/sync-ada.sh` + GitHub Action) rebasa sobre pi.dev upstream, así que los parches de seguridad y el soporte de nuevos proveedores llegan sin seguimiento manual de parches.
+
+## Ada Intelligence Engine
+
+pi.dev es deliberadamente mínimo — su propia filosofía es saltarse sub-agentes y modo plan, dejando que cada equipo lo extienda a su manera. Ada CLI apuesta lo contrario: envía esa capa de orquestación como parte del producto.
+
+| Módulo | Para qué sirve |
+|---|---|
+| 🎯 **Goal Engine** (`/goal`) | Persigue un objetivo de forma autónoma, turno a turno, a través de fases TDD fijas, bloqueado por un contrato (`doneCriteria` + `verifyCommand`) que hay que aprobar antes de empezar. Un juez obligatorio exige evidencia citada antes de marcar algo como hecho, respaldado por frenos de seguridad (límite de turnos, detección de bucles, stop-file, presupuesto de coste/tokens). |
+| ⚙️ **Workflows** (`/workflow`) | Orquesta varios agentes en paralelo mediante scripts JS en sandbox, presupuestados y resumibles tras una interrupción. Trae 5 builtins listos para usar: investigación profunda, code review, construir producto, auditoría de código, multi-perspectiva. |
+| 🕸️ **Work Graph** (`/graph`) | Un grafo tipado que conecta intención → requisito → tarea → archivo → test. Los gates bloquean declarar un trabajo "hecho" sin evidencia observada — nunca solo con la palabra del modelo. |
+| 🧠 **Memory Engine** (`/memory-audit`, `/memory-consolidate`, `/memory-insights`) | Memoria durable en 3 capas (global, proyecto, fallos pasados) con búsqueda de texto completo sobre sesiones anteriores, un log de auditoría a prueba de manipulación, y un escáner de PII que bloquea datos sensibles antes de guardarlos. |
+| ✨ **Prompt Optimizer** | Antes de procesar una petición, decide si hace falta preguntar hasta 3 huecos críticos (`clarify`) o reescribirla como prompt estructurado (`enhance`). |
+| 🔐 **Vault** (`/vault`) | Almacén local de secretos cifrado con passphrase, compartido entre el CLI, la app de escritorio y los subagentes de una sesión desbloqueada. |
+| 🖥️ **App de escritorio** | Tauri 2 + Next.js, sobre el mismo SDK y `settings.json` que el CLI. pi.dev es solo terminal. |
+
+<details>
+<summary><b>Comparativa fila a fila vs. pi.dev upstream</b> (verificado contra ambos códigos fuente)</summary>
+
+| | pi.dev (upstream) | Ada CLI (este fork) |
+|---|---|---|
+| Producto | CLI (`pi`) | CLI (`ada-cli`) **+ app de escritorio** |
+| Autonomía multi-turno | No incluida — se salta sub-agentes y modo plan por diseño | **Goal Engine**: bucle contrato-primero, fases TDD fijas, juez obligatorio con evidencia citada, frenos de seguridad |
+| Paralelismo orquestado | No | **Workflows**: scripts JS en sandbox (`node:vm`) con `agent()/parallel()/pipeline()`, journal resumible, 5 builtins |
+| Trazabilidad del trabajo | No | **Work Graph**: grafo tipado con finalización bloqueada por evidencia |
+| Memoria entre sesiones | Solo dentro de la sesión activa / context files (`AGENTS.md`) | **Memory Engine**: 3 capas durables + búsqueda de texto completo entre sesiones + log de auditoría a prueba de manipulación + escáner de PII |
+| Optimización de prompts | No | **Prompt Optimizer**: `clarify` o `enhance` antes de procesar |
+| Secretos | No | **Vault**, cifrado, compartido CLI/desktop/subagentes |
+| Slash commands | El set base de pi.dev | + `/goal` `/workflow` `/graph` `/vault` `/memory-audit` `/memory-consolidate` `/memory-insights` |
+| Anti-recursión | N/A | Las tools `goal_*`/`workflow`/`graph_add_nodes`/memoria solo se registran en la sesión principal — los subagentes nunca se auto-orquestan |
+| Sincronización con upstream | — (es el upstream) | Reset diario determinista + reaplicación de delta, sin merges manuales |
+
+</details>
+
+<details>
+<summary><b>Ada CLI vs. Prime Agent</b> (otro fork de pi.dev, 17k+ ⭐)</summary>
+
+[PrimeIntellect-ai/prime-agent](https://github.com/PrimeIntellect-ai/prime-agent) también está construido sobre `earendil-works/pi`, con un modelo de ejecución basado en un kernel Python persistente y un "Continual Harness" auto-mejorable. Desglose completo con fuentes: [docs/AUDIT.md §7.5](../../docs/AUDIT.md).
+
+| Capacidad | Ada CLI | Prime Agent | Ventaja |
+|---|---|---|---|
+| Sesiones en background que sobreviven al cierre de terminal | No | Basado en daemon, `attach`/`detach` | Prime Agent |
+| Mensajería agente-a-agente | Bloqueada a propósito (anti-recursión por diseño) | Incluida | Trade-off de diseño, no un gap |
+| Scheduling / heartbeats | No | `/heartbeat`, cron schedules | Prime Agent |
+| Auto-mejora de instrucciones | La memoria guarda, no se auto-edita | `/refine` con snapshots de rollback | Prime Agent |
+| Skills ejecutables / con Python | Solo markdown | Paquetes Python + skill-creator | Prime Agent |
+| Grafo de trazabilidad del trabajo | Sí, con gates de evidencia | No tiene | **Ada CLI** |
+| App de escritorio nativa | Sí | Solo TUI | **Ada CLI** |
+| Vault de secretos cifrado dedicado | Sí | `auth.json` plano | **Ada CLI** |
+| Juez obligatorio con evidencia | Sí, por defecto | Gates configurables por el usuario, no forzados | **Ada CLI** |
+
+Ver [docs/AUDIT.md](../../docs/AUDIT.md) para la auditoría técnica completa, la mecánica exacta de fork/sync, y las mejoras propuestas (daemon en background, scheduling, memoria auto-mejorable) mapeadas a cómo encajarían en el motor ya existente.
+
+</details>
+
+### Las tres garantías, y lo que NO son
+
+Están impuestas en código, no por política. Cada línea es comprobable: abre el fichero y léelo.
+
+| Garantía | Dónde se impone |
+|---|---|
+| **Un goal no puede completarse sin que un juez cite evidencia.** El juez es independiente, solo ve el objetivo, sus `doneCriteria`, el `verifyCommand` y la evidencia citada, y corre cross-model. Sin veredicto no hay completado. | `workflows/goal-engine/engine.ts` (`runJudge`), `resource-loader.ts` |
+| **Un subagente no puede orquestar ni escribir memoria durable — estructuralmente.** Las tools sencillamente no existen en su registro; no es una comprobación de permisos que se pueda relajar. Aserto en `test/anti-recursion-tools.test.ts`. | `agent-session.ts` (gates de `_isSubagentSession`) |
+| **La memoria se escribe a través de un escáner de PII y un log de auditoría encadenado.** Los rechazos también quedan registrados, y `/memory-audit` verifica la cadena. | `memory-engine/scanner.ts`, `memory-engine/audit.ts` |
+
+**Lo que Ada NO afirma.** El sandbox `node:vm` contiene el *script orquestador*: no tiene `require`, `process` ni `import`, y no puede tocar el host. Pero los **agentes hoja que lanza son sesiones normales** con `read`/`bash`/`edit`/`write` y los mismos permisos de SO que cualquier agente de código, incluido el tuyo. Ada no es un sandbox de sistema operativo y no pretende serlo; para trabajo no confiable, ejecútalo en un contenedor. Lo que sí está contenido es la capa de orquestación, y las credenciales viven en un vault cifrado en vez de en variables de entorno en claro.
+
+Referencia de comandos del engine, esquema de `settings.json` y reglas de enrutado de modelos: [docs/AUDIT.md §4](../../docs/AUDIT.md) cubre la arquitectura; la sintaxis de `/goal`, `/workflow`, `/graph`, `/memory-*` y `/vault` está documentada inline vía `--help` y `/hotkeys` en el propio CLI.
+
+## Documentación
+
+- [Quickstart](docs/quickstart.md) — instalar, autenticar, ejecutar la primera sesión
+- [Usando Ada](docs/usage.md) — modo interactivo, slash commands, referencia del CLI
+- [Referencia TUI](docs/tui.md) — atajos de teclado completos, cola de mensajes, navegación del árbol
+- [Sesiones](docs/sessions.md) · [Compactación](docs/compaction.md) — branching, forking, gestión de contexto
+- [Settings](docs/settings.md) — configuración global y de proyecto
+- [Seguridad](docs/security.md) · [Containerización](docs/containerization.md) — confianza de proyecto, sandboxing
+- [Extensiones](docs/extensions.md) · [Skills](docs/skills.md) · [Prompt templates](docs/prompt-templates.md) · [Temas](docs/themes.md) · [Paquetes de Ada](docs/packages.md)
+- [SDK](docs/sdk.md) · [Modo RPC](docs/rpc.md) · [Modo JSON](docs/json.md) — uso headless y embebido
+- [docs/AUDIT.md](../../docs/AUDIT.md) — arquitectura del fork, mecánica de sync, y el análisis competitivo completo
+
+## Filosofía
+
+Ada se mantiene extensible en vez de opinada: sin MCP integrado por defecto (construye una skill o extensión en su lugar — [por qué](https://mariozechner.at/posts/2025-11-02-what-if-you-dont-need-mcp/)), sin framework de sub-agentes forzado, sin popups de permisos, sin to-dos integrados. Construye exactamente lo que tu flujo necesita con [extensiones](docs/extensions.md), [skills](docs/skills.md), o un [paquete de Ada](docs/packages.md) de terceros — ver la [justificación original de pi.dev](https://mariozechner.at/posts/2025-11-30-pi-coding-agent/).
+
+## Contribuir y desarrollo
+
+Ver [CONTRIBUTING.md](../../CONTRIBUTING.md) y [docs/development.md](docs/development.md).
+
+## Licencia
+
+MIT
+
+## Ver también
+
+- [@earendil-works/pi-ai](https://www.npmjs.com/package/@earendil-works/pi-ai) — toolkit LLM base
+- [@earendil-works/pi-agent-core](https://www.npmjs.com/package/@earendil-works/pi-agent-core) — framework de agentes
+- [@earendil-works/pi-tui](https://www.npmjs.com/package/@earendil-works/pi-tui) — componentes de UI de terminal
+
+<p align="center">
+  El dominio <a href="https://pi.dev">pi.dev</a> fue donado generosamente por
+  <br /><br />
+  <a href="https://exe.dev"><img src="docs/images/exy.png" alt="Mascota Exy" width="48" /><br />exe.dev</a>
+</p>