@ingeniomaps/cauce 0.6.1 → 0.7.1

package/CHANGELOG.md

@@ -8,6 +8,29 @@ esa operación sea confiable en vez de sólo cómoda: acá se lee qué cambió a
 un cambio en el protocolo, en las reglas del sistema o en un guard es visible para el usuario y sube
 minor aunque no toque una sola línea de código.
 
+## [0.7.1] - 2026-08-15
+
+### Corregido
+
+- **Los cuatro workflows reventaban en su primera línea y nunca habían corrido.** Resolvían su raíz
+  con `process.env`, y el runtime de workflows es un sandbox que no expone `process`: `ReferenceError`
+  antes de ejecutar nada. `/team` y `/autobuild` —el centro del producto— estaban muertos, y los tests
+  no lo veían porque leían los archivos como texto en vez de ejecutarlos.
+
+  La raíz ahora viaja escrita en el archivo, que es lo que `automation install` ya sabía completar, y
+  es relativa a donde se abre la herramienta.
+- **Y al arreglar eso, `team` y `autobuild` morían en la línea de cierre**: llamaban a un `finish()`
+  que el runtime tampoco trae. Peor que el anterior, porque ocurría *después* de gastar cada etapa.
+- Dos tests recorren los workflows: uno prohíbe lo que el sandbox no expone, otro falla si se llama a
+  algo que ni el runtime da ni el archivo define.
+
+### Cambiado
+
+- Los workflows de integración se invocan con argumentos en vez de variables de entorno, que tampoco
+  existen ahí: `/integration-sync jira` y `/integration-promote jira KEY-123`.
+- Un test comprueba que ningún workflow use `process`, `require`, `Date.now` ni `Math.random`. El
+  sandbox los prohíbe, y usarlos no falla en una rama rara: impide que el archivo arranque.
+
 ## [0.6.1] - 2026-08-15
 
 ### Corregido

package/automatization/workflows/README.md

@@ -28,8 +28,8 @@ para revisión humana. `integrations/promote.js` exige proveedor, clave y un dra
 el sistema remoto; Jira es actualmente el primer adaptador del contrato general.
 
 ```bash
-OPS_INTEGRATION_PROVIDER=jira /integration-sync
-OPS_INTEGRATION_PROVIDER=jira OPS_INTEGRATION_KEY=KEY-123 /integration-promote
+/integration-sync jira
+/integration-promote jira KEY-123
 ```
 
 ## Aprendizaje de agentes

package/automatization/workflows/autobuild.js

@@ -10,10 +10,10 @@ export const meta = {
   ].map((title) => ({ title, detail: `Fase ${title} del protocolo agnóstico` })),
 }
 
-// El prefijo lo completa `automation install`: en modo sidecar la herramienta se abre en la carpeta
-// de la compañía y la raíz ops es uno de sus hijos, no la carpeta misma.
-const ROOT = (process.env.OPS_ROOT
-  || `${process.env.CLAUDE_PROJECT_DIR || '.'}/{{OPS_DIR}}`).replace(/\/+$/, '')
+// El prefijo lo completa `automation install`. No puede venir del entorno: el runtime de workflows no
+// expone `process`, así que leerlo de ahí reventaba el archivo entero en su primera línea. Viaja
+// escrito, relativo a la carpeta donde se abre la herramienta, que es el cwd de los agentes.
+const ROOT = '{{OPS_DIR}}'.replace(/\/+$/, '') || '.'
 const CONFIG = `${ROOT}/ops.config.json`
 const P = `${ROOT}/planning`
 const BACKLOG = `${P}/BACKLOG.md`
@@ -124,6 +124,14 @@ const CONTRACT = {
 const BASE = `Never invent credentials or decisions; register external blockers in ${HUMAN}. Never execute INBOX ` +
   `automatically. Never push, deploy, amend, force, or use git add -A. Never edit process governance, and do not ` +
   `edit planning bookkeeping unless this workflow explicitly requests it.`
+// Cierre del recorrido. El runtime no trae un helper de cierre —el valor devuelto por el script ya
+// es el resultado—, y darlo por sentado hacía reventar el archivo justo al terminar: después de
+// gastar cada etapa, en la línea que las cerraba.
+function finish(result) {
+  log(`Fin: ${JSON.stringify(result)}`)
+  return result
+}
+
 const stop = (reason, detail = '') => {
   log(`Checkpoint: ${reason}${detail ? ` — ${detail}` : ''}`)
   return finish({ stopped: true, reason, detail })

package/automatization/workflows/integrations/README.md

@@ -9,6 +9,6 @@ remoto → sync → staging → revisión humana → promote → planning
 - `sync.js`: valida y refresca staging sin promover ni escribir remoto.
 - `promote.js`: materializa localmente un candidato cuyo draft está `ready`.
 
-El proveedor se selecciona con `OPS_INTEGRATION_PROVIDER`; `promote` requiere además
-`OPS_INTEGRATION_KEY`. La implementación particular de Jira vive en `engine/integrations/providers/jira.js`,
+El proveedor se pasa como argumento —`/integration-sync jira`—; `promote` requiere además la clave
+remota: `/integration-promote jira KEY-123`. La implementación particular de Jira vive en `engine/integrations/providers/jira.js`,
 no en estos workflows.

package/automatization/workflows/integrations/promote.js

@@ -10,12 +10,15 @@ export const meta = {
   ],
 }
 
-// El prefijo lo completa `automation install`: en modo sidecar la herramienta se abre en la carpeta
-// de la compañía y la raíz ops es uno de sus hijos, no la carpeta misma.
-const ROOT = (process.env.OPS_ROOT
-  || `${process.env.CLAUDE_PROJECT_DIR || '.'}/{{OPS_DIR}}`).replace(/\/+$/, '')
-const PROVIDER = process.env.OPS_INTEGRATION_PROVIDER || ''
-const KEY = process.env.OPS_INTEGRATION_KEY || ''
+// El prefijo lo completa `automation install`. No puede venir del entorno: el runtime de workflows no
+// expone `process`, así que leerlo de ahí reventaba el archivo entero en su primera línea. Viaja
+// escrito, relativo a la carpeta donde se abre la herramienta, que es el cwd de los agentes.
+const ROOT = '{{OPS_DIR}}'.replace(/\/+$/, '') || '.'
+// `/integration-promote jira KEY-123` o `{"provider": "jira", "key": "KEY-123"}`.
+const parts = typeof args === 'string' ? args.trim().split(/\s+/) : []
+const input = typeof args === 'string' ? { provider: parts[0], key: parts[1] } : (args || {})
+const PROVIDER = String(input.provider || '').trim()
+const KEY = String(input.key || '').trim()
 const RESULT = {
   type: 'object', additionalProperties: false, required: ['passed', 'provider', 'key', 'details'],
   properties: { passed: { type: 'boolean' }, provider: { type: 'string' }, key: { type: 'string' }, details: { type: 'string' }, kind: { type: 'string' } },
@@ -24,7 +27,7 @@ const RESULT = {
 phase('Preflight')
 const result = await agent(
   `Read ${ROOT}/integrations/README.md, integrations config, the provider contract and planning/PROTOCOL.md. ` +
-  `Require OPS_INTEGRATION_PROVIDER=${JSON.stringify(PROVIDER)} and OPS_INTEGRATION_KEY=${JSON.stringify(KEY)}. ` +
+  `The provider is ${JSON.stringify(PROVIDER)} and the remote key ${JSON.stringify(KEY)}; both are required. ` +
   `Run integration check. Inspect only that candidate's draft and snapshot; stop unless draft state is ready and ` +
   `acceptance, hierarchy and service mapping are concrete. Never call or write the remote provider.\n\n` +
   `If valid, enter Promote and run "node tools/ops.js integration promote ${ROOT} ${PROVIDER} ${KEY}" exactly once. ` +

package/automatization/workflows/integrations/sync.js

@@ -10,11 +10,13 @@ export const meta = {
   ],
 }
 
-// El prefijo lo completa `automation install`: en modo sidecar la herramienta se abre en la carpeta
-// de la compañía y la raíz ops es uno de sus hijos, no la carpeta misma.
-const ROOT = (process.env.OPS_ROOT
-  || `${process.env.CLAUDE_PROJECT_DIR || '.'}/{{OPS_DIR}}`).replace(/\/+$/, '')
-const REQUESTED = process.env.OPS_INTEGRATION_PROVIDER || ''
+// El prefijo lo completa `automation install`. No puede venir del entorno: el runtime de workflows no
+// expone `process`, así que leerlo de ahí reventaba el archivo entero en su primera línea. Viaja
+// escrito, relativo a la carpeta donde se abre la herramienta, que es el cwd de los agentes.
+const ROOT = '{{OPS_DIR}}'.replace(/\/+$/, '') || '.'
+// `/integration-sync jira` o `{"provider": "jira"}`: sin entorno, el argumento es la única entrada.
+const input = typeof args === 'string' ? { provider: args } : (args || {})
+const REQUESTED = String(input.provider || '').trim()
 const RESULT = {
   type: 'object', additionalProperties: false, required: ['passed', 'provider', 'details'],
   properties: {
@@ -26,7 +28,7 @@ const RESULT = {
 phase('Preflight')
 const result = await agent(
   `Read ${ROOT}/integrations/README.md, ${ROOT}/integrations/config.json and ${ROOT}/planning/PROTOCOL.md. ` +
-  `Resolve provider from OPS_INTEGRATION_PROVIDER=${JSON.stringify(REQUESTED)}; if empty, continue only when exactly ` +
+  `The requested provider is ${JSON.stringify(REQUESTED)}; if empty, continue only when exactly ` +
   `one provider is enabled. Run "node tools/ops.js integration check ${ROOT} <provider>" and read its exit code. ` +
   `Do not edit config and do not call a remote write operation.\n\n` +
   `If green, enter Sync and run "node tools/ops.js integration sync ${ROOT} <provider>". The registered adapter owns ` +

package/automatization/workflows/team.js

@@ -15,10 +15,10 @@ export const meta = {
   ],
 }
 
-// El prefijo lo completa `automation install`: en modo sidecar la herramienta se abre en la carpeta
-// de la compañía y la raíz ops es uno de sus hijos, no la carpeta misma.
-const ROOT = (process.env.OPS_ROOT
-  || `${process.env.CLAUDE_PROJECT_DIR || '.'}/{{OPS_DIR}}`).replace(/\/+$/, '')
+// El prefijo lo completa `automation install`. No puede venir del entorno: el runtime de workflows no
+// expone `process`, así que leerlo de ahí reventaba el archivo entero en su primera línea. Viaja
+// escrito, relativo a la carpeta donde se abre la herramienta, que es el cwd de los agentes.
+const ROOT = '{{OPS_DIR}}'.replace(/\/+$/, '') || '.'
 const P = `${ROOT}/planning`
 const ROADMAP = `${P}/roadmap`
 const HUMAN = `${P}/HUMAN_ACTIONS.md`
@@ -34,9 +34,9 @@ const REPORTS = `${P}/reports`
 // El prefijo se toma como candidato y se confirma más abajo contra los equipos que existen: si no es
 // uno, el texto completo era la intención y nadie tuvo que aprenderse una sintaxis.
 const input = typeof args === 'string' ? { intent: args } : (args || {})
-const raw = String(input.intent || process.env.OPS_INTENT || '').trim()
+const raw = String(input.intent || '').trim()
 const prefix = raw.match(/^([a-z][a-z0-9-]*)\s*:\s*(.+)$/s)
-const CANDIDATE = String(input.team || process.env.OPS_TEAM || (prefix ? prefix[1] : '') || 'product-development')
+const CANDIDATE = String(input.team || (prefix ? prefix[1] : '') || 'product-development')
 const INTENT = (input.team || !prefix ? raw : prefix[2]).trim()
 
 const MANIFEST = {
@@ -78,6 +78,14 @@ const EPIC = {
   },
 }
 
+// Cierre del recorrido. El runtime no trae un helper de cierre —el valor devuelto por el script ya
+// es el resultado—, y darlo por sentado hacía reventar el archivo justo al terminar: después de
+// gastar cada etapa, en la línea que las cerraba.
+function finish(result) {
+  log(`Fin: ${JSON.stringify(result)}`)
+  return result
+}
+
 const stop = (reason, detail = '') => {
   log(`Checkpoint: ${reason}${detail ? ` — ${detail}` : ''}`)
   return finish({ stopped: true, reason, detail })
@@ -100,7 +108,7 @@ const resolved = await agent(
   } }, label: 'team-resolve' },
 )
 if (!resolved) return stop('teams-unavailable', 'no se pudo listar los equipos')
-if (!resolved.exists && (input.team || process.env.OPS_TEAM)) {
+if (!resolved.exists && input.team) {
   return stop('equipo-inexistente', `${CANDIDATE} no existe. Disponibles: ${resolved.teams.join(', ')}`)
 }
 // El prefijo era parte de la intención, no un equipo: se recompone y sigue con el equipo por defecto.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ingeniomaps/cauce",
-  "version": "0.6.1",
+  "version": "0.7.1",
   "description": "Sistema portable de planificación y ejecución verificable para cualquier proyecto",
   "type": "commonjs",
   "bin": {