Beta Próximamente. Esta función aún está en desarrollo; los nombres y detalles pueden cambiar antes del lanzamiento.

Gemelo digital del proyecto

Un modelo vivo de tu proyecto, creado a partir del código: sus paquetes, componentes, rutas, APIs, pruebas y las importaciones que los unen. El panel Project Twin muestra el mapa y responde ¿qué toca este archivo? para el archivo abierto, y el gemelo se actualiza cada vez que guardas.

Silver El gemelo digital del proyecto viene con Silver, Gold y Platinum. Con otro plan el panel sigue ahí, dice qué plan lo incluye y no se crea nada.

El panel Project Twin junto a src/cartStore.ts: recuento por capas y después What touches this file? con 3 archivos que lo importan, las pruebas que llegan a él, POST /orders y /checkout por encima y money.ts que importaEl panel Project Twin junto a src/cartStore.ts: recuento por capas y después What touches this file? con 3 archivos que lo importan, las pruebas que llegan a él, POST /orders y /checkout por encima y money.ts que importa
El panel Project Twin junto a src/cartStore.ts: recuento por capas y después What touches this file? con 3 archivos que lo importan, las pruebas que llegan a él, POST /orders y /checkout por encima y money.ts que importa

Abrir el panel

Pulsa ⌥⇧T (Alt+Shift+T) o elige Project Twin: Show Project Twin en Find Action. El panel se abre a la izquierda. La primera vez, Ingot recorre el proyecto y crea el gemelo; en un proyecto grande tarda unos segundos.

Qué contiene el gemelo

CapaQué cuenta
PaquetesCarpetas con su propio package.json (uno en un proyecto de un paquete, cada paquete de un monorepo)
ComponentesComponentes exportados en archivos .jsx y .tsx (nombres en PascalCase), y archivos .vue y .svelte
RutasRutas del sistema de archivos (pages/cart.tsx, app/orders/[id]/page.tsx, routes/…) y tablas de rutas (<Route path="/checkout">, { path: '/cart' })
APIsManejadores como router.post('/orders') o app.get('/users/:id'), clases @Controller con @Get / @Post, pages/api/… y app/api/…/route.ts
Pruebas*.test.*, *.spec.*, archivos en tests/, __tests__/ y e2e/, test_*.py
MódulosCualquier otro archivo de código

Entre archivos, el gemelo guarda las importaciones, resueltas a los archivos a los que apuntan (rutas relativas y alias de tsconfig). Se basa en relaciones del código, no en coincidencias de texto.

Haz clic en una capa para ver sus archivos, los más importados primero; haz clic en un archivo para abrirlo.

¿Qué toca este archivo?

La parte de arriba del panel sigue al archivo del editor actual:

GrupoArchivos
Imported byArchivos que lo importan directamente; el titular dice cuántos
Tests that reach itPruebas que lo importan, o que importan un archivo que lo importa
Routes and APIs above itRutas y APIs que llegan a él por importaciones (hasta cuatro pasos)
It importsLos archivos del proyecto que importa

Míralo antes de cambiar un archivo: ves qué podrías romper y qué pruebas ejecutar.

Siempre al día

  • El gemelo se guarda en .ingot/twin/twin.json dentro de tu proyecto. Su carpeta tiene su propio .gitignore, así nunca se sube al repositorio: se vuelve a crear a partir del código.
  • Cada archivo que guardas, añades o borras actualiza solo ese archivo en el gemelo, en un momento.
  • Al abrir el proyecto otra vez, solo se vuelven a leer los archivos que cambiaron.
  • Project Twin: Rebuild Project Twin (o ↻ en el panel) lo crea de nuevo desde cero.

Desactivarlo

El gemelo está activado por defecto. Desactívalo en Settings › Features › Project Digital Twin; el panel se cierra y el gemelo deja de actualizarse.

AjusteValoresPor defecto
ingot.twin.enabledtrue o falsetrue

Conviene saber

  • En un espacio de trabajo con varias carpetas, el gemelo cubre la primera.
  • El Mapa del proyecto que el agente lee al empezar una tarea es un resumen aparte y compacto.
  • Próximamente: hacer preguntas al gemelo con palabras normales, dárselo al agente como contexto y más capas (stores de estado, tablas de base de datos, responsables, cobertura).