@ingeniomaps/cauce 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -8,6 +8,38 @@ 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.0] - 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.
+
+### 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
+
+- **El bridge de Antigravity negaba cada llamada a herramienta.** Resolvía la raíz ops subiendo por el
+  árbol, y en sidecar es un *hermano* de los repos de producto: no la encontraba y, como falla cerrado,
+  bloqueaba todo. Ahora `automation install` le deja escrito dónde quedó, con el recorrido hacia arriba
+  como respaldo.
+- **`automation install antigravity` copiaba el plugin y lo dejaba inerte.** Antigravity exige un
+  registro explícito —`agy plugin install`—, así que los archivos quedaban en su lugar, `doctor` daba
+  verde y no se ejecutaba nada. `install` ahora dice el comando exacto y `doctor` avisa si falta, sin
+  tocar por su cuenta la configuración global del usuario.
+
 ## [0.6.0] - 2026-08-15
 
 ### Cambiado

package/automatization/runners/antigravity/hook.js

@@ -11,7 +11,22 @@ function readInput() {
   } catch { return {} }
 }
 
+// Dónde quedó la raíz ops respecto de la carpeta que Antigravity abre. Lo completa
+// `automation install`, que es el único momento en que se sabe: en modo sidecar la raíz ops es un
+// hermano de los repos de producto, y ninguna búsqueda hacia arriba la encuentra. Sin esto el bridge
+// no hallaba `ops.config.json` y, como falla cerrado, negaba cada llamada a herramienta.
+const OPS_DIR = '{{OPS_DIR}}'
+
+function declaredRoot() {
+  // El plugin vive en <raíz-de-instalación>/.agents/plugins/cauce/.
+  const installed = path.resolve(__dirname, '..', '..', '..')
+  const root = OPS_DIR.startsWith('{{') ? installed : path.join(installed, OPS_DIR)
+  return fs.existsSync(path.join(root, 'ops.config.json')) ? root : ''
+}
+
 function findRoot(input) {
+  const declared = declaredRoot()
+  if (declared) return declared
   const args = input.toolCall && input.toolCall.args || {}
   const starts = [args.Cwd, process.cwd(), ...(input.workspacePaths || [])].filter(Boolean)
   for (const start of starts) {

package/automatization/runners/antigravity/manifest.json

@@ -48,5 +48,13 @@
     "checkpointing": false,
     "nativeSkills": true
   },
-  "roleSkills": ".agents/plugins/cauce/skills"
+  "roleSkills": ".agents/plugins/cauce/skills",
+  "activation": {
+    "hint": "agy plugin install .agents/plugins/cauce",
+    "verify": [
+      "plugin",
+      "list"
+    ],
+    "expect": "cauce"
+  }
 }

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`

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 = {
@@ -100,7 +100,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/engine/automation/index.js

@@ -182,6 +182,15 @@ function installRoleSkills(root, runner, output) {
   return roles.length
 }
 
+// Runners que además de los archivos necesitan un registro propio para que el wiring cuente. Copiar
+// y quedarse ahí deja un plugin inerte: los archivos están, `doctor` da verde y nada se ejecuta.
+function activated(runner) {
+  if (!runner.activation) return true
+  const result = spawnSync(runner.command, runner.activation.verify, { encoding: 'utf8' })
+  if (result.status !== 0) return null
+  return `${result.stdout || ''}`.includes(runner.activation.expect)
+}
+
 function hasHooks(config) {
   if (config.hooks && Object.keys(config.hooks).length) return true
   const events = [
@@ -423,6 +432,10 @@ function doctor(root, name, output = console) {
     ['-c', 'command -v "$1" >/dev/null 2>&1', 'runner-doctor', runner.command],
   )
   if (executable.status !== 0) warnings.push(`${runner.command}: CLI no encontrado en PATH`)
+  else if (activated(runner) === false) {
+    warnings.push(`el plugin está copiado pero no registrado, así que no se ejecuta. `
+      + `Corré desde ${paths.install}: ${runner.activation.hint}`)
+  }
   for (const warning of warnings) output.warn(`⚠ ${name}: ${warning}`)
   for (const error of errors) output.error(`✗ ${name}: ${error}`)
   return { runner, errors, warnings }
@@ -516,6 +529,10 @@ function install(root, name, output = console, options = {}) {
     }
   }
   installRoleSkills(root, runner, output)
+  if (runner.activation && activated(runner) !== true) {
+    output.log(`  ${name}: falta registrarlo para que corra. Desde ${paths.install}:`)
+    output.log(`    ${runner.activation.hint}`)
+  }
   M.write(root, undefined, entregado)
   return runner
 }

package/package.json

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