feat(okf): el corpus firma su procedencia como autorado por humano

[beyondnetPeru]

Pull Request Summary

Un consumidor OKF v0.2 que leía nuestro bundle no encontraba generated, así que caía al timestamp legado (§13.1) — una fecha sin ninguna procedencia. Nuestro corpus se autora a mano en canonical/*.yaml, pero el bundle no lo decía: no había forma de distinguirlo de uno escupido por una máquina.

Los 10 conceptos proyectados pasan a firmar:

generated:
  by: human:@winston

Dos decisiones, ambas con razón

human: y no process:

§7 avisa de que los consumidores que clasifican confianza (§5.3) se apoyan en ese prefijo, y obliga a los productores a usarlo para contenido autorado o confirmado por humanos. El proyector transcribe el corpus, no lo escribe; firmar con el script degradaría el corpus a "generado por máquina" ante cualquier consumidor v0.2 — justo lo contrario de lo que es.

at se omite, y conviene que siga omitido

§5.2 lo define como "the content's last meaningful change" y solo marca by como REQUIRED, así que omitirlo es conforme. Las dos fuentes posibles no sirven:

• asOf es la fecha de proyección. Emitirla haría que cada re-proyección afirme que todo el corpus acaba de cambiar — lo contrario del uso que §5.2 le da al campo ("tell a recent edit from a stale fact").
• La fecha del commit del fichero canónico sería la correcta, pero es inalcanzable: el bundle se commitea en el mismo commit que el cambio canónico y lo gatea --verify, así que at necesitaría la fecha de un commit que aún no existe al generar. Cualquier edición canónica dejaría el gate en rojo.

Un dato ausente es conforme; uno inventado engaña al consumidor. Hay un test que fija la ausencia de at para que no se cuele más adelante.

Lo que NO cambia

El bundle sigue siendo v0.1-conforme: v0.1 tolera claves extra, y el §11 de v0.2 exige las mismas tres reglas (frontmatter parseable, type no vacío, reservados) que ya cumplíamos. Por eso no se toca la versión declarada ni el ADR-0105 — eso sería otra decisión, no un efecto colateral de esta.

El validador gana dientes

Si generated está presente, generated.by es REQUERIDO (§5.2) y debe seguir la convención de actor (§7). Sin eso el campo podría emitirse a medias y un consumidor lo clasificaría mal en silencio, que es peor que no emitirlo.

Verificación

• El diff del bundle son exactamente 10 adiciones de generated, nada más (auditado línea a línea).
• --check: 0 violaciones · --verify: al día — corrido como en CI, sin --as-of (la línea 527 reproduce con el as-of del log.md publicado, así que el diff es determinista).
• guard CI 38-validate-okf-projection: exit 0 · guard pre-commit: exit 0.
• Tests del proyector: 14 → 17, incluidos el actor, la ausencia de at, y el rechazo de generated sin by o con actor no convencional.

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.
• Bilingual: no aplica — no toqué ninguno de los dieciséis documentos de la superficie de entrada.

Linked ADRs / Issues

• Link to ADR: ADR-0105 — sus afirmaciones de v0.1 siguen siendo exactas; esta es la mejora opcional que dejó abierta chore(okf): revisa OKF v0.2 y reconoce el hash; el proyector no cambia #659.
• Link to Issue: n/a

🤖 Generated with Claude Code

[chatgpt-codex-connector]

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

[github-actions]

📊 Bilingual Coverage Impact

PR Changes

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

Repository Coverage

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

⚠️ Action required: 10 new EN file(s) added without ES counterparts.

To create skeletons:

node .harness/scripts/generate-es-skeleton.mjs <file.md>

---

Generated by GitHub Actions