@ingeniomaps/cauce 0.7.1 → 0.7.3

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.3] - 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.
+
+## [0.7.2] - 2026-08-15
+
+### Cambiado
+
+- **`team` gastaba un cuarto del recorrido en transcribir salida determinista de un CLI.** Dos agentes
+  resolvían el equipo y leían su manifiesto; ahora es uno. El segundo además leía `organization/`
+  "como contexto para etapas siguientes", y cada etapa es un agente nuevo con su propio contexto: esa
+  lectura no llegaba a ninguna parte y sólo costaba tokens.
+- Cada etapa recibe la ruta exacta del contrato de su cargo. Antes le pasaban
+  `agents/<tipo>/<slug>/SKILL.md` —con el `<tipo>` literal— y desde 0.4.0 el catálogo ni siquiera está
+  en el proyecto, así que el agente salía a buscarlo antes de poder empezar.
+
 ## [0.7.1] - 2026-08-15
 
 ### Corregido

package/automatization/workflows/team.js

@@ -40,8 +40,12 @@ const CANDIDATE = String(input.team || (prefix ? prefix[1] : '') || 'product-dev
 const INTENT = (input.team || !prefix ? raw : prefix[2]).trim()
 
 const MANIFEST = {
-  type: 'object', additionalProperties: false, required: ['name', 'purpose', 'stages', 'guardrails'],
+  // `exists` es lo único obligatorio: el mismo agente responde "no hay tal equipo" sin poder llenar
+  // un manifiesto que no existe. El resto se exige después, cuando sí lo hay.
+  type: 'object', additionalProperties: false, required: ['exists'],
   properties: {
+    exists: { type: 'boolean' },
+    teams: { type: 'array', items: { type: 'string' } },
     name: { type: 'string' }, purpose: { type: 'string' },
     outcome: { type: 'string', enum: ['epic', 'report'] },
     entryAgent: { type: 'string' }, facilitator: { type: 'string' },
@@ -49,10 +53,17 @@ 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' } },
+      // Resuelto acá una vez: sin esto cada etapa gasta llamadas buscando el contrato de su cargo,
+      // que además ya no vive en el proyecto sino en el paquete.
+      skill: { type: 'string' },
     } } },
   },
 }
@@ -100,31 +111,35 @@ const BASE = `Nunca inventes clientes, métricas, restricciones ni decisiones. N
   `haría falta averiguar. No promuevas trabajo al BACKLOG, no escribas en sistemas externos y no ` +
   `declares validado nada sin evidencia observable.`
 
-const resolved = await agent(
-  `${BASE}\n\nRun "node tools/ops.js team list" from ${ROOT}. Report whether "${CANDIDATE}" is one of ` +
-  `the slugs it printed, and the full list. Do not guess: report only what the command printed.`,
-  { schema: { type: 'object', required: ['exists', 'teams'], properties: {
-    exists: { type: 'boolean' }, teams: { type: 'array', items: { type: 'string' } },
-  } }, label: 'team-resolve' },
-)
-if (!resolved) return stop('teams-unavailable', 'no se pudo listar los equipos')
-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.
-const TEAM = resolved.exists ? CANDIDATE : 'product-development'
-const GOAL = resolved.exists ? INTENT : raw
-if (!resolved.exists && prefix) log(`"${CANDIDATE}" no es un equipo: se toma el texto completo como intención.`)
-
+// Tres comandos deterministas en un solo agente. Eran dos agentes, y el segundo además leía
+// `organization/` "como contexto para etapas siguientes": cada etapa es un agente nuevo con su
+// propio contexto, así que esa lectura no llegaba a ninguna parte y sólo costaba tokens.
 const contract = await agent(
-  `${BASE}\n\nRun "node tools/ops.js team show ${TEAM} --json" from ${ROOT} and report only what it ` +
-  `printed: name, purpose, outcome, entryAgent, facilitator, guardrails, the stages with id, phase, ` +
-  `agent, ` +
-  `produces and exitGate, and decisionOwners flattened into owners as domain/agent pairs. Then read ` +
-  `${ROOT}/organization/ and report nothing from it: it is context for later stages, not output.`,
+  `${BASE}\n\nFrom ${ROOT}, run exactly these commands and report only what they printed. Read no ` +
+  `other file.\n` +
+  `1. "node tools/ops.js team show ${CANDIDATE} --json".\n` +
+  `   If it fails, run "node tools/ops.js team list", set exists=false, report teams, and stop.\n` +
+  `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.`,
   { schema: MANIFEST, label: 'team-contract' },
 )
-if (!contract) return stop('contract-unavailable', `no se pudo leer el manifiesto de ${TEAM}`)
+if (!contract) return stop('contract-unavailable', `no se pudo leer el manifiesto de ${CANDIDATE}`)
+if (contract.exists === false) {
+  if (input.team) {
+    return stop('equipo-inexistente', `${CANDIDATE} no existe. Disponibles: ${(contract.teams || []).join(', ')}`)
+  }
+  // El prefijo era parte de la intención, no un equipo: se recompone y se reintenta por defecto.
+  return stop('equipo-inexistente', `"${CANDIDATE}" no es un equipo. Repetí sin el prefijo: la ` +
+    `intención completa era "${raw}". Disponibles: ${(contract.teams || []).join(', ')}`)
+}
+if (!contract.name || !contract.stages || !contract.guardrails) {
+  return stop('contrato-incompleto', `el manifiesto de ${CANDIDATE} no trae nombre, etapas o guardrails`)
+}
+const TEAM = CANDIDATE
+const GOAL = INTENT
 
 const owners = (contract.owners || []).map((owner) => `${owner.domain}=${owner.agent}`).join(', ')
 const RULES = `${BASE}\n\nEquipo ${contract.name}: ${contract.purpose}\n` +
@@ -147,7 +162,8 @@ for (const stage of discovery) {
 
   const result = await agent(
     `${RULES}\n\n${previous}\n\nActuá como ${stage.agent}, respetando su contrato en ` +
-    `agents/<tipo>/${stage.agent}/SKILL.md y sus límites. Etapa "${stage.id}": producí ` +
+    `${stage.skill || `${ROOT}/agents/roles/${stage.agent}/SKILL.md`} y sus límites. ` +
+    `Etapa "${stage.id}": producí ` +
     `${(stage.produces || []).join(' y ')}. Distinguí hechos, evidencia, supuestos y preguntas ` +
     `abiertas. El exit gate es: "${stage.exitGate}". Marcá gatePassed sólo si se cumple de verdad; ` +
     `si no, explicá en missing qué falta y en humanAction la acción concreta que lo desbloquea.`,

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.1",
+  "version": "0.7.3",
   "description": "Sistema portable de planificación y ejecución verificable para cualquier proyecto",
   "type": "commonjs",
   "bin": {