@evolith/smart-cli 1.1.6 → 1.1.7

package/README.es.md

@@ -56,7 +56,30 @@ O descarga el binario desde [GitHub Releases](https://github.com/beyondnetcode/e
 
 ```bash
 smart-cli --version
-# 1.1.4
+# 1.1.7
+```
+
+### Experiencia de instalación
+
+El paquete npm incluye una animación corta de setup y una pantalla de bienvenida en `postinstall`. npm controla la descarga y extracción de dependencias antes de ejecutar scripts del paquete, y las versiones modernas de npm ocultan la salida de lifecycle scripts salvo que se activen foreground scripts. Para ver la experiencia de bienvenida:
+
+```bash
+npm install -g @evolith/smart-cli --foreground-scripts
+```
+
+Para ocultar la bienvenida en automatización:
+
+```bash
+EVOLITH_SMART_CLI_POSTINSTALL=0 npm install -g @evolith/smart-cli
+```
+
+### Desinstalación
+
+Las versiones modernas de npm no ejecutan hooks lifecycle de desinstalación de paquetes, así que un paquete no puede imprimir de forma confiable una despedida automática durante `npm uninstall`. Usa `goodbye` antes de remover el paquete cuando quieras ver el mensaje de cierre y las sugerencias de limpieza:
+
+```bash
+smart-cli goodbye
+npm uninstall -g @evolith/smart-cli
 ```
 
 ### Solución de Problemas
@@ -75,7 +98,7 @@ export PATH=$(npm config get prefix)/bin:$PATH
 
 ### Variables de entorno
 
-La CLI funciona sin configuración. Las siguientes variables son overrides opcionales. Las marcadas *(MCP)* las lee únicamente el paquete incluido `@evolith/mcp-server` mientras `smart-cli mcp serve` está en ejecución.
+La CLI funciona sin configuración. Las siguientes variables son overrides opcionales. Las marcadas *(MCP)* las lee únicamente el paquete independiente `@evolith/mcp-server` mientras `smart-cli mcp serve` está en ejecución.
 
 | Variable | Leída por | Propósito |
 |---|---|---|
@@ -289,6 +312,40 @@ smart-cli validate --engine opa --ruleset acl
 
 ---
 
+### evaluate
+
+Ejecuta el motor stateless de evaluación de Evolith desde la CLI e imprime un envelope ADR-0073. Úsalo cuando la automatización necesite la misma superficie canónica de evaluación expuesta por integraciones API.
+
+```bash
+smart-cli evaluate [opciones]
+
+Opciones:
+  --context <ruta>       Archivo JSON con un EvaluationContext canónico
+  -w, --workspace <ruta> Ruta local del workspace (por defecto: perfil activo o cwd)
+  -c, --core <ruta>      Ruta del checkout de Evolith Core
+  -p, --phase <id>       Fase SDLC: discovery, design, construction, qa, release
+  -t, --topology <id>    Override de topología de arquitectura
+  -f, --format <formato> Formato de salida: json o text (por defecto: json)
+```
+
+**Ejemplos:**
+
+```bash
+# Evaluar el repositorio actual con contexto por defecto
+smart-cli evaluate
+
+# Evaluar un workspace específico para un gate de diseño
+smart-cli evaluate --workspace ../my-service --phase design
+
+# Evaluar con override de topología microservices
+smart-cli evaluate --workspace ../my-service --topology microservices --format text
+
+# Usar un EvaluationContext canónico preparado
+smart-cli evaluate --context ./evaluation-context.json --format json
+```
+
+---
+
 ### adr
 
 Gestiona Architecture Decision Records.
@@ -709,6 +766,71 @@ smart-cli profile delete --name staging
 
 ---
 
+### satellite:create
+
+Crea un nuevo repositorio de GitHub y lo registra como satélite Evolith. Requiere `--token` o `GITHUB_TOKEN`.
+
+```bash
+smart-cli satellite:create [opciones]
+
+Opciones:
+  -n, --name <name>             Nombre del nuevo repositorio GitHub
+  -o, --owner <owner>           Usuario u organización GitHub
+      --topology <topology>     monolith, modular, micro, distributed
+      --phase <phase>           discovery, design, construction, qa, release
+      --private                 Crear un repositorio privado
+  -d, --description <texto>     Descripción del repositorio
+  -t, --token <token>           Token GitHub (por defecto GITHUB_TOKEN)
+```
+
+**Ejemplos:**
+
+```bash
+# Creación interactiva
+smart-cli satellite:create
+
+# Crear un satélite modular privado en discovery
+GITHUB_TOKEN=$GITHUB_TOKEN smart-cli satellite:create \
+  --name orders-service \
+  --owner beyondnetcode \
+  --topology modular \
+  --phase discovery \
+  --private \
+  --description "Bounded context de órdenes"
+```
+
+---
+
+### satellite:adopt
+
+Adopta un repositorio GitHub existente dentro de la gobernanza Evolith sin crear un repositorio remoto nuevo. Requiere `--token` o `GITHUB_TOKEN` para operaciones de API de GitHub.
+
+```bash
+smart-cli satellite:adopt [opciones]
+
+Opciones:
+  --repo <url>              URL del repositorio GitHub existente
+  --owner <owner>           Override del owner GitHub
+  --topology <topology>     monolith, modular, micro, distributed, custom
+  --phase <phase>           alpha, beta, rc, ga
+  --token <token>           Token GitHub (por defecto GITHUB_TOKEN)
+```
+
+**Ejemplos:**
+
+```bash
+# Adopción interactiva
+smart-cli satellite:adopt
+
+# Adoptar un repositorio existente
+smart-cli satellite:adopt \
+  --repo https://github.com/beyondnetcode/ums \
+  --topology modular \
+  --phase beta
+```
+
+---
+
 ### fixtures
 
 Siembra archivos de fixtures reproducibles para demos, tests y onboarding. El primer paso recomendado en cualquier entorno nuevo.
@@ -903,6 +1025,47 @@ smart-cli history --clear
 
 ---
 
+### chat
+
+Envía un intento en lenguaje natural al Evolith Agent Runtime incluido. El comando ejecuta en dry-run por defecto salvo que el runtime soporte y reciba un override explícito.
+
+```bash
+smart-cli chat <mensaje> [opciones]
+
+Opciones:
+  --dry-run <boolean>   Mantener ejecución en modo dry-run salvo que se defina en false
+```
+
+**Ejemplos:**
+
+```bash
+# Pedir una interpretación orientada a gobernanza
+smart-cli chat "review this repository for SDLC gate readiness"
+
+# Permitir que un runtime compatible salga de dry-run
+smart-cli chat "prepare a validation plan for the checkout" --dry-run false
+```
+
+---
+
+### goodbye
+
+Muestra guía de desinstalación, sugerencias opcionales de limpieza y el mensaje de cierre antes de remover la CLI.
+
+```bash
+smart-cli goodbye
+```
+
+**Ejemplos:**
+
+```bash
+# Ver despedida y sugerencias de limpieza, luego desinstalar globalmente
+smart-cli goodbye
+npm uninstall -g @evolith/smart-cli
+```
+
+---
+
 ### completion
 
 Genera e instala scripts de autocompletado de shell. También provee funciones hook de shell para mostrar contexto y estado.
@@ -946,9 +1109,9 @@ Los scripts pre-construidos también vienen incluidos en el paquete bajo `shell/
 
 ## Servidor MCP
 
-La CLI de Evolith incluye un servidor MCP listo para producción para la integración con agentes IA.
+La CLI de Evolith puede lanzar el servidor MCP independiente listo para producción para la integración con agentes IA.
 
-> **Aviso de deprecación:** `smart-cli mcp` imprime una advertencia de deprecación al arrancar y será removido en una futura versión mayor. El servidor MCP ahora se distribuye como paquete independiente — migra a `@evolith/mcp-server` (`npx @evolith/mcp-server serve` o el binario `evolith-mcp serve`). El comando CLI sigue funcionando mientras tanto delegando de forma perezosa (lazy) en ese paquete.
+> **Aviso de deprecación:** `smart-cli mcp` imprime una advertencia de deprecación al arrancar y será removido en una futura versión mayor. El servidor MCP ahora se distribuye como paquete independiente — migra a `@evolith/mcp-server` (`npx @evolith/mcp-server serve` o el binario `evolith-mcp serve`). El comando CLI sigue funcionando mientras tanto invocando ese paquete bajo demanda.
 
 ### Iniciar el Servidor
 
@@ -989,7 +1152,7 @@ Verifica `initialize`, `tools/list`, `resources/list`, `prompts/list` y un `tool
 
 ### Herramientas MCP Disponibles
 
-El servidor incluido registra **27 herramientas**. El conjunto vigente y autoritativo siempre se puede explorar con `smart-cli api --list --category tools`; la tabla siguiente refleja el registro actual de `@evolith/mcp-server`.
+El servidor independiente registra **27 herramientas**. El conjunto vigente y autoritativo siempre se puede explorar con `smart-cli api --list --category tools`; la tabla siguiente refleja el registro actual de `@evolith/mcp-server`.
 
 **Validación y arquitectura**
 

package/README.md

@@ -56,7 +56,30 @@ Or download the binary from [GitHub Releases](https://github.com/beyondnetcode/e
 
 ```bash
 smart-cli --version
-# 1.1.4
+# 1.1.7
+```
+
+### Install Experience
+
+The npm package includes a short setup animation and welcome screen in `postinstall`. npm controls dependency download and extraction before package scripts run, and modern npm versions hide lifecycle script output unless foreground scripts are enabled. For the visible welcome experience:
+
+```bash
+npm install -g @evolith/smart-cli --foreground-scripts
+```
+
+To suppress the welcome message in automation:
+
+```bash
+EVOLITH_SMART_CLI_POSTINSTALL=0 npm install -g @evolith/smart-cli
+```
+
+### Uninstall
+
+Modern npm versions do not run package uninstall lifecycle hooks, so a package cannot reliably print an automatic farewell during `npm uninstall`. Use `goodbye` before removing the package when you want the closing message and cleanup hints:
+
+```bash
+smart-cli goodbye
+npm uninstall -g @evolith/smart-cli
 ```
 
 ### Troubleshooting
@@ -75,7 +98,7 @@ export PATH=$(npm config get prefix)/bin:$PATH
 
 ### Environment variables
 
-The CLI runs with zero configuration. The following variables are optional overrides. Those marked *(MCP)* are read by the bundled `@evolith/mcp-server` only while `smart-cli mcp serve` is running.
+The CLI runs with zero configuration. The following variables are optional overrides. Those marked *(MCP)* are read by the standalone `@evolith/mcp-server` only while `smart-cli mcp serve` is running.
 
 | Variable | Read by | Purpose |
 |---|---|---|
@@ -289,6 +312,40 @@ smart-cli validate --engine opa --ruleset acl
 
 ---
 
+### evaluate
+
+Runs the stateless Evolith evaluation engine from the CLI and prints an ADR-0073 envelope. Use it when automation needs the same canonical evaluation surface exposed by API integrations.
+
+```bash
+smart-cli evaluate [options]
+
+Options:
+  --context <path>       JSON file containing a canonical EvaluationContext
+  -w, --workspace <path> Local workspace path (default: active profile or cwd)
+  -c, --core <path>      Evolith Core checkout path
+  -p, --phase <id>       SDLC phase: discovery, design, construction, qa, release
+  -t, --topology <id>    Architecture topology override
+  -f, --format <format>  Output format: json or text (default: json)
+```
+
+**Examples:**
+
+```bash
+# Evaluate the current repository with default context
+smart-cli evaluate
+
+# Evaluate a specific workspace for a design gate
+smart-cli evaluate --workspace ../my-service --phase design
+
+# Evaluate a microservices topology override
+smart-cli evaluate --workspace ../my-service --topology microservices --format text
+
+# Use a prepared canonical EvaluationContext
+smart-cli evaluate --context ./evaluation-context.json --format json
+```
+
+---
+
 ### adr
 
 Manages Architecture Decision Records.
@@ -709,6 +766,71 @@ smart-cli profile delete --name staging
 
 ---
 
+### satellite:create
+
+Creates a new GitHub repository and registers it as an Evolith satellite. Requires `--token` or `GITHUB_TOKEN`.
+
+```bash
+smart-cli satellite:create [options]
+
+Options:
+  -n, --name <name>             New GitHub repository name
+  -o, --owner <owner>           GitHub user or organization
+      --topology <topology>     monolith, modular, micro, distributed
+      --phase <phase>           discovery, design, construction, qa, release
+      --private                 Create a private repository
+  -d, --description <text>      Repository description
+  -t, --token <token>           GitHub token (defaults to GITHUB_TOKEN)
+```
+
+**Examples:**
+
+```bash
+# Interactive creation
+smart-cli satellite:create
+
+# Create a private modular satellite in discovery
+GITHUB_TOKEN=$GITHUB_TOKEN smart-cli satellite:create \
+  --name orders-service \
+  --owner beyondnetcode \
+  --topology modular \
+  --phase discovery \
+  --private \
+  --description "Orders bounded context"
+```
+
+---
+
+### satellite:adopt
+
+Adopts an existing GitHub repository into Evolith governance without creating a new remote repository. Requires `--token` or `GITHUB_TOKEN` for GitHub API operations.
+
+```bash
+smart-cli satellite:adopt [options]
+
+Options:
+  --repo <url>              Existing GitHub repository URL
+  --owner <owner>           GitHub owner override
+  --topology <topology>     monolith, modular, micro, distributed, custom
+  --phase <phase>           alpha, beta, rc, ga
+  --token <token>           GitHub token (defaults to GITHUB_TOKEN)
+```
+
+**Examples:**
+
+```bash
+# Interactive adoption
+smart-cli satellite:adopt
+
+# Adopt an existing repository
+smart-cli satellite:adopt \
+  --repo https://github.com/beyondnetcode/ums \
+  --topology modular \
+  --phase beta
+```
+
+---
+
 ### fixtures
 
 Seeds reproducible fixture files for demos, tests, and onboarding. The first step recommended in any new environment.
@@ -903,6 +1025,47 @@ smart-cli history --clear
 
 ---
 
+### chat
+
+Sends a natural-language intent to the bundled Evolith Agent Runtime. The command is dry-run by default unless the runtime supports and receives an explicit override.
+
+```bash
+smart-cli chat <message> [options]
+
+Options:
+  --dry-run <boolean>   Keep execution in dry-run mode unless set to false
+```
+
+**Examples:**
+
+```bash
+# Ask for a governance-oriented interpretation
+smart-cli chat "review this repository for SDLC gate readiness"
+
+# Allow a runtime that supports execution to leave dry-run mode
+smart-cli chat "prepare a validation plan for the checkout" --dry-run false
+```
+
+---
+
+### goodbye
+
+Shows uninstall guidance, optional cleanup hints, and the closing message used before removing the CLI.
+
+```bash
+smart-cli goodbye
+```
+
+**Examples:**
+
+```bash
+# See the farewell and cleanup hints, then uninstall globally
+smart-cli goodbye
+npm uninstall -g @evolith/smart-cli
+```
+
+---
+
 ### completion
 
 Generates and installs shell completion scripts. Also provides shell hook functions for context and status display.
@@ -946,9 +1109,9 @@ Pre-built scripts are also included in the package under `shell/`:
 
 ## MCP Server
 
-The Evolith CLI bundles a production-ready MCP server for AI agent integration.
+The Evolith CLI can launch the standalone production-ready MCP server for AI agent integration.
 
-> **Deprecation notice:** `smart-cli mcp` prints a deprecation warning on startup and will be removed in a future major version. The MCP server now ships as a standalone package — migrate to `@evolith/mcp-server` (`npx @evolith/mcp-server serve` or the `evolith-mcp serve` binary). The CLI command continues to work in the meantime by lazily delegating to that package.
+> **Deprecation notice:** `smart-cli mcp` prints a deprecation warning on startup and will be removed in a future major version. The MCP server now ships as a standalone package — migrate to `@evolith/mcp-server` (`npx @evolith/mcp-server serve` or the `evolith-mcp serve` binary). The CLI command continues to work in the meantime by invoking that package on demand.
 
 ### Starting the Server
 
@@ -989,7 +1152,7 @@ Verifies `initialize`, `tools/list`, `resources/list`, `prompts/list`, and a rea
 
 ### Available MCP Tools
 
-The bundled server registers **27 tools**. The live, authoritative set is always browsable with `smart-cli api --list --category tools`; the table below mirrors the current `@evolith/mcp-server` registry.
+The standalone server registers **27 tools**. The live, authoritative set is always browsable with `smart-cli api --list --category tools`; the table below mirrors the current `@evolith/mcp-server` registry.
 
 **Validation & architecture**