@ingeniomaps/cauce 0.7.5 → 0.8.1

package/CHANGELOG.md

@@ -8,6 +8,34 @@ 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.1] - 2026-08-15
+
+### Corregido
+
+- `integration enable` no falla si el andamiaje ya está. Habilitar no es inicializar: una instancia
+  que lo arrastra de una versión anterior —o que ya tiene snapshots— sólo quiere el interruptor, y
+  recibía un error pidiéndole un directorio vacío. Ahora repone lo que falte, conserva lo que haya y
+  enciende el registro.
+
+## [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

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,24 @@ 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.`)
+    // Habilitar no es inicializar: repone lo que falte y conserva lo que ya esté. Una instancia que
+    // trae el andamiaje de una versión anterior —o que ya tiene snapshots— sólo quiere el interruptor.
+    copyTemplate(source, path.join(root, 'integrations', provider), {}, true)
+    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}`)

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.5",
+  "version": "0.8.1",
   "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: