@ingeniomaps/cauce 0.31.0 → 0.32.0

package/CHANGELOG.md

@@ -14,6 +14,27 @@ desde este repositorio no va, porque el que lee no puede actuar sobre eso. Cuand
 unas pocas líneas casi siempre es porque cuenta cómo se descubrió el problema o por qué se eligió el
 diseño — eso vive en el commit y en el código.
 
+## [0.32.0] - 2026-08-19
+
+### Corregido
+
+- **Las credenciales de un multirepo no existían para el arranque.** `/onboard` leía un solo
+  `.env.example`, el de la raíz del workspace: en un monolito eso es todo, entre repositorios hermanos no
+  es nada. Una corrida real sobre tres repos dejó filas que decían «la credencial del proveedor» sin
+  nombrar una sola variable, y un externo que sólo ese archivo mencionaba —un certificado de organismo
+  fiscal— no apareció en ningún lado.
+
+  Ahora `ops scan` reporta, por servicio, los nombres que declara su ejemplo y de qué archivo salieron, y
+  el arranque los usa para nombrar cada fila. **Sólo los nombres**: el valor es de una persona, y el
+  ejemplo es la mitad pública del par. Se leen `.env.example`, `.env.sample`, `.env.template` y
+  `.env.dist`; un ejemplo de más de cuarenta variables es un archivo generado y no un contrato, así que
+  se corta ahí y lo dice.
+
+- **`ops scan <ruta>` dejaba afuera al proyecto de la raíz.** Un monolito que declara sus comandos en el
+  nivel de arriba volvía listando todo menos a sí mismo, mientras que desde adentro de la instancia el
+  mismo árbol sí lo listaba: dos respuestas distintas sobre el mismo directorio. Los dos caminos comparten
+  una sola función y el proyecto de la raíz va primero.
+
 ## [0.31.0] - 2026-08-18
 
 ### Añadido

package/automatization/workflows/onboard.js

