docker-swarm 0.7.0 → 0.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2cfb44c7a62e5acff4c50b2ef3a0e6bf1099a373168dd5ab5b84acaf64b992be
-  data.tar.gz: cfce12e7a89c7445e529abb318d96b4537ea48f57feeb9a8a868811cf36e5761
+  metadata.gz: 4173c79f1bd808f22729c09eda7b4b70a494c4f080625fff33285a410f1224dc
+  data.tar.gz: a8d0aaa08dc6ed272e16ef3577d59f7571791d793a7a2192afb4b5be762c2578
 SHA512:
-  metadata.gz: 21537e14be775b36a683347b95b20c7bdf470390196aef69ec33f2107beab3b3b05ad293961f17fe9dde25537893323abb54b9cadeae0787aeff2f903cc4133d
-  data.tar.gz: 65be2402e1745493295b3f399343d659bb3b63bc15af92ad13f788172658229a28af3a6ce22d58b92af103757c4ab384a81c2e6d6ba7045e6b11585e0d3800c8
+  metadata.gz: 88d788fdd06036b76b6c666f46acfc6880bbb74b8f80feb706a8cfe71aa6e7a62164717de75b5711dc34086218a3feaf5e90323461ab27f76685417d199a07cd
+  data.tar.gz: 44bd8aa057c5b1d9e9e160deed73f13e08d0c441ba4f63a2f0d4142a89c2dc5c3939f732c80adca3c298e7e61b3192506dcf30064c93c9caaf6fa01ee4d4efc9

data/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.7.2] — 2026-06-29
+
+### Documentación
+- Regenerar la capa de configuración conforme RFC-012 (`docs/config/configuracion.md`): inventario de las 7 opciones runtime del bloque `configure`, sin env vars, ninguna secreta — @Gabriel
+- Reindexar `skill/SKILL.md` §4 para apuntar al nuevo artefacto de configuración — @Gabriel
+- Instaurar `AGENTS.md` (stanza "Mapa de conocimiento") y normalizar `skills.yml` al molde fleet — @Gabriel
+
+### Mejoras internas
+- Bump excon 1.4.2 → 1.5.0 — @Gabriel
+
+## [0.7.1] — 2026-05-29
+
+### Correcciones
+- `Updatable#update`: captura `Version.Index` **antes** de `assign_attributes` para evitar que un payload con versión desactualizada pise el índice real del nodo y provoque `update out of sequence` en Docker — @Pablo
+
 ## [0.7.0] — 2026-05-21
 
 ### Breaking changes

data/README.md

@@ -44,12 +44,13 @@ Documentación normada (RFC-001) por capa:
 | Datos | — | `n/a` (gema sin DB) |
 | Glosario | [`docs/glossary/glossary.md`](docs/glossary/glossary.md) | F1 completo |
 | Comportamiento | [`docs/behavior/behavior.md`](docs/behavior/behavior.md) | F1 backfill on-demand (8 flujos) |
+| Configuración | [`docs/config/configuracion.md`](docs/config/configuracion.md) | F6 inventario base (7 opciones, sin env vars) |
 | API (operaciones) | — | F2 pendiente; contrato resumido inline en `skill/SKILL.md` |
 | Interfaz | — | F2 pendiente; contrato resumido inline en `skill/SKILL.md` |
 | Topología | — | F2 pendiente |
 | Eventos | — | `n/a` (la gema no emite eventos) |
 
-`n/a` = no aplica al tipo de repo. F2 pendiente = capa declarada en la RFC pero todavía no implementada en `dev-structure`; el contenido relevante vive transitoriamente en `skill/SKILL.md` (RFC-008 §2 coexistencia transitoria).
+`n/a` = no aplica al tipo de repo. F2 pendiente = capa declarada en la RFC pero todavía no implementada en `arch-structure`; el contenido relevante vive transitoriamente en `skill/SKILL.md` (RFC-008 §2 coexistencia transitoria).
 
 ## Desarrollo
 

data/docs/config/configuracion.md

@@ -0,0 +1,74 @@
+# Configuración — docker-swarm
+
+> meta: artefacto · RFC-012 · generado arch-structure · anclado a `e8c7594` · cobertura: configuración runtime de la gema (clase `DockerSwarm::Configuration`, seteada vía `DockerSwarm.configure`)
+
+## 1. Resumen
+
+Configuración runtime de la gema. 7 opciones, todas programáticas vía `DockerSwarm.configure { |c| ... }` sobre `DockerSwarm::Configuration` (`lib/docker_swarm/configuration.rb`). **Cero env vars** (verificado: sin `ENV[`/`ENV.fetch` en `lib/`). Todas con default; ninguna requerida ni secreta.
+
+## 2. Cuerpo
+
+### a. Hecho verificable (conteos)
+
+| métrica | valor |
+|---|---|
+| total opciones | 7 |
+| requeridas | 0 |
+| con default | 7 |
+| derivadas | 0 |
+| secretas | 0 |
+
+### b. Inventario base
+
+| nombre | tipo | requerida | default | origen | consumidor (file:line) | secret? |
+|---|---|---|---|---|---|---|
+| `socket_path` | String | no | `"unix:///var/run/docker.sock"` | code-default | `connection.rb:116-119` (vía `docker_swarm.rb:28`) | no |
+| `logger` | Logger | no | `Logger.new($stdout)` | code-default | `docker_swarm.rb:19-20,28` · `connection.rb:70-85` | no |
+| `log_level` | Integer (Logger level) | no | `Logger::INFO` | code-default | `docker_swarm.rb:20` | no |
+| `read_timeout` | Float | no | `60.0` | code-default | `connection.rb:29` | no |
+| `write_timeout` | Float | no | `60.0` | code-default | `connection.rb:30` | no |
+| `connect_timeout` | Float | no | `10.0` | code-default | `connection.rb:31` | no |
+| `max_retries` | Integer | no | `3` | code-default | `connection.rb:32` | no |
+
+> Definición/categoría/failure-mode/side-effect/business-reason: `—` (sembrado, lo llena `arch-enrich` §f).
+
+### c. Meta-templates
+
+Plantilla `<x>_timeout` (≥3 instancias):
+
+- Instancias: `read_timeout`, `write_timeout`, `connect_timeout`.
+- Tipo común: `Float`. Setter coacciona valor con `&.to_f` (`configuration.rb:20-30`).
+- Delta por instancia: default `read`/`write` = `60.0`; `connect` = `10.0`.
+- Consumo: pasadas a Excon como opciones homónimas (`connection.rb:29-31`).
+
+### d. Derivaciones simples
+
+`—` n/a. No hay constantes derivadas de otras opciones.
+
+### e. Scheduling
+
+`—` n/a. Gema cliente sin scheduler (`sidekiq.yml`/`queue.yml`/`recurring.yml` ausentes).
+
+### i. Inyecciones al host
+
+`—` n/a. Sin Railtie/Engine (`lib/**/railtie.rb`/`engine.rb` y `lib/generators/` ausentes). Único efecto al configurar: `DockerSwarm.configure` setea `logger.level = log_level` (`docker_swarm.rb:19-20`) — efecto sobre el logger inyectado por el consumidor, no sobre el host.
+
+### j. Inyección a gemas configuradas
+
+`—` n/a. No configura otras gemas.
+
+## 3. Inferencias
+
+| inferencia | confidence | a verificar |
+|---|---|---|
+| Sin env vars: config 100% programática vía `DockerSwarm.configure` | declared | `grep -rn "ENV" lib/` → 0 hits (verificado) |
+| `log_level` es constante `Logger` (Integer 0-5); default `Logger::INFO` (=1) | declared | `configuration.rb:13` |
+| `max_retries` se aplica **solo** a requests idempotentes; en no-idempotentes Excon recibe `retries: 0` | inferred | `connection.rb:32` (`idempotent ? max_retries : 0`) |
+| `socket_path` soporta unix socket (`unix://`) y TCP; el transporte se ramifica por prefijo | inferred | `connection.rb:116-119` (`start_with?("unix://")`) |
+
+## 4. Cobertura y fronteras
+
+- **Frontera con el consumidor:** la gema no lee env. Un servicio que la usa puede mapear sus propias env vars a estos setters en su initializer — eso pertenece al `docs/config/` del consumidor, no a este artefacto.
+- **Enriquecimiento pendiente:** columnas semánticas (`categoría`, `failure-mode`, `side-effect`, `scope-override`, `business-reason`) sembradas `—` → las llena `arch-enrich` (§f Enriquecimiento semántico).
+- **n/a en esta capa:** §d derivaciones, §e scheduling, §i inyecciones al host, §j inyección a gemas — la gema es cliente puro sin Railtie/scheduler/derivaciones.
+- **Linter de secrets:** sin hallazgos (ningún default con literal sensible; ningún nombre matchea `*_KEY|*_SECRET|*_PASS|*_TOKEN`).

