Skip to content

Say in the schema what a verified date records - #66

Merged
haruotsu merged 1 commit into
mainfrom
describe-verified-in-the-connection-schema
Sep 9, 2026
Merged

Say in the schema what a verified date records#66
haruotsu merged 1 commit into
mainfrom
describe-verified-in-the-connection-schema

Conversation

@haruotsu

@haruotsu haruotsu commented Sep 9, 2026

Copy link
Copy Markdown
Collaborator

verified was the one field in the connection schema with no description,
and it is the field that most needs one: every other key changes what gete
does, while this one changes nothing at all. Nothing reads it beyond
gete connections, which prints the date or not verified in Gemini Enterprise.

So a reader meeting verified: {gemini_enterprise: 2026-08-27} in a catalog
entry has nothing to tell them how much of the flow that date stands for, or
that no check is being made against it.

"verified": {
  "description": "Where an authorization through this connection has been taken end to end and seen to work. Nothing follows from it: gete checks nothing against it and behaves no differently, but `gete connections` prints it, so a reader can tell what was observed from what a provider's metadata merely promises.",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "gemini_enterprise": {
      "description": "The date an authorization was taken through Gemini Enterprise: consent screen, code exchange, and the token used against the service. Absent until one has been.",
      "type": "string",
      "format": "date"
    }
  }
}

The date's meaning is the part worth pinning down: consent screen, code
exchange, and the token used against the service. That is what the entries
carrying one were held to, and stating it keeps a later entry from claiming
the word for less.

Text only - the accepted shape is unchanged, and a document that validated
before validates now. Other properties in this schema and the others are
still undescribed; they are left for whoever needs them.

tests

tests/test_schema.py: the connection schema is expected to describe
verified and the date under it. Written first, red, then the schema.

Every other field in a connection changes what gete does; verified changes
nothing. It is a record of an authorization someone took end to end, and a
reader who meets it has no way to tell that from a field that is checked,
or to know how much of the flow the date stands for.

The schema is the only place that can say so, since nothing at runtime
reads the field beyond printing it.

🤖 Generated with Claude Code
@haruotsu
haruotsu merged commit ec4d3ed into main Sep 9, 2026
3 checks passed
@haruotsu
haruotsu deleted the describe-verified-in-the-connection-schema branch September 9, 2026 10:30
@github-actions github-actions Bot mentioned this pull request Sep 9, 2026
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