docker-swarm 0.7.1 → 0.7.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c4fccd3ff16c561cf1f8563cf2dd518c69fd1a7fc46e9d74b7da804244dd1c4d
-  data.tar.gz: c71beba1337b83edde6eb18f424954e2563c35172e195615ed86b2b40153abe5
+  metadata.gz: 4173c79f1bd808f22729c09eda7b4b70a494c4f080625fff33285a410f1224dc
+  data.tar.gz: a8d0aaa08dc6ed272e16ef3577d59f7571791d793a7a2192afb4b5be762c2578
 SHA512:
-  metadata.gz: 9165d28e2a0def50e674578600642dbaf3aca92b586bb5697590828a3081476139013922f45471dd84d45c376b997bd74bf78e3064d12ab14e3fd9bd046d2743
-  data.tar.gz: c2deb17e70f07a51b8e29ac69b9923706e8a57124fd3ddb4d36a30dded13de1fa4024d1a8c9dc1470cb984dd24da5a2a04cb7c6601a4022bcdecb84557516b79
+  metadata.gz: 88d788fdd06036b76b6c666f46acfc6880bbb74b8f80feb706a8cfe71aa6e7a62164717de75b5711dc34086218a3feaf5e90323461ab27f76685417d199a07cd
+  data.tar.gz: 44bd8aa057c5b1d9e9e160deed73f13e08d0c441ba4f63a2f0d4142a89c2dc5c3939f732c80adca3c298e7e61b3192506dcf30064c93c9caaf6fa01ee4d4efc9

data/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 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

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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DockerSwarm
-  VERSION = "0.7.1"
+  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.1
+  version: 0.7.2
 platform: ruby
 authors:
 - Gabriel
@@ -91,7 +91,7 @@ files:
 - LICENSE
 - README.md
 - docs/behavior/behavior.md
-- docs/config/config.md
+- docs/config/configuracion.md
 - docs/glossary/glossary.md
 - lib/docker-swarm.rb
 - lib/docker_swarm.rb
@@ -128,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.1/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.1/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:

data/docs/config/config.md

@@ -1,140 +0,0 @@
-# Inventario de Configuración — docker-swarm
-
-> meta: artefacto · generado manual · anclado a `b3549e7` · cobertura: archivos de configuración versionados del repo (excluye `lib/`, `spec/`, `skill/`, `docs/`)
-
-## 1. Resumen
-
-Lista de archivos de configuración del repo, qué controlan, quién los consume y dónde tocar para cambiar comportamiento. Agrupados por dominio: **gema**, **Ruby/lint**, **CI/CD**, **dependencias automatizadas**, **agentes/skills**, **entorno local**.
-
-## 2. Gema
-
-### `docker-swarm.gemspec`
-
-Especificación de la gema (nombre, versión, autoría, deps runtime, ficheros incluidos, metadatos RubyGems). Versión leída desde `lib/docker_swarm/version.rb`.
-
-- Ruby mínimo: `>= 3.2.0`
-- Runtime deps: `activesupport >= 6.0`, `activemodel >= 6.0`, `excon >= 0.80`
-- Dev deps: `rake ~> 13.0`, `rspec ~> 3.0`
-- Files glob: `{lib,exe,skill,docs}/**/*` + `README.md`, `CHANGELOG.md`, `LICENSE`
-- MFA RubyGems: requerido (`rubygems_mfa_required = true`)
-- Cambio típico: bumpear versión → editar `lib/docker_swarm/version.rb` (no acá).
-
-### `Gemfile`
-
-Sólo declara `gemspec` + grupos `:development, :test` y `:test`. Runtime deps viven en el gemspec.
-
-- `:development, :test`: `rspec`, `pry`, `rubocop-rails-omakase`
-- `:test`: `activemodel`, `activesupport`, `excon` (re-declaradas para resolver en test sin runtime gemspec)
-
-### `Gemfile.lock`
-
-Lock generado por Bundler. Versionado. No editar a mano.
-
-## 3. Ruby / Lint
-
-### `.rubocop.yml`
-
-Base: `rubocop-rails-omakase`.
-
-- `TargetRubyVersion: 3.2`
-- Exclude: `bin/**/*`, `vendor/**/*`, `spec/fixtures/**/*`, `Gemfile`, `Gemfile.lock`, `docker-swarm.gemspec`
-- `Style/Documentation`: deshabilitado (ruido masivo; habilitar cuando YARD esté completo)
-- `Naming/MethodName`: excluido en `lib/docker_swarm/base.rb` y `lib/docker_swarm/models/**/*` (justificación: PascalCase fiel a Docker API)
-
-Sin `.ruby-version` en el repo. Ruby de runtime se infiere del gemspec (`>= 3.2.0`) y CI fija `3.4.4`.
-
-## 4. CI/CD
-
-### `.github/workflows/main.yml`
-
-Workflow `Ruby` — corre en `push` a `main` y en cada `pull_request`.
-
-- Runner: `ubuntu-latest`
-- Matrix Ruby: `['3.4.4']`
-- Steps: checkout (`actions/checkout@v6`, `persist-credentials: false`) → `ruby/setup-ruby@v1` con `bundler-cache: true` → `bundle exec rspec --tag ~type:integration` → `bundle exec rubocop`
-- Tests de integración (`type:integration`) excluidos en CI — requieren Docker Engine real, correr local.
-
-### `.github/workflows/release.yml`
-
-Workflow `Publish to RubyGems` — corre en push de tag `v*`.
-
-- Runner: `ubuntu-latest`
-- Permisos: `contents: read`, `packages: write`
-- Steps: checkout → setup Ruby 3.4.4 → `gem build *.gemspec` → `gem push *.gem`
-- Secret requerido: `RUBYGEMS_API_KEY`
-- Trigger manual: pushear tag `v<version>` (ver `/gem-release`).
-
-## 5. Dependencias automatizadas
-
-### `.github/dependabot.yml`
-
-Dos ecosistemas:
-
-- `bundler` (`/`): semanal, máx 10 PRs abiertos. Grupo `development-dependencies` agrupa `rubocop*`, `rspec*`, `pry*` en un sólo PR.
-- `github-actions` (`/`): mensual.
-
-## 6. Agentes / Skills
-
-### `skills.yml`
-
-Declara MCPs y skills externas a sincronizar.
-
-- MCPs: `github`, `clickup`
-- Skills (todas `repo: sequre/ai_knowledge` excepto donde se indique): `yard`, `quality-code`, `gem-release`, `dev-structure`, `dev-compose`, `dev-enrich`, `skill-feedback`, `agent-issue`, `dev-flow`, `matrix-element`, `documentation-writer` (`repo: github/awesome-copilot`, `path: skills/documentation-writer`)
-- `matrix-element` consume env `MATRIX_AUTH_TOKEN` + homeserver `https://matrix.cloud.wispro.co` + room `agents`.
-
-### `skills.lock`
-
-Lock de skills sincronizadas (`synced_at: 2026-04-07`). Todas con `scope: local` y path en `.agents/skills/`. Regenerable con `ruby .agents/skills/skill-manager/scripts/sync.rb`.
-
-### `.claude/settings.local.json`
-
-Permisos locales de Claude Code (no versionar credenciales acá). Allow:
-
-- `Bash(find /Users/gabriel/src/gems/docker-swarm/spec/integration -type f -name "*_spec.rb" -exec wc -l {} \\;)`
-- `Bash(grep "^[[:space:]]*class " /Users/gabriel/src/gems/docker-swarm/lib/docker_swarm/**/*.rb)`
-- `Bash(git rm *)`
-- `Bash(bundle exec *)`
-
-### `.claude/commands/*.md`
-
-Slash commands del proyecto. Cuatro archivos: `api.md`, `errors.md`, `orm.md`, `test.md`. Invocables como `/api`, `/errors`, `/orm`, `/test` desde Claude Code.
-
-## 7. Entorno local
-
-### `.env`
-
-**No versionado** (`.gitignore`). Variables ClickUp para reporting de agentes:
-
-- `AI_REPORTS_SPACE_ID`, `AI_REPORTS_BUG_REPORTS_LIST_ID`, `AI_REPORTS_IMPROVEMENTS_LIST_ID`
-- `AGENT_REVIEW_SAPCE_ID` (sic, typo), `AGENT_LIST_ID`, `AGENT_ACTION_PLAN_LIST_ID`
-
-### `.gitignore`
-
-Ignora: `.agents/` (skills sincronizadas, regenerables) y `.env` (variables de entorno).
-
-## 8. Tabla resumen
-
-| Archivo | Dominio | Consumidor | Versionado |
-|---|---|---|---|
-| `docker-swarm.gemspec` | Gema | Bundler / RubyGems | sí |
-| `Gemfile` | Gema | Bundler | sí |
-| `Gemfile.lock` | Gema | Bundler | sí |
-| `.rubocop.yml` | Lint | RuboCop | sí |
-| `.github/workflows/main.yml` | CI | GitHub Actions | sí |
-| `.github/workflows/release.yml` | CD | GitHub Actions | sí |
-| `.github/dependabot.yml` | Deps auto | GitHub Dependabot | sí |
-| `skills.yml` | Skills | `skill-manager` | sí |
-| `skills.lock` | Skills | `skill-manager` | sí |
-| `.claude/settings.local.json` | Agente | Claude Code | sí |
-| `.claude/commands/*.md` | Agente | Claude Code | sí |
-| `.env` | Entorno | runtime local | **no** |
-| `.gitignore` | VCS | git | sí |
-
-## 9. Secrets / credenciales
-
-- GitHub Actions: `RUBYGEMS_API_KEY` (release.yml)
-- Local `.env`: IDs ClickUp (no secretos pero específicos del workspace)
-- Skills `matrix-element`: `MATRIX_AUTH_TOKEN`
-
-Ninguna credencial hardcodeada en archivos versionados.