@gmickel/gno 2.3.2 → 2.4.0

package/spec/output-schemas/context-capsule-v1.schema.json

@@ -27,7 +27,11 @@
   "allOf": [
     {
       "if": {
-        "properties": { "schemaVersion": { "const": "1.1" } },
+        "properties": {
+          "schemaVersion": {
+            "enum": ["1.1", "1.2"]
+          }
+        },
         "required": ["schemaVersion"]
       },
       "then": {
@@ -38,7 +42,9 @@
             "type": "array",
             "items": {
               "allOf": [
-                { "$ref": "#/definitions/evidence" },
+                {
+                  "$ref": "#/definitions/evidence"
+                },
                 {
                   "type": "object",
                   "required": ["egressLineage"],
@@ -66,7 +72,9 @@
             "type": "array",
             "items": {
               "allOf": [
-                { "$ref": "#/definitions/evidence" },
+                {
+                  "$ref": "#/definitions/evidence"
+                },
                 {
                   "not": {
                     "type": "object",
@@ -140,10 +148,93 @@
           }
         }
       }
+    },
+    {
+      "if": {
+        "properties": {
+          "schemaVersion": {
+            "const": "1.2"
+          }
+        },
+        "required": ["schemaVersion"]
+      },
+      "then": {
+        "properties": {
+          "scope": {
+            "type": "object",
+            "required": ["filter"],
+            "properties": {
+              "filter": {}
+            }
+          },
+          "retrieval": {
+            "type": "object",
+            "properties": {
+              "request": {
+                "type": "object",
+                "required": ["filter"],
+                "properties": {
+                  "filter": {}
+                }
+              }
+            }
+          }
+        }
+      },
+      "else": {
+        "properties": {
+          "warnings": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "code": {
+                  "enum": [
+                    "incomplete_coverage",
+                    "omissions_truncated",
+                    "token_estimate_used"
+                  ]
+                }
+              }
+            }
+          },
+          "scope": {
+            "type": "object",
+            "not": {
+              "required": ["filter"],
+              "properties": {
+                "filter": {}
+              }
+            },
+            "properties": {
+              "filter": {}
+            }
+          },
+          "retrieval": {
+            "type": "object",
+            "properties": {
+              "request": {
+                "type": "object",
+                "not": {
+                  "required": ["filter"],
+                  "properties": {
+                    "filter": {}
+                  }
+                },
+                "properties": {
+                  "filter": {}
+                }
+              }
+            }
+          }
+        }
+      }
     }
   ],
   "properties": {
-    "schemaVersion": { "enum": ["1.0", "1.1"] },
+    "schemaVersion": {
+      "enum": ["1.0", "1.1", "1.2"]
+    },
     "coordinateSpace": { "const": "canonical_mirror" },
     "capsuleId": { "$ref": "#/definitions/sha256" },
     "egressLineage": { "$ref": "#/definitions/egressLineage" },
@@ -171,15 +262,22 @@
         },
         "uriPrefix": {
           "oneOf": [
-            { "$ref": "#/definitions/gnoPrefixUri" },
-            { "type": "null" }
+            {
+              "$ref": "#/definitions/gnoPrefixUri"
+            },
+            {
+              "type": "null"
+            }
           ]
         },
         "tagsAll": { "$ref": "#/definitions/filterValues" },
         "tagsAny": { "$ref": "#/definitions/filterValues" },
         "categories": { "$ref": "#/definitions/filterValues" },
         "since": { "$ref": "#/definitions/nullableDate" },
-        "until": { "$ref": "#/definitions/nullableDate" }
+        "until": { "$ref": "#/definitions/nullableDate" },
+        "filter": {
+          "$ref": "gno://schemas/metadata-predicate@1.0"
+        }
       }
     },
     "budget": {
@@ -223,7 +321,9 @@
         "indexSnapshot"
       ],
       "properties": {
-        "depthPolicy": { "enum": ["fast", "balanced", "thorough"] },
+        "depthPolicy": {
+          "enum": ["fast", "balanced", "thorough"]
+        },
         "facets": { "$ref": "#/definitions/facets" },
         "queryVariants": {
           "type": "array",
@@ -246,20 +346,38 @@
           "properties": {
             "author": {
               "oneOf": [
-                { "type": "string", "minLength": 1, "maxLength": 256 },
-                { "type": "null" }
+                {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 256
+                },
+                {
+                  "type": "null"
+                }
               ]
             },
             "lang": {
               "oneOf": [
-                { "type": "string", "minLength": 1, "maxLength": 64 },
-                { "type": "null" }
+                {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 64
+                },
+                {
+                  "type": "null"
+                }
               ]
             },
             "intent": {
               "oneOf": [
-                { "type": "string", "minLength": 1, "maxLength": 16384 },
-                { "type": "null" }
+                {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 16384
+                },
+                {
+                  "type": "null"
+                }
               ]
             },
             "exclude": {
@@ -269,8 +387,14 @@
             },
             "minScore": {
               "oneOf": [
-                { "type": "number", "minimum": 0, "maximum": 1 },
-                { "type": "null" }
+                {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 1
+                },
+                {
+                  "type": "null"
+                }
               ]
             },
             "queryModes": {
@@ -281,7 +405,10 @@
             "limit": { "type": "integer", "minimum": 1 },
             "candidateLimit": { "type": "integer", "minimum": 1 },
             "graphRequested": { "type": "boolean" },
-            "rerankRequested": { "type": "boolean" }
+            "rerankRequested": { "type": "boolean" },
+            "filter": {
+              "$ref": "gno://schemas/metadata-predicate@1.0"
+            }
           }
         },
         "capabilityStates": {
@@ -382,7 +509,8 @@
             "enum": [
               "incomplete_coverage",
               "omissions_truncated",
-              "token_estimate_used"
+              "token_estimate_used",
+              "metadata_coverage_incomplete"
             ]
           }
         }
@@ -414,7 +542,9 @@
           "minimum": 0,
           "maximum": 9007199254740991
         },