@@ -167,8 +167,9 @@ const drafted = await agent(
     'completa.\n'}` +
   `4. ${HUMAN}: una fila por cada cosa que necesita a una persona, con la tarea, el estado pendiente, el ` +
   `origen "onboard" y la acción concreta que la desbloquea. Como mínimo, una por cada credencial que el ` +
-  `proyecto espera —dónde se cargan y quién lo hace, sin proponer ningún valor—, una por cada sistema ` +
-  `externo o MCP a conectar, y una por la autoridad del runner, que hoy declara runner.allowPush=false.\n` +
+  `inventario nombra, diciendo la variable y el servicio que la espera —dónde se carga y quién lo hace, ` +
+  `sin proponer ningún valor—, una por cada sistema externo o MCP a conectar, y una por la autoridad del ` +
+  `runner, que hoy declara runner.allowPush=false.\n` +
   `5. Las preguntas que queden abiertas, en la sección Ideas de ${INBOX}, sin promover.\n` +
   `Devolvé en files cada archivo que tocaste y en assumptions cada supuesto que dejaste marcado.`,
   { schema: WRITTEN, label: 'contexto' },

package/engine/cli/ops.js

@@ -353,29 +353,32 @@ function workspaceRoots(root) {
 
 // Qué hay en las raíces declaradas, antes de que nadie razone sobre ello. La raíz ops se saltea: no es
 // un servicio del proyecto, y su `package.json` sólo declara el motor.
+// Los candidatos de una raíz, con el proyecto que vive en ella misma primero: un monolito declara sus
+// comandos en el nivel de arriba, y dejarlo afuera hacía desaparecer justo al proyecto principal.
+function candidates(workspace, skip = '') {
+  const result = SC.scan(workspace, skip)
+  const found = result.rootManifests.length
+    ? [{ path: '.', root: workspace, runtimes: ['raíz'], commands: result.rootCommands, env: result.rootEnv }]
+    : []
+  return [...found, ...result.services.map((service) => ({ ...service, root: workspace }))]
+}
+
 function inventory(root) {
-  const found = []
-  for (const workspace of workspaceRoots(root)) {
-    const result = SC.scan(workspace, root)
-    if (result.rootManifests.length) {
-      found.push({ path: '.', root: workspace, runtimes: ['raíz'], commands: result.rootCommands })
-    }
-    for (const service of result.services) found.push({ ...service, root: workspace })
-  }
-  return found
+  return workspaceRoots(root).flatMap((workspace) => candidates(workspace, root))
 }
 
 function scan(target, cli) {
   const root = path.resolve(target || '.')
-  const result = target
-    ? { root: path.resolve(target), services: SC.scan(path.resolve(target)).services }
-    : { root, services: inventory(root) }
+  const result = { root, services: target ? candidates(root) : inventory(root) }
   if (cli.has('--json')) return console.log(JSON.stringify(result, null, 2))
   // Un monorepo de sesenta paquetes no se lee en pantalla. Se recorta, y se dice cuánto: un corte que no
   // se anuncia hace pasar lo listado por todo lo que hay.
   for (const service of result.services.slice(0, LISTA)) {
     const donde = service.root && service.root !== result.root ? `${path.basename(service.root)}/` : ''
-    console.log(`${donde}${service.path} [${(service.runtimes || []).join(', ')}]${comandos(service.commands)}`)
+    const espera = service.env ? `\n    espera ${service.env.names.join(', ')} (${service.env.file})` : ''
+    console.log(
+      `${donde}${service.path} [${(service.runtimes || []).join(', ')}]${comandos(service.commands)}${espera}`,
+    )
   }
   if (result.services.length > LISTA) {
     console.log(`… y ${result.services.length - LISTA} más, todos en --json`)

package/engine/core/scan.js

@@ -98,6 +98,35 @@ function manifestsOf(dir) {
   return MANIFESTS.filter((entry) => fs.existsSync(path.join(dir, entry.file)))
 }
 
+// Qué credenciales espera un servicio, por su nombre y nada más. El ejemplo es público y versionado —el
+// `.env` de verdad no se toca nunca—, y los nombres son justo lo que hace falta para dejar una fila que
+// diga qué cargar; el valor no le corresponde a nadie más que a una persona.
+//
+// Se lee por servicio y no sólo en la raíz porque en un multirepo cada repositorio trae el suyo: leyendo
+// una sola raíz, las credenciales de tres repos se volvían invisibles y las acciones humanas terminaban
+// diciendo «la credencial del proveedor» en vez de nombrarla.
+const ENV_EXAMPLES = ['.env.example', '.env.sample', '.env.template', '.env.dist']
+
+// Un ejemplo con cientos de variables es un archivo generado, no un contrato: se corta y se dice.
+const ENV_MAX = 40
+
+function expectedEnv(dir) {
+  for (const name of ENV_EXAMPLES) {
+    const file = path.join(dir, name)
+    if (!fs.existsSync(file)) continue
+    let text = ''
+    try { text = fs.readFileSync(file, 'utf8') } catch { return null }
+    const names = text.split('\n')
+      .map((line) => line.trim())
+      .filter((line) => line && !line.startsWith('#'))
+      .map((line) => line.replace(/^export\s+/, '').split('=')[0].trim())
+      .filter((key) => /^[A-Za-z_][A-Za-z0-9_]*$/.test(key))
+    if (!names.length) return null
+    return { file: name, names: names.slice(0, ENV_MAX), truncated: Math.max(0, names.length - ENV_MAX) }
+  }
+  return null
+}
+
 // Servicios candidatos bajo `root`, sin entrar en `skip` —típicamente la raíz ops, que no es un
 // servicio del proyecto—. El resultado es una lista, no un veredicto: decidir cuál es el producto y
 // cuál quedó muerto sigue siendo trabajo de una persona o de un cargo.
@@ -113,6 +142,7 @@ function services(root, skip = '') {
         runtimes: manifests.map((entry) => entry.runtime),
         manifests: manifests.map((entry) => entry.file),
         commands: commandsOf(dir),
+        env: expectedEnv(dir),
       })
     }
     if (depth >= DEPTH) return
@@ -136,8 +166,9 @@ function scan(root, skip = '') {
     root: path.resolve(root),
     rootManifests: manifestsOf(root).map((entry) => entry.file),
     rootCommands: commandsOf(root),
+    rootEnv: expectedEnv(root),
     services: services(root, skip),
   }
 }
 
-module.exports = { scan, services, IGNORED, DEPTH }
+module.exports = { scan, services, expectedEnv, IGNORED, DEPTH, ENV_MAX }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ingeniomaps/cauce",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "description": "Sistema portable de planificación y ejecución verificable para cualquier proyecto",
   "keywords": [
     "planning",