Metadata-Version: 2.3
Name: zpx
Version: 0.3.1
Summary: CLI de ZPX Forge: conecta tu Claude Code o Codex con tu fábrica de software
Keywords: zpx,zpx-forge,ai-agents,claude-code,codex,cli
Author: Zynplex
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development
Requires-Dist: cvss>=3.4,<4
Requires-Dist: httpx>=0.28
Requires-Dist: packaging>=24
Requires-Dist: portalocker>=4.4.2,<5
Requires-Dist: prompt-toolkit>=3.0.43,<4
Requires-Dist: pyyaml>=6.0.2,<7
Requires-Dist: tomli>=2.5.0 ; python_full_version < '3.11'
Requires-Dist: tree-sitter>=0.26.1,<0.27
Requires-Dist: tree-sitter-javascript>=0.23,<0.26
Requires-Dist: tree-sitter-typescript>=0.23,<0.24
Requires-Python: >=3.10
Project-URL: Homepage, https://zpxforge.com
Project-URL: Documentation, https://zpxforge.com/docs
Description-Content-Type: text/markdown

# zpx

CLI de [ZPX Forge](https://zpxforge.com): conecta tu Claude Code o Codex con tu fábrica de software.

## Uso

```bash
uvx zpx health          # probar sin instalar nada
pipx install zpx        # instalarlo de forma permanente
uv tool install zpx     # o con uv
pip install zpx         # o con pip, dentro de un entorno virtual
```

```bash
zpx                     # panel interactivo con comandos /
zpx doctor              # credencial local, proyecto efectivo y siguiente paso
zpx doctor --json       # diagnóstico sin red para agentes y scripts
zpx help review         # buscar una acción en el idioma activo
zpx guide evidencia     # preparar la evidencia de una entrega
zpx login               # aprobar el código desde el navegador
zpx config language es  # español (en para volver al inglés)
zpx version             # versión del CLI
zpx health              # salud de la plataforma
zpx health --json       # en JSON
zpx health --url http://localhost:3000   # otra instancia
```

El CLI inicia en inglés. También puedes elegir el idioma en `/config` o durante `/setup`.

La URL por defecto es `https://www.zpxforge.com`; también se puede fijar con la variable `ZPX_URL`.

Documentación: https://zpxforge.com/docs

## Publicar en PyPI

Con la versión ya construida, ejecuta:

```bash
cd ~/zynplex/zpxforge/cli && uv publish dist/zpx-0.3.1-py3-none-any.whl dist/zpx-0.3.1.tar.gz
```

### Sincronizar el harness del proyecto

Desde el repositorio del cliente, ejecuta `zpx` y selecciona `/setup`. Al elegir el proyecto, el CLI descarga desde Forge la versión asignada de su plantilla, las políticas, la configuración del proyecto, los roles y las skills activas (incluidas las propias). Claude Code y Codex reciben sus definiciones en sus respectivas carpetas.

Después de cambiar la configuración en Forge, repite `/setup` o ejecuta `zpx skill install` en ese repositorio. El CLI actualiza y retira los archivos administrados según el registro de `.zpx/installed.json` y señala los conflictos con ediciones locales.

Forge identifica la configuración efectiva de cada proyecto por su contenido. El panel de skills muestra la revisión vigente. Al abrir el CLI en un repositorio vinculado, y al consultar `zpx context`, el CLI compara esa revisión con la última instalada. Claude y Codex reciben la instrucción de sincronizar al consultar el contexto. Para integraciones, `zpx context --json` expone `harness.revision` y `harness.sync.required`.

Desde 0.2.4, `zpx audit [RUTA] --json` examina los nombres del índice Git para localizar archivos de entorno versionados y workflows de GitHub Actions. Funciona sin iniciar sesión. `zpx guide hito` explica la aceptación y la entrega. `zpx guide agente` muestra, para el sitio configurado, la dirección de las [instrucciones completas para Claude o Codex](https://www.zpxforge.com/es/docs/instrucciones-agente).

Desde 0.3.0, en un repositorio de destino con un proyecto Pro seleccionado, usa `zpx audit` para auditar
el commit de HEAD y registrar el informe en el portal. Añade `--pdf informe.pdf` para guardar la misma versión en un archivo nuevo. Repite el comando tras corregir el código.
El PDF privado, la revisión de especificaciones y la autorización están en Proyecto → Auditoría de seguridad.

El comando de auditoría consulta tu suscripción y los permisos del proyecto automáticamente. Con Pro registra la revisión completa. Con Individual ejecuta el diagnóstico básico. Pedir PDF o lectura con IA sin acceso devuelve un error y explica cómo habilitarlo.
