ALDC Doctor — manual de campo¶

Doctor responde a una sola pregunta: qué hay configurado de verdad en este espacio de trabajo ahora mismo. Lee ficheros y cuenta lo que encuentra. No compila, no ejecuta pruebas, no arranca ningún proveedor y no instala nada.

Ese límite es justo lo valioso. Que Doctor salga limpio no significa que tu extensión compile: significa que nada de la configuración local está bloqueando el intento.

Cómo se ejecuta¶

Doctor necesita Python 3.9 o superior ya instalado y usa solo la biblioteca estándar. La extensión busca python3, python y py -3; si el tuyo está en otro sitio, indícalo en al-collection.pythonPath.

Opciones útiles:

Qué revisa¶

• Proyectos AL. appFolders y testFolders de .AL-Go/settings.json si existe; si no, recorre como mucho tres niveles de carpetas, saltando ocultas, dependencias, salida de compilación y enlaces simbólicos. Las carpetas Test, Tests, test-* o terminadas en .Test o .Tests (AL-Go nombra la suite igual que la app) cuentan como proyecto de pruebas. Cada manifiesto informa de su propio destino de aplicación, aparte del perfil instalado.
• Fuentes de los flujos. Si existen los ficheros de agentes y workflows bajo el directorio del toolkit, y si un punto de entrada nuevo enlaza a un rol que falta (señal de actualización incompleta).
• Marcador de perfil. aldc-profile.json y si contiene bc28 o bc29-native.
• Configuración del host. .vscode/settings.json, tasks.json, launch.json y mcp.json se analizan como JSON. Un fichero roto se reporta contra las operaciones a las que afecta.
• Configuración de BCQuality, cuando se aporta la instantánea. Doctor la contrasta con los bytes de aldc.yaml y rechaza una instantánea caducada.

Que un fichero exista es configuración. Nunca es prueba de que tu host lo haya cargado.

Las cuatro operaciones¶

Valores de estado de cada operación¶

La clave en bruto es la que viaja en el JSON; la etiqueta es la que ves en el panel.

Un valor desconocido se muestra como Unrecognised state conservando debajo el dato original: eso indica que el informe es más nuevo que la extensión.

Códigos de salida¶

Todo en unobserved da salida 0. Es el estado normal de una instalación limpia en la que todavía no se ha ejecutado nada.

Valores de estado de BCQuality¶

Hay que aportar --bcquality-config (el panel lo hace solo) o BCQuality se queda sin revisar.

Las tres etapas¶

Las observaciones de BCQuality avanzan discovered → loaded → executed, en ese orden. Una etapa posterior sin sus previas se rechaza como entrada inválida, no se acepta en silencio. Una ejecución debe traer el texto real de su resultado.

Índice¶

Cómo leer el informe en el panel¶

• Stale. Después de instalar, actualizar o restaurar, el informe mostrado se marca como caducado: describe el proyecto tal como estaba antes de ese cambio. Vuelve a ejecutar Doctor.
• Problemas de configuración. Aparecen con las operaciones a las que afectan. Un problema en mcp.json es informativo; el resto son bloqueantes.
• Instantánea de configuración. Si no se pudo generar la de BCQuality, el panel lo dice y el resto del informe sigue siendo válido.
• Export JSON. El informe en bruto, sin retocar. Es lo que conviene adjuntar al reportar una incidencia.

Problemas habituales¶

Lo que Doctor nunca afirma¶

No afirma que tu host haya cargado un agente, que el compilador AL se haya ejecutado, que las pruebas pasaran ni que un proveedor se ejecutara. Todo lo que informa quien llama queda etiquetado como reportado, nunca como verificado. Salida 0 significa "nada local lo está bloqueando", y nada más.