wasm-cli 0.15.8__tar.gz → 1.0.1__tar.gz

{wasm_cli-0.15.8 → wasm_cli-1.0.1}/MANIFEST.in

@@ -10,8 +10,8 @@ include pyproject.toml
 # Include source code (handled by setuptools, but explicit is better)
 recursive-include src *.py
 recursive-include src/wasm/templates *.j2
-recursive-include src/wasm/completions *
 recursive-include src/wasm/web/static *
+recursive-include src/wasm/web/templates *.html
 
 # Include documentation
 recursive-include docs *.md *.png *.jpg *.svg

{wasm_cli-0.15.8/src/wasm_cli.egg-info → wasm_cli-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wasm-cli
-Version: 0.15.8
+Version: 1.0.1
 Summary: Web App System Management - Deploy and manage web applications on Linux servers
 Author: Yago López Prado
 Author-email: Yago López Prado <yago.lopez.adeje@gmail.com>
@@ -20,45 +20,43 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: System :: Installation/Setup
 Classifier: Topic :: System :: Systems Administration
 Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: click>=8.0
 Requires-Dist: Jinja2>=3.1.0
 Requires-Dist: PyYAML>=6.0
-Provides-Extra: interactive
-Requires-Dist: inquirer>=3.1.0; extra == "interactive"
+Requires-Dist: questionary>=2.0
+Requires-Dist: rich>=13.0
 Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0; extra == "dev"
-Requires-Dist: black>=23.0; extra == "dev"
-Requires-Dist: isort>=5.12; extra == "dev"
-Requires-Dist: mypy>=1.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
-Provides-Extra: rich
-Requires-Dist: rich>=13.0; extra == "rich"
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.12; extra == "dev"
+Requires-Dist: syrupy>=4.6; extra == "dev"
+Requires-Dist: hypothesis>=6.100; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
 Provides-Extra: monitor
 Requires-Dist: psutil>=5.9.0; extra == "monitor"
 Requires-Dist: httpx>=0.25.0; extra == "monitor"
 Provides-Extra: web
 Requires-Dist: fastapi>=0.109.0; extra == "web"
+Requires-Dist: starlette>=0.36.0; extra == "web"
+Requires-Dist: pydantic>=2.0; extra == "web"
 Requires-Dist: uvicorn[standard]>=0.27.0; extra == "web"
-Requires-Dist: python-jose[cryptography]>=3.3.0; extra == "web"
-Requires-Dist: passlib[bcrypt]>=1.7.4; extra == "web"
 Requires-Dist: psutil>=5.9.0; extra == "web"
-Requires-Dist: aiofiles>=23.0.0; extra == "web"
 Provides-Extra: all
-Requires-Dist: inquirer>=3.1.0; extra == "all"
-Requires-Dist: rich>=13.0; extra == "all"
 Requires-Dist: psutil>=5.9.0; extra == "all"
 Requires-Dist: httpx>=0.25.0; extra == "all"
 Requires-Dist: fastapi>=0.109.0; extra == "all"
+Requires-Dist: starlette>=0.36.0; extra == "all"
+Requires-Dist: pydantic>=2.0; extra == "all"
 Requires-Dist: uvicorn[standard]>=0.27.0; extra == "all"
-Requires-Dist: python-jose[cryptography]>=3.3.0; extra == "all"
-Requires-Dist: passlib[bcrypt]>=1.7.4; extra == "all"
-Requires-Dist: aiofiles>=23.0.0; extra == "all"
 Dynamic: author
 Dynamic: license-file
 Dynamic: requires-python
@@ -104,8 +102,8 @@ WASM is a command-line tool for deploying and managing web applications on Linux
 - Create and control systemd services
 - Database management (MySQL, PostgreSQL, Redis, MongoDB)
 - Backup and rollback system
-- Web-based dashboard (optional)
-- Process monitoring and security scanning
+- Control panel (optional)
+- Resource and service observability
 
 ---
 
@@ -115,11 +113,11 @@ WASM is a command-line tool for deploying and managing web applications on Linux
 
 ```bash
 # Add GPG key
-curl -fsSL https://download.opensuse.org/repositories/home:/Perkybeet/xUbuntu_24.04/Release.key | \
+curl -fsSL https://download.opensuse.org/repositories/home:/Perkybeet/xUbuntu_26.04/Release.key | \
   gpg --dearmor | sudo tee /usr/share/keyrings/wasm.gpg > /dev/null
 
 # Add repository
-echo 'deb [signed-by=/usr/share/keyrings/wasm.gpg] https://download.opensuse.org/repositories/home:/Perkybeet/xUbuntu_24.04/ /' | \
+echo 'deb [signed-by=/usr/share/keyrings/wasm.gpg] https://download.opensuse.org/repositories/home:/Perkybeet/xUbuntu_26.04/ /' | \
   sudo tee /etc/apt/sources.list.d/wasm.list
 
 # Install
@@ -128,15 +126,16 @@ sudo apt install wasm
 ```
 
 **Supported versions:**
-- Ubuntu 22.04 LTS (Jammy Jellyfish)
+- Ubuntu 26.04 LTS (Resolute Raccoon, Python 3.14)
 - Ubuntu 24.04 LTS (Noble Numbat)
-- Debian 12 (Bookworm)
+- Ubuntu 22.04 LTS (Jammy Jellyfish)
+- Debian 12 (Bookworm) and 13 (Trixie)
 
 ### Fedora
 
 ```bash
 sudo dnf config-manager --add-repo \
-  https://download.opensuse.org/repositories/home:/Perkybeet/Fedora_40/home:Perkybeet.repo
+  https://download.opensuse.org/repositories/home:/Perkybeet/Fedora_42/home:Perkybeet.repo
 sudo dnf install wasm-cli
 ```
 
@@ -479,9 +478,11 @@ wasm rollback <domain> [id]     Quick rollback
 
 ---
 
-## Web Dashboard
+## Control Panel
 
-WASM includes an optional web-based dashboard for remote management.
+An optional panel for the machine WASM runs on. It is server-rendered HTML updated by
+htmx, with no build step, no Node and no third-party CDN, so it works on a server with no
+route to the internet.
 
 ### Installation
 
@@ -489,31 +490,47 @@ WASM includes an optional web-based dashboard for remote management.
 pip install wasm-cli[web]
 ```
 
-### Start Dashboard
+### Start it
 
 ```bash
-wasm web start --host 0.0.0.0 --port 8080
+# Localhost only. This is the default and the safe one.
+wasm web start
+
+# Reachable from the network. TLS is required, because the panel's token is
+# root on this machine.
+wasm web start --host 0.0.0.0 --require-https --tls-cert cert.pem --tls-key key.pem
+
+# Behind a TLS-terminating reverse proxy: declare it, so the panel trusts its
+# forwarded headers and marks the session cookie Secure.
+wasm web start --trusted-proxy 127.0.0.1
 ```
 
-### Features
+Print the access token with `wasm web token`.
+
+### What it does
 
-- Application deployment and management
-- Real-time logs and monitoring
-- SSL certificate management
-- Service control
-- Backup creation and restoration
-- Database management
-- REST API with token authentication
+- Overview of the machine: load, memory, disk and the state of every managed service
+- Applications, services, sites and databases, with their live state
+- Live logs streamed from journald into a docked terminal
+- A JSON API under `/api` for automation, authenticated with the same token
 
-Access the dashboard at `http://your-server:8080`
+Sessions use an HttpOnly cookie with CSRF protection; the API also accepts
+`Authorization: Bearer` for scripts. Every privileged action is written to an append-only
+audit log.
+
+### Not yet in the panel
+
+Certificate issuance, backup and restore, scheduled jobs and settings currently have API
+endpoints but no screen. Use the CLI for those.
 
 ---
 
 ## System Requirements
 
-- **Operating System**: Ubuntu 20.04+, Debian 11+, Fedora 38+, openSUSE Leap 15.5+
-- **Python**: 3.10 or higher
-- **Privileges**: sudo access for service management
+- **Operating System**: Ubuntu 22.04+, Debian 12+, Fedora 40+, openSUSE Leap 15.6+
+- **Python**: 3.10 to 3.14
+- **Privileges**: root. WASM writes to /etc, /var and systemd, so it checks for
+  root on the commands that touch the system rather than escalating per call.
 
 ### Optional Dependencies
 
@@ -532,18 +549,19 @@ WASM will check for missing dependencies and prompt installation when needed.
 
 ```
 /var/www/apps/
-├── wasm-example-com/
-│   ├── current/              # Active deployment
-│   ├── releases/             # Previous releases (for rollback)
-│   │   ├── 20260114120000/
-│   │   └── 20260113150000/
-│   ├── shared/               # Persistent files (uploads, logs)
-│   └── .env                  # Environment variables
-│
-└── wasm-another-app/
+├── example-com/              # The application, deployed in place
+│   └── .env                  # Environment variables, mode 0600
+└── another-app/
     └── ...
+
+/var/lib/wasm/wasm.db         # What WASM knows about this machine, mode 0600
+/etc/wasm/config.yaml         # Configuration, mode 0600 in a 0700 directory
+/var/backups/wasm/            # Backup archives, each self-contained
 ```
 
+Rolling back restores from a backup rather than switching a symlink between releases; see
+`wasm backup list` and `wasm rollback`.
+
 ---
 
 ## Development

{wasm_cli-0.15.8 → wasm_cli-1.0.1}/README.md

@@ -39,8 +39,8 @@ WASM is a command-line tool for deploying and managing web applications on Linux
 - Create and control systemd services
 - Database management (MySQL, PostgreSQL, Redis, MongoDB)
 - Backup and rollback system
-- Web-based dashboard (optional)
-- Process monitoring and security scanning
+- Control panel (optional)
+- Resource and service observability
 
 ---
 
@@ -50,11 +50,11 @@ WASM is a command-line tool for deploying and managing web applications on Linux
 
 ```bash
 # Add GPG key
-curl -fsSL https://download.opensuse.org/repositories/home:/Perkybeet/xUbuntu_24.04/Release.key | \
+curl -fsSL https://download.opensuse.org/repositories/home:/Perkybeet/xUbuntu_26.04/Release.key | \
   gpg --dearmor | sudo tee /usr/share/keyrings/wasm.gpg > /dev/null
 
 # Add repository
-echo 'deb [signed-by=/usr/share/keyrings/wasm.gpg] https://download.opensuse.org/repositories/home:/Perkybeet/xUbuntu_24.04/ /' | \
+echo 'deb [signed-by=/usr/share/keyrings/wasm.gpg] https://download.opensuse.org/repositories/home:/Perkybeet/xUbuntu_26.04/ /' | \
   sudo tee /etc/apt/sources.list.d/wasm.list
 
 # Install
@@ -63,15 +63,16 @@ sudo apt install wasm
 ```
 
 **Supported versions:**
-- Ubuntu 22.04 LTS (Jammy Jellyfish)
+- Ubuntu 26.04 LTS (Resolute Raccoon, Python 3.14)
 - Ubuntu 24.04 LTS (Noble Numbat)
-- Debian 12 (Bookworm)
+- Ubuntu 22.04 LTS (Jammy Jellyfish)
+- Debian 12 (Bookworm) and 13 (Trixie)
 
 ### Fedora
 
 ```bash
 sudo dnf config-manager --add-repo \
-  https://download.opensuse.org/repositories/home:/Perkybeet/Fedora_40/home:Perkybeet.repo
+  https://download.opensuse.org/repositories/home:/Perkybeet/Fedora_42/home:Perkybeet.repo
 sudo dnf install wasm-cli
 ```
 
@@ -414,9 +415,11 @@ wasm rollback <domain> [id]     Quick rollback
 
 ---
 
-## Web Dashboard
+## Control Panel
 
-WASM includes an optional web-based dashboard for remote management.
+An optional panel for the machine WASM runs on. It is server-rendered HTML updated by
+htmx, with no build step, no Node and no third-party CDN, so it works on a server with no
+route to the internet.
 
 ### Installation
 
@@ -424,31 +427,47 @@ WASM includes an optional web-based dashboard for remote management.
 pip install wasm-cli[web]
 ```
 
-### Start Dashboard
+### Start it
 
 ```bash
-wasm web start --host 0.0.0.0 --port 8080
+# Localhost only. This is the default and the safe one.
+wasm web start
+
+# Reachable from the network. TLS is required, because the panel's token is
+# root on this machine.
+wasm web start --host 0.0.0.0 --require-https --tls-cert cert.pem --tls-key key.pem
+
+# Behind a TLS-terminating reverse proxy: declare it, so the panel trusts its
+# forwarded headers and marks the session cookie Secure.
+wasm web start --trusted-proxy 127.0.0.1
 ```
 
-### Features
+Print the access token with `wasm web token`.
+
+### What it does
 
-- Application deployment and management
-- Real-time logs and monitoring
-- SSL certificate management
-- Service control
-- Backup creation and restoration
-- Database management
-- REST API with token authentication
+- Overview of the machine: load, memory, disk and the state of every managed service
+- Applications, services, sites and databases, with their live state
+- Live logs streamed from journald into a docked terminal
+- A JSON API under `/api` for automation, authenticated with the same token
 
-Access the dashboard at `http://your-server:8080`
+Sessions use an HttpOnly cookie with CSRF protection; the API also accepts
+`Authorization: Bearer` for scripts. Every privileged action is written to an append-only
+audit log.
+
+### Not yet in the panel
+
+Certificate issuance, backup and restore, scheduled jobs and settings currently have API
+endpoints but no screen. Use the CLI for those.
 
 ---
 
 ## System Requirements
 
-- **Operating System**: Ubuntu 20.04+, Debian 11+, Fedora 38+, openSUSE Leap 15.5+
-- **Python**: 3.10 or higher
-- **Privileges**: sudo access for service management
+- **Operating System**: Ubuntu 22.04+, Debian 12+, Fedora 40+, openSUSE Leap 15.6+
+- **Python**: 3.10 to 3.14
+- **Privileges**: root. WASM writes to /etc, /var and systemd, so it checks for
+  root on the commands that touch the system rather than escalating per call.
 
 ### Optional Dependencies
 
@@ -467,18 +486,19 @@ WASM will check for missing dependencies and prompt installation when needed.
 
 ```
 /var/www/apps/
-├── wasm-example-com/
-│   ├── current/              # Active deployment
-│   ├── releases/             # Previous releases (for rollback)
-│   │   ├── 20260114120000/
-│   │   └── 20260113150000/
-│   ├── shared/               # Persistent files (uploads, logs)
-│   └── .env                  # Environment variables
-│
-└── wasm-another-app/
+├── example-com/              # The application, deployed in place
+│   └── .env                  # Environment variables, mode 0600
+└── another-app/
     └── ...
+
+/var/lib/wasm/wasm.db         # What WASM knows about this machine, mode 0600
+/etc/wasm/config.yaml         # Configuration, mode 0600 in a 0700 directory
+/var/backups/wasm/            # Backup archives, each self-contained
 ```
 
+Rolling back restores from a backup rather than switching a symlink between releases; see
+`wasm backup list` and `wasm rollback`.
+
 ---
 
 ## Development

wasm_cli-1.0.1/docs/superpowers/specs/2026-08-12-wasm-panel-design-direction.md

@@ -0,0 +1,133 @@
+# Panel WASM - Dirección de diseño
+
+Fecha: 2026-08-12
+Aplica a: `src/wasm/web/` (backend de vistas y assets)
+
+## El sujeto
+
+Quien usa este panel administra su propio servidor Linux. Eligió no usar Vercel. Está
+cómodo en una terminal y abre el panel porque quiere ver el estado de la máquina de un
+vistazo, no porque quiera que le escondan la máquina.
+
+El trabajo de la interfaz es uno solo: **enseñar el estado real de esta máquina y dejar
+actuar sobre él sin tener que abrir una sesión SSH.**
+
+De ahí sale todo lo demás. El material del sujeto son units de systemd, bloques de nginx,
+logs de journald, fechas de caducidad de certificados, números de puerto, códigos de salida.
+Su vernáculo es la salida de `systemctl status`. La interfaz se construye con ese material,
+no a pesar de él.
+
+## Lo que este panel NO es
+
+No es una consola de nube. Imitar la estética SaaS neutra de Vercel sería a la vez el camino
+más trillado y una mentira sobre lo que es el producto: aquí solo hay una máquina, es tuya, y
+si la rompes se rompe.
+
+Tampoco es una terminal nostálgica. Verde sobre negro es un disfraz, no un diseño.
+
+## Tokens
+
+### Color: el color solo significa estado
+
+La regla que sostiene la identidad: **ningún elemento lleva color si no codifica estado.**
+La navegación, las cabeceras, las tarjetas, los bordes y el texto son acromáticos. Si ves
+color en la pantalla, es información: algo está corriendo, algo ha fallado, algo caduca
+pronto.
+
+Eso hace la pantalla escaneable y es exactamente lo contrario de un dashboard con degradados
+decorativos.
+
+| Rol | Claro | Oscuro | Significa |
+|---|---|---|---|
+| Fondo | `#FBFAF8` | `#12161A` | |
+| Superficie | `#FFFFFF` | `#191E24` | |
+| Borde | `#E4E1DC` | `#262D35` | |
+| Texto | `#1A1D21` | `#E8EAED` | |
+| Texto tenue | `#6B7178` | `#8A929B` | |
+| Activo | `#1F7A4D` | `#3FA96E` | unidad corriendo, certificado válido |
+| Detenido | `#6B7178` | `#8A929B` | parado a propósito, no es un problema |
+| Fallo | `#B3261E` | `#E5534B` | unidad caída, despliegue fallido |
+| En curso | `#9A6700` | `#D4A017` | desplegando, renovando, caduca pronto |
+
+El modo claro es el que fija la identidad: un técnico denso, tipo hoja de datos, poco
+frecuente en esta categoría. El oscuro es igual de completo, porque a las tres de la mañana
+es el que se usa.
+
+### Tipografía: IBM Plex, tres voces
+
+Una sola familia, tres cortes, todos OFL y vendorizables en cinco ficheros woff2.
+
+- **IBM Plex Sans** para interfaz y prosa.
+- **IBM Plex Sans Condensed** para cabeceras de tabla, etiquetas y ejes. El corte condensado
+  es la decisión distintiva: da densidad real y un aire de hoja de datos técnica que una
+  grotesca neutra no consigue.
+- **IBM Plex Mono** para todo valor que sea del sistema: rutas, nombres de unit, puertos,
+  códigos de salida, marcas de tiempo, logs.
+
+Plex no es a lo que se recurre por defecto en herramientas de desarrollo, que es Inter o
+Geist. Tiene forma propia: terminaciones planas, `a` y `g` reconocibles, y fue diseñada
+precisamente como tipografía de sistema para trabajo técnico.
+
+**Cifras tabulares en todo valor que cambie.** Las columnas no bailan cuando se actualiza un
+número. Es un detalle de instrumento que casi ningún panel acierta.
+
+### Estructura: el raíl de estado
+
+Los recursos no son tarjetas flotando. Son filas de una tabla densa, y cada fila lleva un
+raíl vertical de 3px a la izquierda cuyo color es su estado.
+
+Recorrer el borde izquierdo con la vista cuenta la salud de todo sin leer una palabra. El
+mismo lenguaje sirve para aplicaciones, servicios, sitios, certificados y backups, así que se
+aprende una vez.
+
+Los marcadores numerados (01 / 02 / 03) no se usan: aquí nada es una secuencia. Lo único que
+lleva numeración es el pipeline de despliegue, porque ahí el orden sí es información.
+
+### El elemento firma: la banda de máquina
+
+Una franja persistente en la parte superior, visible en todas las páginas, con el estado real
+de esta máquina: hostname, uptime, carga con un sparkline en línea, memoria y disco como
+barras finas de capacidad, y el recuento de units por estado. Todo en mono, cifras tabulares,
+actualizándose por SSE.
+
+No son tarjetas de estadística. Es una línea de estado de instrumento, como la de un equipo
+de laboratorio. Y es lo que hace que se sienta una sala de control de una máquina concreta en
+vez de un CRUD genérico. También es honesto: siempre sabes qué máquina estás a punto de
+tocar.
+
+### El riesgo: el cajón de logs anclado
+
+Los logs viven en un cajón anclado abajo, persistente entre navegaciones, con streaming de
+journald por WebSocket sobre xterm.js. Como el terminal integrado de un editor.
+
+Cuesta espacio vertical, y esa es la apuesta. Se justifica porque el momento en que más
+falta hacen los logs es en mitad de un despliegue, y porque esconderlos detrás de un clic por
+recurso es justo lo que hace que un panel web se sienta peor que una sesión SSH.
+
+## Movimiento
+
+Casi ninguno. Esto es un instrumento.
+
+1. Un pulso breve en el raíl cuando una unidad cambia de estado, porque un cambio de estado
+   es el evento más importante que puede ocurrir.
+2. El deslizamiento del cajón de logs.
+3. Esqueleto a contenido.
+
+`prefers-reduced-motion` se respeta en los tres.
+
+## Texto
+
+- Nombrar por lo que la persona controla: "Reiniciar", no "Enviar".
+- La acción conserva su nombre en todo el flujo: el botón "Publicar" produce el aviso
+  "Publicado".
+- **Un error del sistema no se parafrasea nunca.** Se muestra literal, en mono, y encima se
+  pone qué hacer. Este público quiere el mensaje real de nginx o de systemd, no una versión
+  amable.
+- Los vacíos son una invitación: "Todavía no hay aplicaciones. Despliega una desde aquí o con
+  `wasm deploy`."
+
+## Suelo de calidad
+
+Responsive hasta móvil, foco de teclado visible, contraste AA como mínimo en texto y en los
+colores de estado sobre su fondo, movimiento reducido respetado, y funcionamiento completo
+sin conexión a internet: todos los assets vendorizados, cero CDN.