meeko clean

meeko clean devuelve un proyecto a su estado de origen: borra .meeko/ (tipos, entradas, manifiestos, builds y los tsconfig.* generados) y la caché de Vite en node_modules/.vite. Con --all borra además node_modules entero. Nada más: los archivos de la aplicación, .env, package.json y los lockfiles nunca se tocan.

Sólo actúa sobre un proyecto Meeko y borra una lista fija de rutas dentro de él, sin entrar nunca en un enlace simbólico o una junction: es seguro con link: de pnpm y con npm link.

Uso#

meeko clean --dry-run

Se borraría .meeko (90 archivos, 942.0 KiB)
Se borraría node_modules/.vite (2 archivos, 169 B)
Se liberarían 942.1 KiB en C:\proyectos\tienda (simulación: no se ha borrado nada)

meeko clean

Borrado .meeko (90 archivos, 942.0 KiB)
Borrado node_modules/.vite (2 archivos, 169 B)
Liberados 942.1 KiB en C:\proyectos\tienda

Tipo#

meeko clean [directorio] [--all] [--dry-run]

Opciones#

Las dos banderas pueden ir en cualquier orden y posición después de clean: meeko clean --all --dry-run . es válido. No hay más: --force da Opción desconocida para clean: --force.

Resultado#

El código de salida es 0 salvo que algo no se pudiera borrar o el directorio no se admita, que es 1.

Ejemplos#

Reinstalar desde cero#

meeko clean --all
pnpm install

Los enlaces de node_modules (los de pnpm, o node_modules/@meekojs/meeko con link:) se borran como enlaces: el repositorio al que apuntan queda intacto. El informe los cuenta aparte, como 4 enlaces (sin seguir).

Antes de un build limpio en CI#

npx meeko clean
npx meeko build

Útil cuando una caché de CI restaura un .meeko/ de otra rama. meeko build vacía su carpeta de salida en cada ejecución, pero no borra los tipos ni los manifiestos de rutas que ya no existen.

Ver cuánto ocupa lo generado#

meeko clean --all --dry-run

Se borraría .meeko (90 archivos, 942.0 KiB)
Se borraría node_modules (2 archivos, 4 enlaces (sin seguir), 169 B)
Se liberarían 942.1 KiB en C:\proyectos\tienda (simulación: no se ha borrado nada)

El tamaño sólo cuenta los archivos que se borrarían, no el destino de los enlaces.

Errores comunes#

Ejecutarlo fuera de un proyecto#

cd ..
meeko clean

Meeko no limpia C:\proyectos: no es un proyecto Meeko (no tiene meeko.config.ts ni @meekojs/meeko en dependencies o devDependencies de package.json)

El comando se niega antes de medir nada, con código 1. También rechaza la raíz de una unidad (es la raíz del sistema de archivos) y la carpeta personal del usuario o cualquiera que la contenga.

meeko clean tienda

Esperar que borre otras carpetas de build#

meeko clean --force dist

Opción desconocida para clean: --force. Y sin la bandera, dist/ tampoco se borraría: la lista de rutas es fija (.meeko, node_modules/.vite y, con --all, node_modules).

meeko clean
rm -rf dist

Una ruta mal escrita#

meeko clean ./tiend

No se puede limpiar C:\proyectos\tiend: el directorio no existe, con código 1. Apuntar a la carpeta personal da Meeko no limpia C:\Users\ana: es la carpeta personal del usuario o la contiene.

meeko clean ./tienda

Limpiar mientras meeko dev sigue en marcha#

# con meeko dev corriendo en otra terminal
meeko clean

El borrado no falla, pero meeko dev escribe .meeko/ sólo al arrancar: el servidor sigue respondiendo con los módulos que ya tenía en memoria, sin las entradas en disco, y .meeko/types/ queda vacío para el editor y para tsc hasta el siguiente meeko dev o meeko check.

# Ctrl+C en meeko dev
meeko clean
meeko dev

Notas#

• Seguridad. El directorio se resuelve a su ruta real; cada ruta borrada debe estar dentro de él, y una ruta cuya carpeta padre es un enlace a otro sitio se omite con aviso. Los enlaces y las junctions se borran como enlaces, sin entrar.
• Windows. Los bloqueos transitorios de Windows (EBUSY, EPERM, EACCES, ENOTEMPTY, típicos de antivirus e indexadores) se reintentan cinco veces con espera creciente (de 50 a 800 ms). Los archivos de sólo lectura se desbloquean antes de borrarlos. Una junction se elimina con rmdir sin recursión, que sólo quita el punto de reparación.
• POSIX. Los enlaces simbólicos se eliminan con unlink, sin seguirlos.
• Qué no borra. .env, los lockfiles, package.json, public/, dist/ y cualquier otra carpeta. Para un monorepo, ejecútalo en cada aplicación.
• Rendimiento. Borra por lotes de 32 archivos en paralelo. --dry-run recorre el árbol entero para medirlo, así que en un node_modules grande también tarda.
• Sin nada que borrar. Si no existe ninguna de las rutas, imprime Nada que limpiar en <proyecto> y termina con código 0.

Relacionado#

• meeko devServidor de desarrollo de una aplicación full-stack, que prepara los tipos de .meeko/ y sirve la aplicación con Vite, SSR y HMR.
• meeko buildComprueba el proyecto y escribe en .meeko/output/<adaptador>/ la salida de producción, con el cliente, el servidor y las páginas prerenderizadas.
• Limpiar el proyectoMeeko como framework full-stack