Skip to content

chore(okf): corre el vigía del estándar, que llevaba 46 días sin mirar - #658

Merged
beyondnetPeru merged 1 commit into
mainfrom
chore/okf-standard-watch-refresh
Aug 23, 2026
Merged

chore(okf): corre el vigía del estándar, que llevaba 46 días sin mirar#658
beyondnetPeru merged 1 commit into
mainfrom
chore/okf-standard-watch-refresh

Conversation

@beyondnetPeru

Copy link
Copy Markdown
Contributor

Pull Request Summary

El pre-commit avisaba en cada commit:

⚠️  [OKF] Vigía del estándar STALE (46 d > 30 d). Corre: node .harness/scripts/knowledge-okf-standard-watch.mjs

El vigía es la contraparte con red del guard offline: baja el SPEC.md pineado, compara su hash contra el lock y refresca checkedAt; el hook lee ese lock sin red y avisa cuando pasa de 30 días. Correrlo apaga el aviso — y el guard offline ya sale limpio (exit 0, sin salida).

El aviso tapaba algo más grande

Por eso este PR no lo sella:

locked b9655e60… — v0.1, revisado el 2026-07-08
upstream 26aa5da0… — el SPEC declara ahora Version 0.2

El vigía sale con exit 10 ("cambió upstream y no ha sido reconocido"). Aquí solo se mueve checkedAt; sha256 y reviewedAt se quedan como estaban, que es exactamente la señal de "mirado, no reconocido".

Hacer --accept habría puesto todo verde afirmando que alguien revisó un salto de versión que nadie ha revisado — el mismo falso verde que este guard existe para evitar.

Lo que queda por decidir (revisión real, no un sello)

La proyección del ADR-0105 apunta al contrato OKF v0.1 y el upstream va por v0.2. knowledge-okf-project.mjs no parsea el SPEC en runtime — solo lo cita en un comentario — así que el cambio no rompe nada mecánicamente; es una pregunta de conformidad. El SPEC no trae sección de changelog, de modo que hay que diffear sus 61 secciones a mano contra lo que proyectamos.

Cuando esa revisión se haga, se cierra con:

node .harness/scripts/knowledge-okf-standard-watch.mjs --accept

Verificación

knowledge-okf-precommit-guard.mjs pasa de emitir el aviso STALE a exit 0 en silencio. Confirmado en la salida del hook de este mismo commit, donde el aviso ya no aparece.

Before you submit

  • Sign-off (DCO): my commits carry a Signed-off-by line.
  • Conventional Commits: my PR title and commits follow Conventional Commits.
  • Agnosticism: no introduce ninguna dependencia tecnológica — es un lockfile de un vigía ya existente.
  • Bilingual: no aplica — no toqué ninguno de los dieciséis documentos de la superficie de entrada.

Linked ADRs / Issues

  • Link to ADR: ADR-0105 — la proyección OKF cuyo contrato queda ahora una versión por detrás del upstream.
  • Link to Issue: n/a

🤖 Generated with Claude Code

El pre-commit avisaba `[OKF] Vigia del estandar STALE (46 d > 30 d)` en cada
commit. El vigia es la contraparte con red del guard offline: baja el SPEC.md
pineado, compara su hash contra el lock y refresca `checkedAt`; el hook lee ese
lock sin red y avisa cuando pasa de 30 dias. Correrlo apaga el aviso, y el guard
offline ya sale limpio (exit 0, sin salida).

Pero el aviso tapaba algo mas grande, y por eso este commit NO lo sella:

  locked:    b9655e60...  (v0.1, revisado el 2026-07-08)
  upstream:  26aa5da0...  -> el SPEC declara ahora **Version 0.2**

El vigia sale con exit 10 ("cambio upstream y no ha sido reconocido"). Aqui solo
se mueve `checkedAt`; `sha256` y `reviewedAt` se quedan como estaban, que es
justo la senal de "mirado, no reconocido". Hacer `--accept` habria puesto todo
verde afirmando que alguien reviso un salto de version que nadie ha revisado —
el mismo falso verde que este guard existe para evitar.

Lo que queda por decidir (revision real, no un sello): la proyeccion del ADR-0105
apunta al contrato OKF v0.1 y el upstream va por v0.2. `knowledge-okf-project.mjs`
no parsea el SPEC en runtime — solo lo cita — asi que el cambio no rompe nada
mecanicamente; es una pregunta de conformidad. El SPEC no trae changelog, de modo
que hay que diffear las 61 secciones a mano contra lo que proyectamos.

Verificacion: `knowledge-okf-precommit-guard.mjs` pasa de emitir el aviso STALE a
exit 0 en silencio.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Signed-off-by: aarroyo <beyondnet.peru@gmail.com>
@beyondnetPeru
beyondnetPeru requested a review from a team as a code owner August 23, 2026 01:23
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@github-actions

Copy link
Copy Markdown

📊 Bilingual Coverage Impact

PR Changes

  • Paired EN/ES files modified: 0
  • New EN files needing ES translation: 0

Repository Coverage

Metric Value
Total EN files 527
Total ES files 497
Paired files 0
Coverage 0%

Good: All EN changes have ES counterparts.


Generated by GitHub Actions

@beyondnetPeru
beyondnetPeru merged commit 83af1bf into main Aug 23, 2026
35 checks passed
@beyondnetPeru
beyondnetPeru deleted the chore/okf-standard-watch-refresh branch August 23, 2026 01:33
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