@ingeniomaps/cauce 0.7.4 → 0.8.0

package/CHANGELOG.md

@@ -8,6 +8,37 @@ 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.8.0] - 2026-08-15
+
+### Cambiado
+
+- **El andamiaje de una integración se materializa al habilitarla, no antes.** Una instancia recibía
+  32 KB de Jira —configuración, `staging/`, `proposed/`, tres READMEs— para un proveedor con
+  `enabled: false` que quizá no use nunca, y que además nadie actualizaba después. Ahora llega con
+  `ops integration enable <raíz> <proveedor>`, que copia el andamiaje y enciende el registro.
+- `check` valida sólo los proveedores habilitados. Un proveedor registrado y apagado no tiene
+  andamiaje, y exigirle configuración era pedirle a la empresa que mantenga lo que no usa.
+  Nombrarlo explícitamente sí lo valida, que es como se comprueba antes de encenderlo.
+- Una instancia existente conserva lo suyo: `integrations/<proveedor>/` puede tener snapshots y
+  borradores de la empresa, así que no se retira nada.
+
+### Corregido
+
+- `integrations/README.md`, `integrations/AGENTS.md` y `organization/README.md` se actualizan con el
+  toolkit. Los escribe Cauce y envejecían para siempre en cada instancia.
+
+## [0.7.5] - 2026-08-15
+
+### Corregido
+
+- `learn` y `evaluate` resuelven la raíz ops como el resto de los comandos. Quedaron con `cwd` cuando
+  los demás pasaron a usarla: invocados desde la carpeta de la compañía —lo normal en sidecar— no
+  encontraban ningún cargo.
+- **`evaluate` le exigía a una empresa un archivo del toolkit.** `learning/CODEX_AUTOMATION.md`
+  documenta cómo corre nuestra automatización de aprendizaje; pedírselo a quien escribe un cargo
+  propio era pedirle contabilidad interna nuestra. Ahora sólo se exige a los cargos del sistema: el
+  cargo de una empresa necesita contrato, fuentes e historia, no nuestro andamiaje.
+
 ## [0.7.4] - 2026-08-15
 
 ### Corregido

package/engine/agents/learning.js

@@ -127,9 +127,12 @@ function evaluate(root, agent) {
   const requiredFiles = [
     'learning/sources.yaml',
     'learning/HISTORY.md',
-    'learning/CODEX_AUTOMATION.md',
     'evaluations/expected-behaviors.yaml',
   ]
+  // `CODEX_AUTOMATION.md` documenta cómo corre la automatización de aprendizaje del toolkit. Exigírselo
+  // a una empresa que escribe un cargo propio era pedirle contabilidad interna nuestra: su cargo debe
+  // tener contrato, fuentes e historia, no nuestro andamiaje.
+  if (require('./catalog').find(root, agent).system) requiredFiles.push('learning/CODEX_AUTOMATION.md')
   for (const relative of requiredFiles) {
     if (!fs.existsSync(path.join(target, relative))) errors.push(`falta ${relative}`)
   }

package/engine/cli/ops.js

@@ -33,6 +33,7 @@ function usage() {
   ops upgrade <ops-root> [--check] [--force]
   ops archive <planning-dir> <NNN>
   ops integration list <ops-root>
+  ops integration enable <ops-root> <provider>
   ops integration check <ops-root> [provider]
   ops integration sync <ops-root> <provider> [--fixture <json>]
   ops integration promote <ops-root> <provider> <remote-key>
@@ -127,6 +128,16 @@ function declareEngine(manifest, version) {
   F.atomicWriteJson(manifest, pkg)
 }
 
+// Proveedores que el toolkit conoce. El andamiaje de cada uno —configuración, staging/, proposed/—
+// no se materializa hasta que alguien lo habilite: hoy una instancia recibe 32 KB de un proveedor
+// apagado que quizá no use nunca, y que nadie actualiza después.
+function providerNames() {
+  try {
+    const file = path.join(PROJECT_ROOT, 'template', 'integrations', 'config.json')
+    return Object.keys(JSON.parse(fs.readFileSync(file, 'utf8')).providers || {})
+  } catch { return [] }
+}
+
 function init(target) {
   if (!target) fail('Falta <destino>.', 2)
   const mode = option('--mode', 'embedded')
@@ -142,7 +153,7 @@ function init(target) {
     '{{MODE}}': mode,
     '{{PLANNING_DIR}}': 'planning',
     '{{WORKSPACE_PATH}}': mode === 'embedded' ? '.' : '..',
-  }, process.argv.includes('--force'))
+  }, process.argv.includes('--force'), providerNames())
   // `ci.yml` valida el toolkit con `npm run ci`; una instancia no tiene ese script ni sus pruebas.
   copyTemplate(path.join(PROJECT_ROOT, '.github', 'workflows'), path.join(root, '.github', 'workflows'), {
     '{{PROJECT_NAME}}': name,
@@ -673,6 +684,22 @@ async function integration(action, rootArg, provider, key) {
     }
     return
   }
+  if (action === 'enable') {
+    if (!provider) fail('Falta <provider>.', 2)
+    const source = path.join(PROJECT_ROOT, 'template', 'integrations', provider)
+    if (!fs.existsSync(source)) fail(`Cauce no trae un adaptador para ${provider}.`, 2)
+    const registry = path.join(root, 'integrations', 'config.json')
+    let config
+    try { config = JSON.parse(fs.readFileSync(registry, 'utf8')) } catch (error) {
+      fail(`integrations/config.json ilegible: ${error.message}`)
+    }
+    if (!config.providers || !config.providers[provider]) fail(`${provider} no está en integrations/config.json.`)
+    copyTemplate(source, path.join(root, 'integrations', provider), {}, process.argv.includes('--force'))
+    config.providers[provider].enabled = true
+    F.atomicWriteJson(registry, config)
+    console.log(`✓ ${provider}: habilitado. Completá integrations/${provider}/config.json antes de sincronizar.`)
+    return
+  }
   if (action === 'check') {
     const result = I.validate(root, provider || '')
     for (const warning of result.warnings) console.warn(`⚠ ${warning}`)
@@ -761,16 +788,16 @@ function automation(action, rootArg, runnerName) {
 function learn(agent) {
   try {
     const result = process.argv.includes('--proposal')
-      ? L.prepareProposal(process.cwd(), agent)
-      : L.prepareReport(process.cwd(), agent)
-    console.log(`${result.created ? '+' : '='} ${path.relative(process.cwd(), result.file)}`)
+      ? L.prepareProposal(opsRoot(), agent)
+      : L.prepareReport(opsRoot(), agent)
+    console.log(`${result.created ? '+' : '='} ${path.relative(opsRoot(), result.file)}`)
     if (typeof result.reports === 'number') console.log(`  ${result.reports} informe(s) semanal(es) incluidos`)
   } catch (error) { fail(error.message, 2) }
 }
 
 function evaluate(agent) {
   try {
-    const result = L.evaluate(process.cwd(), agent)
+    const result = L.evaluate(opsRoot(), agent)
     for (const error of result.errors) console.error(`✗ ${error}`)
     if (result.errors.length) fail(`\n${result.errors.length} error(es)`, 1)
     console.log(

package/engine/core/ownership.js

@@ -27,6 +27,9 @@ const SYSTEM_FILES = [
   'teams/README.md',
   'automatization/README.md',
   'automatization/AGENTS.md',
+  'integrations/README.md',
+  'integrations/AGENTS.md',
+  'organization/README.md',
   // El shim no tiene una línea de la empresa —dice él mismo que no se edita— y es por donde entra
   // cada comando. Sin declararlo, envejecía para siempre en la instancia.
   'tools/ops.js',

package/engine/integrations/registry.js

@@ -68,7 +68,11 @@ function validate(root, onlyProvider = '') {
   const warnings = []
   let registry
   try { registry = readJson(registryFile) } catch (error) { return { errors: [error.message], warnings } }
-  const providers = Object.entries(registry.providers || {}).filter(([name]) => !onlyProvider || name === onlyProvider)
+  // Sólo los habilitados: un proveedor registrado y apagado no tiene andamiaje —se materializa al
+  // habilitarlo— y exigirle configuración sería pedirle a la empresa que mantenga lo que no usa.
+  // Nombrarlo explícitamente sí lo valida, que es como se comprueba antes de encenderlo.
+  const providers = Object.entries(registry.providers || {})
+    .filter(([name, entry]) => (onlyProvider ? name === onlyProvider : entry && entry.enabled))
   let workspaces = []
   try {
     const ops = readJson(path.join(root, 'ops.config.json'))
@@ -81,6 +85,10 @@ function validate(root, onlyProvider = '') {
   }
   if (!providers.length && onlyProvider) errors.push(`Proveedor no registrado: ${onlyProvider}`)
   for (const [name, entry] of providers) {
+    if (!fs.existsSync(path.join(root, 'integrations', name))) {
+      errors.push(`${name}: no está materializado. Corré "ops integration enable <raíz> ${name}"`)
+      continue
+    }
     if (!entry.adapter) errors.push(`${name}: falta adapter`)
     let loaded
     try { loaded = providerConfig(root, name) } catch (error) { errors.push(error.message); continue }

package/package.json

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

package/template/integrations/README.md

@@ -1,4 +1,4 @@
-# Integraciones de {{PROJECT_NAME}}
+# Integraciones
 
 Los proveedores se registran en `config.json`. Todos siguen el ciclo: