Skip to content

docs: corregir anclas stale y wording factual en artefactos - #23

Merged
gedera merged 1 commit into
masterfrom
docs/fix-stale-anchors-multivendor
Jul 1, 2026
Merged

docs: corregir anclas stale y wording factual en artefactos#23
gedera merged 1 commit into
masterfrom
docs/fix-stale-anchors-multivendor

Conversation

@gedera

@gedera gedera commented Jul 1, 2026

Copy link
Copy Markdown
Owner

Contexto

Sophia reportó cobertura 9/15 de artefactos. Verificado: las 6 capas "faltantes" son n/a legítimas (gema cliente HTTP sin DB/routes/eventos/tenancy), ya declaradas con motivo en AGENTS.md §8 y confirmadas por critias --full contra código real.

Sobre las 9 capas presentes se corrió síntesis multi-vendor (opencode + agy, --with-code). Filtrando el ruido de fragment-blindness contra código real + critias, quedaron defectos reales, todos doc-only.

Cambios (5 archivos)

Anclas stale (número de línea → símbolo correcto — clase que critias Categoría A no chequea):

  • consumed §c: TIMEOUT :20:24
  • glossary comercio/handshake: :84/:85:115/:116
  • glossary bindings codigo_de_barras (boleta.rb:28) y micrositio (micrositio.rb:7) completados

Wording factual:

  • config §6: "una sola env var" → dos (ENDPOINT_COBRODIGITAL, COBRODIGITAL_LOG_LEVEL)
  • security §auth: firma pública Operador#call(id_comercio, sid) (operador.rb:17) → Client#initialize#comercio (:116)
  • security §f: attr_accessor expone sid/request_xml → no-exposición es convención, no enforced
  • release §b: fuente del comentario Ruby 2.7 (release.yml:23-24, main.yml:21, gemspec:18-19; restricción dura gemspec:20)

Fidelidad fact→inferencia:

  • glossary handshake: propósito anti-replay marcado inferido (§3); mecanismo MD5 verificado (:116)
  • glossary meta: Meta.render solo agrega metodo_webservice; el handshake per-sub-op estaba solo en el comentario-ejemplo, no en código
  • release §b dueño: "posee credencial" → "se infiere que custodia"

Verificación

  • critias --full (repo completo): 0 errores, 6 n/a coherentes.
  • critias --pr (dos rondas): 0 errores, 0 warnings, anclas resuelven al símbolo correcto, envelope/meta/§/XREF intactos, sin anclaje stale nuevo.
  • Sin cambio de código ni de versión — refinamiento de fidelidad de la doc contra v1.9.0.

Diferido (no defecto, RFC-scope → skill-feedback): narrativa histórica en topology §e; etiquetado verified/inferred por-símbolo en interface (mejora cross-repo de RFC-004).

🤖 Generated with Claude Code

Hallazgos de síntesis multi-vendor (opencode+agy) verificados contra
código real y critias --pr:

Anclas stale (línea → símbolo correcto):
- consumed §c: TIMEOUT :20 → :24
- glossary comercio/handshake: :84/:85 → :115/:116
- glossary bindings codigo_de_barras (boleta.rb:28) y micrositio
  (micrositio.rb:7) completados con file:line

Wording factual:
- config §6: "una sola env var" → dos (ENDPOINT_COBRODIGITAL,
  COBRODIGITAL_LOG_LEVEL)
- security §auth: firma pública Operador#call(id_comercio, sid)
  (operador.rb:17) → Client#initialize → #comercio (:116)
- security §f: attr_accessor expone sid/request_xml → no-exposición es
  convención (comentario), no enforced
- release §b: fuente del comentario Ruby 2.7 (release.yml:23-24,
  main.yml:21, gemspec:18-19; restricción dura gemspec:20)

Fidelidad fact→inferencia:
- glossary handshake: propósito anti-replay marcado inferido (§3);
  mecanismo MD5 sigue verificado (:116)
- glossary meta: Meta.render solo agrega metodo_webservice; handshake
  per-sub-op estaba solo en el comentario-ejemplo, no en código
- release §b dueño: "posee credencial" → "se infiere que custodia"

critias --pr: 0 errores, 0 warnings, sin anclaje stale nuevo.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@gedera
gedera merged commit 759e19c into master Jul 1, 2026
1 check passed
@gedera
gedera deleted the docs/fix-stale-anchors-multivendor branch July 1, 2026 14:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant