Errores comunes

Cierra la terminal y abre una nueva: Windows y macOS solo leen el PATH al abrirla. Si pasa en la terminal de Kiro, cierra Kiro completo y ábrelo otra vez.

Si sigue igual, la herramienta no quedó instalada y hay que repetir su paso en Antes del evento. En macOS y Linux, si es nvm, el script de instalación no agregó nvm a tu ~/.zshrc o ~/.bashrc: vuelve a correrlo y lee lo que imprime al final.

PowerShell no deja correr los .ps1 de npm. Corre esto una vez, en PowerShell normal, y vuelve a intentar:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Contesta S si te pide confirmar. Solo cambia la política para tu usuario.

nvm-windows necesita PowerShell abierto como administrador (clic derecho y Ejecutar como administrador) para correr nvm install lts y nvm use lts. Si node --version sigue mostrando una versión vieja, probablemente quedó una instalación anterior de Node: desinstálala desde Configuración > Aplicaciones, abre una terminal nueva y repite nvm use lts.

El repo pide Node 22 o superior y npm 11.10 o superior, y engine-strict lo hace cumplir. Revisa node --version y npm --version. Si npm es más viejo, corre npm install -g npm@latest. Si Node es más viejo, instala la versión LTS con nvm.

Es un aviso, no un error: los autores marcaron una dependencia del SDK de AWS como deprecated. La instalación sigue. No instales otra versión por tu cuenta ni corras npm audit fix --force.

Hoy marca minimatch dentro de aws-cdk-lib. No hay versión corregida y ese código solo corre en tu laptop cuando CDK genera la plantilla. Hay más en Instalar paquetes sin riesgo. No corras npm audit fix --force.

No lo aceptes: esas banderas son las protecciones del .npmrc. Pídele que explique la causa del error y lo resuelva sin tocarlas. Las reglas de .kiro/steering/npm-seguro.md le piden lo mismo.

No has iniciado sesión con ese perfil: aws login --profile gastos-hormiga.

La sesión de aws login dura un rato. Vuelve a correr aws login --profile gastos-hormiga.

Tu AWS CLI es más viejo que 2.32.0, la primera versión con aws login. Instala la nueva como dice Antes del evento y confirma con aws --version.

Estás creando o leyendo algo en una Región que no es la de tu proyecto. Revisa region en cdk.json y que el comando no lleve --region us-east-1. Los servicios globales como CloudFront, IAM y Budgets son la excepción.

Si te empezó a pasar con algo que antes funcionaba, revisa en AWS Settings > Billing si llegaste a un límite de gasto.

Falta el bootstrap en esta cuenta y Región, o lo hiciste con otro perfil. Corre npm run bootstrap una vez y repite el deploy.

CDK no encontró el esbuild del repo y quiso empaquetar con Docker. Corre npm ci desde la raíz del repo y repite. No instales Docker para esto.

Un deploy anterior falló a medias. Abre CloudFormation y lee el primer evento en rojo de Events: ese es el error de verdad. Si el stack quedó en ROLLBACK_COMPLETE en el primer deploy, bórralo con npm run limpiar y vuelve a desplegar.

Si npm run sync sigue corriendo y corres npm run deploy o npm run rotar-key, los dos actualizan el mismo stack. Pausa npm run sync con Ctrl+C antes de cualquier otro deploy.

Los cambios en src/ se suben en segundos. Si cambias infra/gastos-stack.ts, npm run sync hace un deploy completo con CloudFormation y tarda más: espera a que la terminal diga que terminó. Si marca un error, léelo completo y corrígelo; el siguiente guardado lo reintenta.

Falta la API key o no es la actual. Si la rotaste, actualízala en tu Atajo (npm run datos mostrar-key).

Casi nunca es de autenticación: la ruta no existe. Revisa que la URL lleve /v1 y la ruta exacta (/gastos, no /gasto). Justo después de desplegar una ruta nueva también puede pasar unos segundos.

Tu Lambda desplegada es la versión vacía. Haz la tarea 2 de la spec con Kiro (módulo 4), acepta el diff y vuelve a desplegar.

Si fue con muchas peticiones al mismo tiempo, rebasaste las 10 ejecuciones simultáneas de Lambda de una cuenta nueva. Si fue con una sola, el error está en tu código: búscalo en los logs de la Lambda, con el comando de Comandos del repo.

Es lo esperado hasta el módulo 5. Después de desplegar la API, corre npm run preparar-pagina, agrega el archivo ignorado con git add -f web/config.js, haz commit y push a main, y espera a que Amplify termine el build.

Haz commit y push a main, abre Amplify y espera a que el último build termine en verde.

Tu Lambda respondió sin el header Access-Control-Allow-Origin, o la ruta no existe todavía. Las Lambdas tienen que responder con json() y error() de src/shared/http.ts.

Es normal antes del módulo 5: la página importa config.js y todavía no existe. Después de npm run preparar-pagina, el commit y el push, desaparece.