data/lib/docker_swarm/concerns/updatable.rb

@@ -6,13 +6,14 @@ module DockerSwarm
       extend ActiveSupport::Concern
 
       def update(new_attributes = {})
+        current_version = self.Version&.dig("Index")
         assign_attributes(new_attributes) if new_attributes.present?
         return false unless valid?
 
         Api.request(
           action: self.class.routes[:update],
           arguments: { id: self.ID },
-          query_params: { version: self.Version&.dig("Index") },
+          query_params: { version: current_version },
           payload: payload_for_docker
         )
 

data/lib/docker_swarm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DockerSwarm
-  VERSION = "0.7.0"
+  VERSION = "0.7.2"
 end

data/skill/SKILL.md

@@ -166,6 +166,7 @@ Logs salen en formato KV (`component=docker_swarm.connection event=request_succe
 
 - [`docs/glossary/glossary.md`](docs/glossary/glossary.md) — definición de términos (primitivas Docker + conceptos internos).
 - [`docs/behavior/behavior.md`](docs/behavior/behavior.md) — secuencias load-bearing (create+reload, update+Version, retry-policy, error-mapping, etc.).
+- [`docs/config/configuracion.md`](docs/config/configuracion.md) — inventario de configuración runtime (7 opciones del bloque `configure`, sin env vars, ninguna secreta). El bloque de arriba es el resumen; shape/defaults/consumidores en el detalle.
 - `docs/data/` — `n/a` (gema sin DB).
 - `docs/api/`, `docs/interface/`, `docs/topology/` — F2 declaradas, **no implementadas**. El contrato resumido de arriba reside **transitoriamente** acá (RFC-008 §2 coexistencia transitoria con destino pendiente).
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: docker-swarm
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.7.2
 platform: ruby
 authors:
 - Gabriel
@@ -91,6 +91,7 @@ files:
 - LICENSE
 - README.md
 - docs/behavior/behavior.md
+- docs/config/configuracion.md
 - docs/glossary/glossary.md
 - lib/docker-swarm.rb
 - lib/docker_swarm.rb
@@ -127,9 +128,9 @@ licenses:
 metadata:
   homepage_uri: https://github.com/gedera/docker-swarm
   source_code_uri: https://github.com/gedera/docker-swarm
-  changelog_uri: https://github.com/gedera/docker-swarm/blob/v0.7.0/CHANGELOG.md
+  changelog_uri: https://github.com/gedera/docker-swarm/blob/v0.7.2/CHANGELOG.md
   bug_tracker_uri: https://github.com/gedera/docker-swarm/issues
-  documentation_uri: https://github.com/gedera/docker-swarm/blob/v0.7.0/skill/SKILL.md
+  documentation_uri: https://github.com/gedera/docker-swarm/blob/v0.7.2/skill/SKILL.md
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: