From 2bae854eca7e5553fb9f3f780e5041696c8d967f Mon Sep 17 00:00:00 2001
From: haruotsu <65439874+haruotsu@users.noreply.github.com>
Date: Wed, 9 Sep 2026 18:39:00 +0900
Subject: [PATCH] Say in the schema what a verified date records
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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
---
 src/gete/schema/connection.json |  2 ++
 tests/test_schema.py            | 11 ++++++++++-
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/src/gete/schema/connection.json b/src/gete/schema/connection.json
index 11d34a9..6f1a668 100644
--- a/src/gete/schema/connection.json
+++ b/src/gete/schema/connection.json
@@ -150,10 +150,12 @@
       "minLength": 1
     },
     "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"
         }
diff --git a/tests/test_schema.py b/tests/test_schema.py
index 3ef5bff..1e637f7 100644
--- a/tests/test_schema.py
+++ b/tests/test_schema.py
@@ -7,7 +7,7 @@
 
 from gete.declaration import read_yaml
 from gete.errors import DeclarationError
-from gete.schema import validate_document
+from gete.schema import load_schema, validate_document
 
 GETE: dict[str, Any] = {
     "version": 1,
@@ -423,6 +423,15 @@ def test_connection_rejects_wildcards_plain_http_and_empty_scope_text(
         validate_document("connection", {**CONNECTION, **patch}, source="c.yaml")
 
 
+def test_the_schema_says_what_a_verified_date_records_and_what_follows() -> None:
+    """No behaviour follows from the field, so a reader who meets it has only
+    the schema to learn from: what the date stands for, and that gete does
+    nothing with it."""
+    verified = load_schema("connection")["properties"]["verified"]
+    assert "description" in verified
+    assert "description" in verified["properties"]["gemini_enterprise"]
+
+
 def test_connection_messages_declare_the_reauthorization_text() -> None:
     """The prompt is for end users; empty text would show them nothing."""
     validate_document(