Merge feature/export-import: add export/import commands (v1.6.4)

Author: SoftDryzz

README.md

@@ -185,6 +185,7 @@ pm run order-service
 - 🔤 **Shell autocompletion** - TAB completion for bash, zsh, fish, and PowerShell with `pm completions`
 - 🔐 **Security scan** - Detect misconfigurations (Dockerfile root, exposed secrets, insecure URLs) with `pm secure`, auto-fix with `--fix`
 - 🔍 **Dependency audit** - Scan dependencies for known vulnerabilities with `pm audit` using native tools (npm audit, cargo audit, govulncheck, pip-audit, dotnet)
+- 📤 **Export & Import** - Migrate setups between machines with `pm export` and `pm import`, supports selective export and path validation
 - 🌐 **Multi-platform** - Works on Windows, Linux, and Mac
 
 ---
@@ -251,6 +252,9 @@ chmod +x scripts/install.sh && ./scripts/install.sh
 | `pm secure` | Scan projects for security misconfigurations |
 | `pm secure --fix` | Auto-fix .gitignore issues (add .env, *.pem, *.key entries) |
 | `pm audit` | Audit dependencies for known vulnerabilities |
+| `pm export` | Export all projects to a portable JSON file |
+| `pm export <names...> [--file <path>]` | Export selected projects to a custom file |
+| `pm import <file>` | Import projects from an exported JSON file |
 | `pm help` | Show help |
 | `pm version` | Show version |
 
@@ -462,9 +466,10 @@ Projects are saved in:
 - **Integrations** — Git status, interactive TTY, multi-platform installers, GitHub Actions
 - **Security** — `pm secure` scans for misconfigurations, `--fix` auto-remediates .gitignore issues
 - **Audit** — `pm audit` checks dependencies for known vulnerabilities using native ecosystem tools
-- **Reliability** — Atomic writes, backup/recovery, directory validation, download integrity, 554 tests
+- **Portability** — `pm export` / `pm import` for migrating setups between machines or sharing team configs
+- **Reliability** — Atomic writes, backup/recovery, directory validation, download integrity, 582 tests
 
-> Latest release: **v1.6.3** (Dependency Audit) — Full version history in [ROADMAP.md](ROADMAP.md)
+> Latest release: **v1.6.4** (Export & Import) — Full version history in [ROADMAP.md](ROADMAP.md)
 
 ### 💡 Future Ideas
 - [ ] `pm run-all` / `pm build-all` - Execute commands across all projects

ROADMAP.md

@@ -243,13 +243,22 @@ Run custom scripts automatically before or after any command. Hooks are per-proj
 
 ---
 
-## v1.6.4 — Export & Import
+## v1.6.4 — Export & Import ✅
 
 ### `pm export` / `pm import` commands
-- `pm export` — export all registered projects to a portable JSON file
-- `pm import <file>` — import projects from an exported file
-- Useful for migrating between machines or sharing team setups
-- Validates paths on import and warns about missing directories
+Export all or selected projects to a portable JSON file and import them back on another machine.
+
+| Feature | Status |
+|---------|--------|
+| `pm export` — export all registered projects to JSON | ✅ Done |
+| `pm export name1 name2` — export specific projects | ✅ Done |
+| `pm export --file <path>` — custom output file (default: `pm-export.json`) | ✅ Done |
+| `pm import <file>` — import projects from an exported file | ✅ Done |
+| Self-describing JSON format with version metadata | ✅ Done |
+| Skip existing projects on import (never overwrite) | ✅ Done |
+| Warn about missing paths on import with `pm rename` hint | ✅ Done |
+| Invalid type defaults to UNKNOWN with warning | ✅ Done |
+| Shell autocompletion for export/import commands | ✅ Done |
 
 ---
 

User-Guide.md