-        "disposition": { "enum": ["inline", "attachment"] },
+        "disposition": {
+          "enum": ["inline", "attachment"]
+        },
         "sha256": { "$ref": "#/definitions/sha256" }
       }
     },
@@ -484,10 +614,25 @@
     },
     "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
     "nullableSha256": {
-      "oneOf": [{ "$ref": "#/definitions/sha256" }, { "type": "null" }]
+      "oneOf": [
+        {
+          "$ref": "#/definitions/sha256"
+        },
+        {
+          "type": "null"
+        }
+      ]
     },
     "nullableDate": {
-      "oneOf": [{ "type": "string", "format": "date-time" }, { "type": "null" }]
+      "oneOf": [
+        {
+          "type": "string",
+          "format": "date-time"
+        },
+        {
+          "type": "null"
+        }
+      ]
     },
     "gnoUri": {
       "type": "string",
@@ -511,7 +656,9 @@
       "additionalProperties": false,
       "required": ["effectivePolicy", "digest", "sources"],
       "properties": {
-        "effectivePolicy": { "enum": ["local_only", "lan", "remote"] },
+        "effectivePolicy": {
+          "enum": ["local_only", "lan", "remote"]
+        },
         "digest": { "$ref": "#/definitions/sha256" },
         "sources": {
           "type": "array",
@@ -523,7 +670,9 @@
             "required": ["collection", "policy", "source"],
             "properties": {
               "collection": { "$ref": "#/definitions/collection" },
-              "policy": { "enum": ["local_only", "lan", "remote"] },
+              "policy": {
+                "enum": ["local_only", "lan", "remote"]
+              },
               "source": {
                 "enum": ["explicit", "config_default", "legacy_default"]
               }
@@ -547,7 +696,9 @@
       "additionalProperties": false,
       "required": ["mode", "text"],
       "properties": {
-        "mode": { "enum": ["term", "intent", "hyde"] },
+        "mode": {
+          "enum": ["term", "intent", "hyde"]
+        },
         "text": { "type": "string", "minLength": 1, "maxLength": 4096 }
       }
     },
@@ -649,7 +800,9 @@
       "required": ["contextId", "scopeType", "scopeKey", "text"],
       "properties": {
         "contextId": { "$ref": "#/definitions/sha256" },
-        "scopeType": { "enum": ["global", "collection", "prefix"] },
+        "scopeType": {
+          "enum": ["global", "collection", "prefix"]
+        },
         "scopeKey": { "type": "string", "minLength": 1, "maxLength": 2048 },
         "text": { "type": "string", "minLength": 1, "maxLength": 16384 }
       },
@@ -710,8 +863,14 @@
         "uri": { "$ref": "#/definitions/gnoUri" },
         "docid": { "$ref": "#/definitions/docid" },
         "collection": { "$ref": "#/definitions/collection" },
-        "title": { "type": ["string", "null"], "maxLength": 2048 },
-        "heading": { "type": ["string", "null"], "maxLength": 2048 },
+        "title": {
+          "type": ["string", "null"],
+          "maxLength": 2048
+        },
+        "heading": {
+          "type": ["string", "null"],
+          "maxLength": 2048
+        },
         "startLine": { "type": "integer", "minimum": 1 },
         "endLine": { "type": "integer", "minimum": 1 },
         "text": { "type": "string", "minLength": 1 },
@@ -721,9 +880,17 @@
         "modifiedAt": { "$ref": "#/definitions/nullableDate" },
         "documentDate": {
           "oneOf": [
-            { "type": "string", "format": "date" },
-            { "type": "string", "format": "date-time" },
-            { "type": "null" }
+            {
+              "type": "string",
+              "format": "date"
+            },
+            {
+              "type": "string",
+              "format": "date-time"
+            },
+            {
+              "type": "null"
+            }
           ]
         },
         "observedAt": { "$ref": "#/definitions/nullableDate" },
@@ -832,8 +999,14 @@
         "candidateId": { "$ref": "#/definitions/sha256" },
         "uri": { "$ref": "#/definitions/gnoUri" },
         "docid": { "$ref": "#/definitions/docid" },
-        "startLine": { "type": ["integer", "null"], "minimum": 1 },
-        "endLine": { "type": ["integer", "null"], "minimum": 1 },
+        "startLine": {
+          "type": ["integer", "null"],
+          "minimum": 1
+        },
+        "endLine": {
+          "type": ["integer", "null"],
+          "minimum": 1
+        },
         "passageHash": { "$ref": "#/definitions/nullableSha256" },
         "sourceHash": { "$ref": "#/definitions/sha256" },
         "mirrorHash": { "$ref": "#/definitions/sha256" },

package/spec/output-schemas/context-capsule-verification.schema.json

@@ -21,20 +21,28 @@
     "evidence"
   ],
   "properties": {
-    "schemaVersion": { "enum": ["1.0", "1.1"] },
+    "schemaVersion": {
+      "enum": ["1.0", "1.1", "1.2"]
+    },
     "coordinateSpace": { "const": "canonical_mirror" },
     "capsuleId": { "$ref": "#/definitions/sha256" },
     "operationStatus": { "const": "completed" },
-    "contentStatus": { "enum": ["unchanged", "stale", "missing"] },
+    "contentStatus": {
+      "enum": ["unchanged", "stale", "missing"]
+    },
     "contentCode": {
       "enum": ["verified_unchanged", "content_stale", "content_missing"]
     },
-    "rankingStatus": { "enum": ["unchanged", "reranked", "unavailable"] },
+    "rankingStatus": {
+      "enum": ["unchanged", "reranked", "unavailable"]
+    },
     "rankingCode": {
       "enum": ["ranking_unchanged", "ranking_changed", "ranking_unavailable"]
     },
     "currentFingerprints": { "$ref": "#/definitions/currentFingerprints" },
-    "fingerprintStatus": { "enum": ["unchanged", "drifted"] },
+    "fingerprintStatus": {
+      "enum": ["unchanged", "drifted"]
+    },
     "fingerprintReasons": {
       "oneOf": [
         {
@@ -1111,7 +1119,9 @@
     {
       "if": { "properties": { "rankingStatus": { "const": "unavailable" } } },
       "then": {
-        "properties": { "rankingCode": { "const": "ranking_unavailable" } }
+        "properties": {
+          "rankingCode": { "const": "ranking_unavailable" }
+        }
       }
     },
     {
@@ -1134,7 +1144,14 @@
   "definitions": {
     "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
     "nullableSha256": {
-      "oneOf": [{ "$ref": "#/definitions/sha256" }, { "type": "null" }]
+      "oneOf": [
+        {
+          "$ref": "#/definitions/sha256"
+        },
+        {
+          "type": "null"
+        }
+      ]
     },
     "currentFingerprints": {
       "type": "object",
@@ -1199,7 +1216,9 @@
       "properties": {
         "evidenceId": { "$ref": "#/definitions/sha256" },
         "uri": { "$ref": "#/definitions/gnoUri" },
-        "contentStatus": { "enum": ["unchanged", "stale", "missing"] },
+        "contentStatus": {
+          "enum": ["unchanged", "stale", "missing"]
+        },
         "contentCode": {
           "enum": [
             "verified_unchanged",
@@ -1213,7 +1232,9 @@
             "mirror_missing"
           ]
         },
-        "rankingStatus": { "enum": ["unchanged", "reranked", "unavailable"] },
+        "rankingStatus": {
+          "enum": ["unchanged", "reranked", "unavailable"]
+        },
         "rankingCode": {
           "enum": [
             "ranking_unchanged",
@@ -1268,7 +1289,9 @@
           "if": { "properties": { "contentStatus": { "const": "missing" } } },
           "then": {
             "properties": {
-              "contentCode": { "enum": ["source_missing", "mirror_missing"] },
+              "contentCode": {
+                "enum": ["source_missing", "mirror_missing"]
+              },
               "rankingStatus": { "const": "unavailable" },
               "rankingCode": { "const": "ranking_unavailable" },
               "currentRetrievalRank": { "type": "null" }

package/spec/output-schemas/evidence-fixtures.schema.json

@@ -0,0 +1,176 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "const": "gno-evidence-fixtures-v1"
+    },
+    "documents": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/__schema0"
+      }
+    },
+    "spans": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/__schema3"
+      }
+    },
+    "cases": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/__schema4"
+      }
+    }
+  },
+  "required": ["schemaVersion", "documents", "spans", "cases"],
+  "additionalProperties": false,
+  "definitions": {
+    "__schema0": {
+      "type": "object",
+      "properties": {
+        "uri": {
+          "$ref": "#/definitions/__schema1"
+        },
+        "title": {
+          "$ref": "#/definitions/__schema1"
+        },
+        "content": {
+          "$ref": "#/definitions/__schema1"
+        },
+        "sourceHash": {
+          "$ref": "#/definitions/__schema2"
+        }
+      },
+      "required": ["uri", "title", "content", "sourceHash"],
+      "additionalProperties": false
+    },
+    "__schema1": {
+      "type": "string",
+      "minLength": 1
+    },
+    "__schema2": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "__schema3": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "#/definitions/__schema1"
+        },
+        "uri": {
+          "$ref": "#/definitions/__schema1"
+        },
+        "sourceHash": {
+          "$ref": "#/definitions/__schema2"
+        },
+        "startLine": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        },
+        "endLine": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        },
+        "spanHash": {
+          "$ref": "#/definitions/__schema2"
+        }
+      },
+      "required": [
+        "id",
+        "uri",
+        "sourceHash",
+        "startLine",
+        "endLine",
+        "spanHash"
+      ],
+      "additionalProperties": false
+    },
+    "__schema4": {
+      "type": "object",
+      "properties": {
+        "caseId": {
+          "$ref": "#/definitions/__schema1"
+        },
+        "family": {
+          "$ref": "#/definitions/__schema1"
+        },
+        "query": {
+          "$ref": "#/definitions/__schema1"
+        },
+        "intent": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/__schema1"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "collection": {
+          "$ref": "#/definitions/__schema1"
+        },
+        "tokenBudget": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        },
+        "byteBudget": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        },
+        "requiredSets": {
+          "type": "array",
+          "items": {
+            "minItems": 1,
+            "type": "array",
+            "items": {
+              "$ref": "#/definitions/__schema1"
+            }
+          }
+        },
+        "expectAbstention": {
+          "type": "boolean"
+        },
+        "expectedValues": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/__schema1"
+          }
+        },
+        "mustCover": {
+          "type": "boolean"
+        },
+        "split": {
+          "type": "string",
+          "enum": ["development", "held-out"]
+        }
+      },
+      "required": [
+        "caseId",
+        "family",
+        "query",
+        "intent",
+        "collection",
+        "tokenBudget",
+        "byteBudget",
+        "requiredSets",
+        "expectAbstention",
+        "expectedValues",
+        "mustCover",
+        "split"
+      ],
+      "additionalProperties": false
+    }
+  }
+}