@ingeniomaps/cauce 0.7.2 → 0.7.4

package/CHANGELOG.md

@@ -8,6 +8,19 @@ 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.4] - 2026-08-15
+
+### Corregido
+
+- **Una bandera antes del último posicional se comía su lugar.** `agents list --json` tomaba `--json`
+  como la raíz ops y devolvía `[]` sin error: no había forma de distinguir "no hay cargos" de "te
+  contesté con nada". Lo destapó un agente del recorrido de `team`, que pedía ese JSON para resolver
+  dónde vive cada cargo y se quedaba sin dato.
+- La ruta del contrato de cada cargo es obligatoria en el manifiesto que arma `team`. Siendo opcional
+  el agente la omitía, la etapa caía al camino de respaldo y salía a buscar el archivo igual.
+  Y lleva el prefijo de la raíz ops: `agents list` las imprime relativas a ella y las etapas corren
+  desde otro lado, así que sin prefijo la ruta tampoco resolvía.
+
 ## [0.7.2] - 2026-08-15
 
 ### Cambiado

package/automatization/workflows/team.js

@@ -53,7 +53,11 @@ const MANIFEST = {
     owners: { type: 'array', items: { type: 'object', additionalProperties: false, properties: {
       domain: { type: 'string' }, agent: { type: 'string' },
     } } },
-    stages: { type: 'array', items: { type: 'object', additionalProperties: false, properties: {
+    stages: { type: 'array', items: { type: 'object', additionalProperties: false,
+      // `skill` es obligatorio a propósito: siendo opcional el agente lo omitía, la etapa caía al
+      // camino de respaldo y salía a buscar el contrato igual. Un dato que se puede resolver una vez
+      // no debería depender de que alguien se acuerde de resolverlo.
+      required: ['id', 'agent', 'phase', 'skill'], properties: {
       id: { type: 'string' }, agent: { type: 'string' }, exitGate: { type: 'string' },
       phase: { type: 'string', enum: ['discovery', 'delivery'] },
       produces: { type: 'array', items: { type: 'string' } },
@@ -118,8 +122,9 @@ const contract = await agent(
   `2. "node tools/ops.js agents list --json", which gives each role its resolved path.\n` +
   `Report exists=true, the manifest fields —name, purpose, outcome, entryAgent, facilitator, ` +
   `guardrails, stages with id, phase, agent, produces and exitGate, decisionOwners flattened into ` +
-  `owners as domain/agent pairs— and for every stage set skill to "<path>/SKILL.md" using the path ` +
-  `that command 2 printed for that stage's agent.`,
+  `owners as domain/agent pairs— and for every stage set skill to "${ROOT}/<path>/SKILL.md", where ` +
+  `<path> is what command 2 printed for that stage's agent. That command prints paths relative to ` +
+  `${ROOT}, and the stages run from elsewhere, so the prefix is not optional.`,
   { schema: MANIFEST, label: 'team-contract' },
 )
 if (!contract) return stop('contract-unavailable', `no se pudo leer el manifiesto de ${CANDIDATE}`)

package/engine/cli/ops.js

@@ -53,6 +53,23 @@ function usage() {
   ops team show <team>`)
 }
 
+// Banderas que consumen el argumento siguiente: su valor no es un posicional.
+const VALUED_FLAGS = new Set(['--name', '--mode', '--engine', '--fixture'])
+
+// Los posicionales del comando, salteando banderas y sus valores. Leer `process.argv` crudo hacía
+// que `agents list --json` tomara `--json` como la raíz: el catálogo salía vacío, sin error, y quien
+// lo consumía —un agente, por ejemplo— no tenía cómo notar que le habían contestado con nada.
+function positionals() {
+  const found = []
+  const argv = process.argv.slice(2)
+  for (let index = 0; index < argv.length; index += 1) {
+    const value = argv[index]
+    if (!value.startsWith('--')) { found.push(value); continue }
+    if (VALUED_FLAGS.has(value)) index += 1
+  }
+  return found
+}
+
 function option(name, fallback = '') {
   const index = process.argv.indexOf(name)
   return index >= 0 ? process.argv[index + 1] || fallback : fallback
@@ -790,20 +807,21 @@ function team(action, slug) {
 async function main() {
   const command = process.argv[2]
   if (!command || ['help', '--help', '-h'].includes(command)) return usage()
-  if (command === 'init') init(process.argv[3])
-  else if (command === 'check') check(process.argv[3])
-  else if (command === 'tree') tree(process.argv[3])
-  else if (command === 'context') context(process.argv[3])
-  else if (command === 'upgrade') upgrade(process.argv[3])
-  else if (command === 'agents') agents(process.argv[3], process.argv[4])
-  else if (command === 'archive') archive(process.argv[3], process.argv[4])
+  const arg = positionals()
+  if (command === 'init') init(arg[1])
+  else if (command === 'check') check(arg[1])
+  else if (command === 'tree') tree(arg[1])
+  else if (command === 'context') context(arg[1])
+  else if (command === 'upgrade') upgrade(arg[1])
+  else if (command === 'agents') agents(arg[1], arg[2])
+  else if (command === 'archive') archive(arg[1], arg[2])
   else if (command === 'integration') {
-    await integration(process.argv[3], process.argv[4], process.argv[5], process.argv[6])
+    await integration(arg[1], arg[2], arg[3], arg[4])
   }
-  else if (command === 'automation') automation(process.argv[3], process.argv[4], process.argv[5])
-  else if (command === 'learn') learn(process.argv[3])
-  else if (command === 'evaluate') evaluate(process.argv[3])
-  else if (command === 'team') team(process.argv[3], process.argv[4])
+  else if (command === 'automation') automation(arg[1], arg[2], arg[3])
+  else if (command === 'learn') learn(arg[1])
+  else if (command === 'evaluate') evaluate(arg[1])
+  else if (command === 'team') team(arg[1], arg[2])
   else { usage(); fail(`Comando desconocido: ${command}`, 2) }
 }
 

package/package.json

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