docs: remove Ubuntu references from root docs and copilot

Author: fas-adhoc

.github/copilot-instructions.md

@@ -2,7 +2,7 @@
 
 ## Project Overview
 
-This is an Ansible-based laptop provisioning system for Adhoc, designed for clean Debian 12+ and Ubuntu 22.04+ installations. It automates complete workstation setup through hierarchical profile-based roles.
+This is an Ansible-based laptop provisioning system for Adhoc, designed for clean Debian 13 installations. It automates complete workstation setup through hierarchical profile-based roles.
 
 ## Architecture: Hierarchical Role System
 
@@ -89,7 +89,7 @@ ansible-playbook local.yml --tags "deploy" -K --verbose
 
 ### Variable patterns
 - **User detection**: `remote_regular_user: "{{ ansible_env.SUDO_USER | default(ansible_user) }}"` - critical for running tasks as the actual user when using `sudo`
-- **Distribution-specific logic**: Use `ansible_facts['distribution']` and `ansible_facts['distribution_version']` for Debian vs Ubuntu differences
+- **Distribution version logic**: Use `ansible_facts['distribution_version']` for Debian version-specific behavior
 - **Package exclusions**: `packages_exclude_debian_13` pattern for distro-specific package availability
 - Variables prefixed with role name: `developer_*`, `funcional_*`, `sysadmin_*`
 
@@ -139,7 +139,7 @@ Use "check-then-install" pattern (see `roles/developer/tasks/code.yml`):
 ## Testing Strategy (Progressive Approach)
 
 ### Current state
-Manual testing in VirtualBox VMs with clean Debian/Ubuntu installations.
+Manual testing in VirtualBox VMs with clean Debian 13 installations.
 
 ### Planned automated testing with Molecule
 **Goal**: Systematize testing to avoid exclusive reliance on manual VirtualBox testing.
@@ -148,7 +148,7 @@ Manual testing in VirtualBox VMs with clean Debian/Ubuntu installations.
 1. **Phase 1 - Basic Molecule setup**:
    - Install Molecule: `pip install molecule molecule-plugins[docker]`
    - Create initial scenario for `funcional` role: `molecule init scenario -r funcional`
-   - Configure `molecule/default/molecule.yml` with Debian 12 and Ubuntu 22.04 containers
+   - Configure `molecule/default/molecule.yml` with Debian 13 containers
    - Write basic verification tests in `molecule/default/verify.yml` (check key packages installed)
 
 2. **Phase 2 - Expand coverage**:
@@ -158,7 +158,7 @@ Manual testing in VirtualBox VMs with clean Debian/Ubuntu installations.
      - Service states (Docker, SSH)
      - File/directory presence and permissions
      - User configurations (Git, VS Code extensions)
-   - Test distribution-specific logic (Debian vs Ubuntu differences)
+   - Test Debian version-specific behavior
 
 3. **Phase 3 - CI/CD integration**:
    - Set up GitHub Actions workflow (`.github/workflows/molecule.yml`)

QUICKSTART_TESTING.md

@@ -20,7 +20,7 @@ source .venv/bin/activate
 ### 3. Ejecutar tu primer test
 
 ```bash
-# Test del rol funcional en Debian 12 y Ubuntu 22.04
+# Test del rol funcional en Debian 13
 ./test-role.sh funcional
 ```
 

README.md

@@ -3,7 +3,7 @@
 ![Molecule CI](https://github.com/ingadhoc/ansible_notebooks/workflows/Molecule%20CI/badge.svg?branch=main)
 ![License](https://img.shields.io/badge/license-MIT-blue.svg)
 ![Ansible](https://img.shields.io/badge/ansible-%3E%3D2.15-blue.svg)
-![Platforms](https://img.shields.io/badge/platforms-Debian%2012%2B%20%7C%20Ubuntu%2022.04%2B-blue.svg)
+![Platforms](https://img.shields.io/badge/platforms-Debian%2013-blue.svg)
 
 ## 🎯 Resumen Ejecutivo
 
@@ -15,11 +15,11 @@ Para información interna más detallada sobre los objetivos, procedimientos y p
 
 ---
 
-## Filosofía y Distribuciones Soportadas
+## Filosofía y Distribución Soportada
 
-Este playbook está diseñado para funcionar sobre instalaciones limpias de **Debian (12+)** y **Ubuntu (22.04+)**.
+Este playbook está diseñado para funcionar sobre instalaciones limpias de **Debian 13 (Trixie)**.
 
-Priorizamos el uso de Debian para mantener un sistema base limpio, estable y libre de las decisiones comerciales de Canonical (como la imposición de `snap`). Sin embargo, el playbook es totalmente compatible con las versiones LTS de Ubuntu.
+Priorizamos el uso de Debian para mantener un sistema base limpio, estable y libre de las decisiones comerciales de Canonical (como la imposición de `snap`).
 
 > ⚠️ **Entorno de escritorio requerido: GNOME**
 > Los perfiles `funcional`, `developer` y `sysadmin` configuran extensiones, ajustes visuales y comportamientos específicos de **GNOME**. El playbook asume que GNOME está instalado y activo como entorno de escritorio. Instalar sobre KDE u otro entorno producirá errores en las tareas de configuración de escritorio.
@@ -234,7 +234,7 @@ Este proyecto utiliza **Molecule** con Docker para tests automatizados. Los test
 ### Ejecutar tests localmente
 
 ```bash
-# Crear un entorno virtual (recomendado, evita PEP 668 en Debian/Ubuntu)
+# Crear un entorno virtual (recomendado, evita PEP 668 en Debian)
 python3 -m venv .venv
 source .venv/bin/activate
 
@@ -257,15 +257,13 @@ ansible-galaxy install -r collections/requirements.yml
 ./test-role.sh --lint
 ```
 
-### Testing con múltiples distribuciones
+### Distribución soportada
 
-Por defecto, los tests ejecutan en **Debian 13** y **Ubuntu 24.04**. Para probar con distribuciones adicionales:
+Los tests ejecutan en **Debian 13 (Trixie)**.
 
 ```bash
-# Usar el Makefile para comandos específicos
-make test-ubuntu2404      # Test solo Ubuntu 24.04 LTS
-make test-debian13        # Test solo Debian 13 (si disponible)
-make test-all-distros     # Test todas las distros configuradas
+# Test solo Debian 13
+make test-debian13
 
 # Ver plataformas disponibles
 make list-platforms
@@ -274,20 +272,11 @@ make list-platforms
 make docker-pull-images
 ```
 
-**Distribuciones soportadas:**
-- ✅ **Debian 13 (Trixie)** - Producción, por defecto
-- ✅ **Ubuntu 24.04 LTS (Noble)** - Producción, por defecto
-- ✅ **Debian 12 (Bookworm)** - Producción, soportado (legacy)
-- ✅ **Ubuntu 22.04 LTS (Jammy)** - Producción, soportado (legacy)
-
-Para agregar más distribuciones a tus tests, consulta:
-- [docs/MOLECULE_GUIDE.md](docs/MOLECULE_GUIDE.md) - Sección "Testing con Múltiples Distribuciones"
-- [docs/MULTI_DISTRO_TESTING.md](docs/MULTI_DISTRO_TESTING.md) - Guía completa multi-distro
-- [docs/molecule-multi-distro-example.yml](docs/molecule-multi-distro-example.yml) - Configuración de ejemplo
+Para más información sobre testing, consulta:
+- [docs/TESTING.md](docs/TESTING.md) - Guía completa de testing con Molecule
+- [docs/MOLECULE_GUIDE.md](docs/MOLECULE_GUIDE.md) - Guía detallada de Molecule
 - [roles/funcional/README.md](roles/funcional/README.md) - Testing específico del rol
 
-Para más información sobre testing, consulta [docs/TESTING.md](docs/TESTING.md).
-
 ---
 
 ## 🔧 Troubleshooting

TESTING.md

@@ -66,7 +66,7 @@ molecule test --scenario-name default
 
 ### Distribución de Test
 
-Los escenarios de Molecule testean Debian 13. Ubuntu ya no forma parte del CI.
+Los escenarios de Molecule testean Debian 13 (Trixie).
 
 ## Estructura de Tests
 

docs/debian-only-cleanup.md

@@ -9,6 +9,31 @@ o se elimina la condición si solo queda Debian.
 
 ---
 
+## 📊 Estado actual
+
+**Completado** (commit `bd34ddf` + posteriores):
+- ✅ Grupos 1-5, 7, 8 — código activo de los roles `funcional` y `developer`
+- ✅ Grupo 9 — Molecule converge.yml en 3 roles
+- ✅ Grupo 12 — copilot-instructions.md
+- ✅ Grupo 13 — Docs raíz (README, specifications, TESTING, QUICKSTART, funcional/README)
+- ✅ **Bonus:** fix del callback `community.general.yaml` (removido en 12.0.0) en los 4 molecule.yml
+- ✅ Test `make test-funcional` pasa verde
+
+**Pendiente:**
+- ⏳ Grupo 10 — `Makefile` (sacar targets `test-ubuntu*`, limpiar `docker-pull-images`)
+- ⏳ Grupo 11 — `.github/workflows/molecule.yml` (sacar matriz Ubuntu del CI)
+- ⏳ Grupo 14 — Docs en `docs/`:
+  - Borrar 2 obsoletos (`MULTI_DISTRO_TESTING.md`, `molecule-multi-distro-example.yml`)
+  - Editar 5 activos (`MOLECULE_GUIDE.md`, `TESTING.md`, `FREELANCE_DEVELOPER.md`, `PROFILES.md`, `TEST_RUN_NOTES.md`)
+- ⏳ Grupo 6 — `local_dns.yml` (decisión pendiente, dejado a propósito por ahora)
+- ⏳ Validación CI: `make test-developer` y `make test-sysadmin`
+- ⏳ **Validación end-to-end en PC física o VM con Debian 13 limpio**
+  - Molecule (Docker) NO testea GNOME, dconf, branding visual, sessions Xorg, GDM, ni componentes con GUI
+  - Es la única forma de validar que el playbook completo funciona en una instalación real
+  - Probar los 3 perfiles: `funcional`, `developer`, `sysadmin`
+
+---
+
 ## GRUPO 1 — `roles/funcional/vars.yml`
 **Tipo:** Borrado puro de variables muertas. Sin riesgo, nada las referencia en Debian.
 
@@ -117,49 +142,72 @@ when: ansible_facts['distribution'] == 'Ubuntu'   ← bloque entero saltea en De
 ## GRUPO 12 — `.github/copilot-instructions.md`
 **Tipo:** Actualizar instrucciones para Copilot para reflejar solo-Debian.
 
-- [ ] Quitar menciones a Ubuntu en las descripciones del proyecto
-- [ ] Actualizar ejemplos que comparen Debian vs Ubuntu
-- [ ] Sacar lógica específica de versiones Ubuntu (22.04, 24.04)
+- [x] Quitar mención "Debian 12+ and Ubuntu 22.04+" → "Debian 13"
+- [x] Reescribir "Debian vs Ubuntu differences" → "Debian version-specific behavior"
+- [x] "Manual testing in VirtualBox VMs with Debian/Ubuntu" → "with Debian 13"
+- [x] "Debian 12 and Ubuntu 22.04 containers" → "Debian 13 containers"
+- [x] "Test distribution-specific logic (Debian vs Ubuntu differences)" → "Test Debian version-specific behavior"
 
 ---
 
 ## GRUPO 13 — Documentación raíz
 **Tipo:** Actualizar docs para usuarios, sacar Ubuntu como distro soportada.
 
-- [ ] `README.md` — quitar badges, secciones y referencias a Ubuntu (8 refs)
-- [ ] `specifications.md` — actualizar compatibilidad y versiones soportadas (3 refs)
-- [ ] `TESTING.md` — actualizar matriz de testing (1 ref)
-- [ ] `QUICKSTART_TESTING.md` — actualizar guía rápida (1 ref)
-- [ ] `roles/funcional/README.md` — limpiar README del rol (11 refs)
+- [x] `README.md` — badge actualizado a "Debian 13", sección "Filosofía" reescrita, secciones de testing multi-distro eliminadas
+- [x] `specifications.md` — "Debian-First" → "Debian-Only", plataformas simplificadas
+- [x] `TESTING.md` — eliminada la mención a Ubuntu, "Debian 13 (Trixie)" como única distro
+- [x] `QUICKSTART_TESTING.md` — comando ejemplo actualizado a "Debian 13"
+- [x] `roles/funcional/README.md` — requisitos simplificados, sección "Testing con distribuciones adicionales" eliminada (~80 líneas Ubuntu-específicas)
 
 ---
 
 ## GRUPO 14 — Documentación en `docs/`
-**Tipo:** Limpiar/decidir qué hacer con docs que mencionan Ubuntu.
+**Tipo:** Limpiar/borrar docs según relevancia.
+
+### Para borrar (obsoletos)
+- [ ] `docs/MULTI_DISTRO_TESTING.md` (16 refs) — guía completa multi-distro, ya no aplica
+- [ ] `docs/molecule-multi-distro-example.yml` (16 refs) — ejemplo YAML multi-distro
+
+### Para editar (docs activos)
+- [ ] `docs/MOLECULE_GUIDE.md` (26 refs) — guía de Molecule
+- [ ] `docs/TESTING.md` (4 refs)
+- [ ] `docs/FREELANCE_DEVELOPER.md` (2 refs)
+- [ ] `docs/PROFILES.md` (1 ref)
+- [ ] `docs/TEST_RUN_NOTES.md` (1 ref)
 
-Archivos afectados:
-- `docs/MOLECULE_GUIDE.md`
-- `docs/MULTI_DISTRO_TESTING.md` — ¿se borra entero? ya no es multi-distro
-- `docs/PROFILES.md`
-- `docs/LESSONS_LEARNED.md`
-- `docs/MEJORAS_ROL_FUNCIONAL.md`
-- `docs/CHANGELOG_MEJORAS_FUNCIONAL.md`
-- `docs/FREELANCE_DEVELOPER.md`
-- `docs/TESTING.md`
-- `docs/TEST_RUN_NOTES.md`
-- `docs/TESTING_IMPLEMENTATION_SUMMARY.md`
-- `docs/molecule-multi-distro-example.yml` — ¿borrar? es ejemplo multi-distro
+### Dejar como historia (NO tocar — historial del proyecto)
+- `docs/CHANGELOG_MEJORAS_FUNCIONAL.md` (5 refs)
+- `docs/MEJORAS_ROL_FUNCIONAL.md` (5 refs)
+- `docs/TESTING_IMPLEMENTATION_SUMMARY.md` (3 refs)
+- `docs/LESSONS_LEARNED.md` (2 refs)
 
-- [ ] Revisar cada uno y actualizar/borrar según corresponda
+### No tocar (intencional)
+- `docs/debian-only-cleanup.md` — es este mismo plan
 
 ---
 
-## PENDIENTE — Verificación CI
+## PENDIENTE — Verificación CI y end-to-end
 
-- [ ] Correr `molecule test` en rol `funcional` y verificar que pasa verde
-- [ ] Correr `molecule test` en rol `developer` y verificar que pasa verde
+### Validación con Molecule (Docker, sin GUI)
+- [x] Correr `molecule test` en rol `funcional` — pasa verde ✓
+- [ ] Correr `molecule test` en rol `developer`
+- [ ] Correr `molecule test` en rol `sysadmin`
 - [ ] Verificar que el workflow de GitHub Actions pasa después de los cambios CI
 
+### Validación end-to-end (PC física o VM con GUI)
+**Imprescindible antes de mergear a main.** Molecule no cubre:
+- Configuración de GNOME (dconf, extensiones, atajos)
+- Branding (wallpapers, temas, layout del dock)
+- Sesiones Xorg/GDM3, AccountsService
+- Instalación real de paquetes con GUI (Chrome, VS Code, flameshot, etc.)
+
+- [ ] Probar perfil `funcional` en PC física o VM Debian 13 limpio
+- [ ] Probar perfil `developer` en PC física o VM Debian 13 limpio
+- [ ] Probar perfil `sysadmin` en PC física o VM Debian 13 limpio
+- [ ] Verificar idempotencia: correr el playbook 2 veces, segunda corrida debe ser `changed=0` (excluyendo tareas que tocan tiempo/random)
+- [ ] Verificar que GNOME extensiones se instalan correctamente
+- [ ] Verificar que Xorg se fuerza correctamente (sesión activa post-reinicio)
+
 ---
 
 ## Orden sugerido de ejecución
@@ -176,10 +224,63 @@ Archivos afectados:
 ✅ GRUPO 9   → Molecule converge.yml   (3 archivos de test)
 ⏳ GRUPO 10  → Makefile                (sacar targets Ubuntu)
 ⏳ GRUPO 11  → workflows/molecule.yml  (sacar matriz Ubuntu)
-⏳ GRUPO 12  → copilot-instructions    (actualizar contexto IA)
-⏳ GRUPO 13  → Docs raíz               (README, specs, testing)
-⏳ GRUPO 14  → Docs en docs/           (limpiar guides y notes)
+✅ GRUPO 12  → copilot-instructions    (actualizar contexto IA)
+✅ GRUPO 13  → Docs raíz               (README, specs, testing)
+⏳ GRUPO 14  → Docs en docs/           (borrar 2 obsoletos + editar 5 activos)
 ```
 
 Después de cada grupo de código: correr `molecule test` del rol afectado.
 Los grupos 12-14 son solo documentación y no requieren validación CI.
+
+---
+
+## 🚀 Próximos pasos sugeridos
+
+**Orden recomendado para terminar la limpieza:**
+
+1. **Commit de lo hecho ahora** (Grupos 12 + 13) — chunk coherente "docs cleanup raíz + copilot"
+   ```bash
+   git add .github/copilot-instructions.md README.md specifications.md TESTING.md QUICKSTART_TESTING.md roles/funcional/README.md docs/debian-only-cleanup.md
+   git commit -m "docs: remove Ubuntu references from root docs and copilot instructions"
+   ```
+
+2. **Grupo 14 — Docs en `docs/`** (también solo texto, sin riesgo)
+   - Borrar 2 obsoletos con `git rm`
+   - Editar 5 activos
+   - Commit aparte: `docs: clean Ubuntu references in docs/ directory`
+
+3. **Grupo 10 — Makefile** (sacar targets Ubuntu)
+   - Commit: `chore: remove Ubuntu targets from Makefile`
+
+4. **Grupo 11 — workflows/molecule.yml** (sacar matriz Ubuntu del CI de GitHub Actions)
+   - ⚠️ **NO TOCAR** `runs-on: ubuntu-latest` (es el runner OS, no la distro testada)
+   - Commit: `ci: remove Ubuntu from molecule test matrix`
+
+5. **Tests Molecule** (Docker, sin GUI)
+   ```bash
+   make test-developer   # ~10 min
+   make test-sysadmin    # ~10 min
+   ```
+
+6. **Validación end-to-end en PC física o VM** ⚠️ **IMPRESCINDIBLE**
+   - Levantar una VM (VirtualBox/KVM) con **Debian 13 limpio** o usar una notebook formateada
+   - Correr el bootstrap completo:
+     ```bash
+     curl -L -o adhoc-ansible https://raw.githubusercontent.com/ingadhoc/ansible_notebooks/<branch>/launch_project.sh
+     chmod +x adhoc-ansible
+     sudo ./adhoc-ansible
+     ```
+   - Probar cada perfil (`funcional`, `developer`, `sysadmin`) y verificar:
+     - Sin errores Ansible al correr
+     - Idempotencia: segunda corrida con `changed=0`
+     - GNOME: extensiones instaladas, atajos funcionando, branding aplicado
+     - Sesión Xorg activa después de reiniciar
+     - VS Code, Chrome, Docker funcionando
+
+7. **Push de la rama y abrir PR**
+   ```bash
+   git push -u origin chore/debian-only-cleanup
+   gh pr create --title "Migrate to Debian-only support" --body "..."
+   ```
+
+8. **Grupo 6 — `local_dns.yml`** — pendiente de decisión funcional (NO bloquea el PR)