Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

verification.md: format-versioning and verifier-compatibility obligations (evidence outlives verifiers)

Abierto
#116 9 comentarios 0 reacciones 1 asignado Ver en GitHub

Los mantenedores suelen responder en 1 día

@lywinged ya está trabajando en esto.

Desde el 7/9/2026.

Evaluación

Este issue todavía no se ha evaluado.

Descripción

policy: take-internal

Spec gap. Compliance evidence is verified years after issuance — the artifact routinely outlives the verifier build — and the profile/enum surface is already evolving pre-1.0 (#114 proposes a new profile URI precisely to avoid breaking existing verifiers). But verification.md currently has no normative statement of what a verifier must do about version skew. Without one, every future revision risks silently orphaning existing evidence — or worse, verifiers "helpfully" accepting artifacts under semantics they don't actually implement.

Production context: in our per-action receipt format the hash-computation order is load-bearing — any change orphans every previously issued artifact. What held up operationally: a mandatory format-version field, plus a verifier obligated to check every version it claims to support and to say which version it verified under in its output.

Proposed obligations for verification.md:

  1. Every record/receipt carries an explicit format/profile version (the profile-URI direction in #114 already implies this — this makes it a verifier obligation, not just an emitter convention).
  2. A conformant verifier declares the set of versions it supports and MUST refuse versions outside that set — refuse, not best-effort.
  3. The verification statement includes the version under which verification ran.
  4. Any downgrade/fallback behavior MUST be disclosed in the statement; silent fallback is non-conformant.

Conformance vectors for trace-tests:

  • unknown-version artifact → must refuse (fail-open here is the dangerous default)
  • known-version artifact → verified under correct semantics, version echoed in the statement
  • downgrade-with-disclosure → conformant
  • silent downgrade → must fail conformance

Happy to draft the section plus the vectors — this composes with the verifier-obligations ADR discussed in #66 and the offline verification statement discussed in #76.

Lenguaje dominante
Python
Estrellas
37
Forks
33
Merge medio
1 d 4 h
PR fusionados (30 d)
122

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de agentrust-io/trace-spec

Todos los issues de agentrust-io/trace-spec

Issues similares

Más issues de Python

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.