@@ -18,6 +18,7 @@
   - [Diagnostics](#-diagnostics)
   - [Security Scan](#-security-scan)
   - [Dependency Audit](#-dependency-audit)
+  - [Export & Import](#-export--import)
   - [Help and Version](#-help-and-version)
 - [Environment Variables](#-environment-variables)
   - [What Are They?](#what-are-they)
@@ -769,6 +770,52 @@ Runs native ecosystem vulnerability tools on each registered project and display
 
 ---
 
+### 🔹 Export & Import
+
+Export your project configurations to a portable JSON file and import them on another machine.
+
+#### Export all projects
+```bash
+pm export
+```
+
+Saves all registered projects to `pm-export.json` in the current directory.
+
+#### Export selected projects
+```bash
+pm export backend-api web-server
+```
+
+#### Export to a custom file
+```bash
+pm export --file ~/backup/my-setup.json
+pm export backend-api --file team-config.json
+```
+
+#### Import projects
+```bash
+pm import pm-export.json
+pm import ~/backup/my-setup.json
+```
+
+**Behavior on import:**
+- Projects that already exist are **skipped** (never overwritten)
+- Projects with paths that don't exist on disk are imported with a **warning** — fix later with `pm rename <name> --path <new-path>`
+- Invalid project types default to `UNKNOWN`
+
+**Example output:**
+```
+Import
+──────
+
+  ✓ Imported 3 projects
+  ⚠ Skipped 'backend' — already exists
+  ⚠ 'api-server' path does not exist: /old/machine/path
+    Update with: pm rename api-server --path <new-path>
+```
+
+---
+
 ### 🔹 Help and Version
 
 #### View help
@@ -1723,6 +1770,12 @@ pm secure --fix                                # Auto-fix .gitignore issues
 # === AUDIT ===
 pm audit                                       # Audit dependencies for known vulnerabilities
 
+# === EXPORT & IMPORT ===
+pm export                                      # Export all projects to pm-export.json
+pm export backend web-server                   # Export selected projects
+pm export --file backup.json                   # Export to custom file
+pm import pm-export.json                       # Import projects from file
+
 # === UPDATES ===
 pm update                                      # Update to latest version
 

docs/es/README.md

@@ -185,6 +185,7 @@ pm run servicio-pedidos
 - 🔤 **Autocompletado en shell** - Completado con TAB para bash, zsh, fish y PowerShell con `pm completions`
 - 🔐 **Escaneo de seguridad** - Detecta misconfiguraciones (Dockerfile root, secretos expuestos, URLs inseguras) con `pm secure`, auto-corrige con `--fix`
 - 🔍 **Auditoría de dependencias** - Escanea dependencias en busca de vulnerabilidades conocidas con `pm audit` usando herramientas nativas (npm audit, cargo audit, govulncheck, pip-audit, dotnet)
+- 📤 **Exportar e Importar** - Migra configuraciones entre máquinas con `pm export` y `pm import`, soporta exportación selectiva y validación de rutas
 - 🌐 **Multi-plataforma** - Funciona en Windows, Linux y Mac
 
 ---
@@ -251,6 +252,9 @@ chmod +x scripts/install.sh && ./scripts/install.sh
 | `pm secure` | Escanear proyectos buscando misconfiguraciones de seguridad |
 | `pm secure --fix` | Auto-corregir problemas de .gitignore (añadir .env, *.pem, *.key) |
 | `pm audit` | Auditar dependencias en busca de vulnerabilidades conocidas |
+| `pm export` | Exportar todos los proyectos a un archivo JSON portátil |
+| `pm export <nombres...> [--file <ruta>]` | Exportar proyectos seleccionados a un archivo personalizado |
+| `pm import <archivo>` | Importar proyectos desde un archivo JSON exportado |
 | `pm help` | Mostrar ayuda |
 | `pm version` | Mostrar versión |
 
@@ -462,9 +466,10 @@ Los proyectos se guardan en:
 - **Integraciones** — Estado Git, TTY interactivo, instaladores multi-plataforma, GitHub Actions
 - **Seguridad** — `pm secure` escanea misconfiguraciones, `--fix` auto-corrige problemas de .gitignore
 - **Auditoría** — `pm audit` verifica dependencias en busca de vulnerabilidades usando herramientas nativas del ecosistema
-- **Fiabilidad** — Escritura atómica, backup/recuperación, validación de directorio, integridad de descarga, 554 tests
+- **Portabilidad** — `pm export` / `pm import` para migrar configuraciones entre máquinas o compartir setups de equipo
+- **Fiabilidad** — Escritura atómica, backup/recuperación, validación de directorio, integridad de descarga, 582 tests
 
-> Última release: **v1.6.3** (Auditoría de Dependencias) — Historial completo en [ROADMAP.md](ROADMAP.md)
+> Última release: **v1.6.4** (Exportar e Importar) — Historial completo en [ROADMAP.md](ROADMAP.md)
 
 ### 💡 Ideas Futuras
 - [ ] `pm run-all` / `pm build-all` - Ejecutar comandos en todos los proyectos

docs/es/ROADMAP.md

@@ -243,13 +243,22 @@ Ejecuta scripts personalizados automáticamente antes o después de cualquier co
 
 ---
 
-## v1.6.4 — Exportar e Importar
+## v1.6.4 — Exportar e Importar ✅
 
 ### Comandos `pm export` / `pm import`
-- `pm export` — exportar todos los proyectos registrados a un archivo JSON portable
-- `pm import <archivo>` — importar proyectos desde un archivo exportado
-- Útil para migrar entre máquinas o compartir configuraciones de equipo
-- Valida rutas al importar y avisa sobre directorios faltantes
+Exporta todos o proyectos seleccionados a un archivo JSON portable e impórtalos en otra máquina.
+
+| Característica | Estado |
+|----------------|--------|
+| `pm export` — exportar todos los proyectos registrados a JSON | ✅ Hecho |
+| `pm export nombre1 nombre2` — exportar proyectos específicos | ✅ Hecho |
+| `pm export --file <ruta>` — archivo de salida personalizado (por defecto: `pm-export.json`) | ✅ Hecho |
+| `pm import <archivo>` — importar proyectos desde un archivo exportado | ✅ Hecho |
+| Formato JSON auto-descriptivo con metadatos de versión | ✅ Hecho |
+| Omitir proyectos existentes al importar (nunca sobrescribe) | ✅ Hecho |
+| Avisar sobre rutas faltantes al importar con sugerencia `pm rename` | ✅ Hecho |
+| Tipo inválido por defecto a UNKNOWN con aviso | ✅ Hecho |
+| Autocompletado en shell para comandos export/import | ✅ Hecho |
 
 ---
 

docs/es/User-Guide.md

@@ -18,6 +18,7 @@
   - [Diagnósticos](#-diagnósticos)
   - [Escaneo de Seguridad](#-escaneo-de-seguridad)
   - [Auditoría de Dependencias](#-auditoría-de-dependencias)
+  - [Exportar e Importar](#-exportar-e-importar)
   - [Ayuda y Versión](#-ayuda-y-versión)
 - [Variables de Entorno](#-variables-de-entorno)
   - [¿Qué Son?](#qué-son)
@@ -769,6 +770,52 @@ Ejecuta herramientas nativas de auditoría de vulnerabilidades en cada proyecto
 
 ---
 
+### 🔹 Exportar e Importar
+
+Exporta las configuraciones de tus proyectos a un archivo JSON portable e impórtalos en otra máquina.
+
+#### Exportar todos los proyectos
+```bash
+pm export
+```
+
+Guarda todos los proyectos registrados en `pm-export.json` en el directorio actual.
+
+#### Exportar proyectos seleccionados
+```bash
+pm export backend-api web-server
+```
+
+#### Exportar a un archivo personalizado
+```bash
+pm export --file ~/backup/mi-setup.json
+pm export backend-api --file config-equipo.json
+```
+
+#### Importar proyectos
+```bash
+pm import pm-export.json
+pm import ~/backup/mi-setup.json
+```
+
+**Comportamiento al importar:**
+- Los proyectos que ya existen se **omiten** (nunca se sobreescriben)
+- Los proyectos cuyas rutas no existen en disco se importan con un **aviso** — corrige luego con `pm rename <nombre> --path <nueva-ruta>`
+- Los tipos de proyecto inválidos se establecen como `UNKNOWN`
+
+**Ejemplo de salida:**
+```
+Import
+──────
+
+  ✓ Imported 3 projects
+  ⚠ Skipped 'backend' — already exists
+  ⚠ 'api-server' path does not exist: /old/machine/path
+    Update with: pm rename api-server --path <new-path>
+```
+
+---
+
 ### 🔹 Ayuda y Versión
 
 #### Ver ayuda
@@ -1723,6 +1770,12 @@ pm secure --fix                                    # Auto-corregir problemas de
 # === AUDITORÍA ===
 pm audit                                           # Auditar dependencias en busca de vulnerabilidades
 
+# === EXPORTAR E IMPORTAR ===
+pm export                                          # Exportar todos los proyectos a pm-export.json
+pm export backend web-server                       # Exportar proyectos seleccionados
+pm export --file backup.json                       # Exportar a archivo personalizado
+pm import pm-export.json                           # Importar proyectos desde archivo
+
 # === ACTUALIZACIONES ===
 pm update                                          # Actualizar a última versión
 

pom.xml

@@ -8,7 +8,7 @@
     <!-- Identificación del proyecto -->
     <groupId>pm</groupId>
     <artifactId>projectmanager</artifactId>
-    <version>1.6.3</version>
+    <version>1.6.4</version>
     <packaging>jar</packaging>
 
     <name>ProjectManager</name>

scripts/install.ps1

@@ -1,7 +1,7 @@
 # ProjectManager - Installation Script for Windows
 # Works both from source (mvn clean package) and from GitHub Release download
 
-$jarName = "projectmanager-1.6.3.jar"
+$jarName = "projectmanager-1.6.4.jar"
 
 Write-Host "=== ProjectManager Installer ===" -ForegroundColor Cyan
 Write-Host ""

scripts/install.sh

@@ -2,7 +2,7 @@
 # ProjectManager - Installation Script for Linux/Mac
 # Works both from source (mvn clean package) and from GitHub Release download
 
-JAR_NAME="projectmanager-1.6.3.jar"
+JAR_NAME="projectmanager-1.6.4.jar"
 
 echo "=== ProjectManager Installer ==="
 echo ""