@gmickel/gno 1.18.0 → 1.20.0

package/spec/output-schemas/bench-result.schema.json

@@ -0,0 +1,120 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "GNO Bench Result",
+  "type": "object",
+  "required": ["fixture", "generatedAt", "modes", "meta"],
+  "additionalProperties": false,
+  "properties": {
+    "fixture": {
+      "type": "object",
+      "required": ["path", "version", "queryCount", "topK"],
+      "additionalProperties": false,
+      "properties": {
+        "path": { "type": "string", "minLength": 1 },
+        "name": { "type": "string" },
+        "version": { "const": 1 },
+        "queryCount": { "type": "integer", "minimum": 1 },
+        "topK": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "modes": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": [
+          "name",
+          "type",
+          "status",
+          "queryCount",
+          "failures",
+          "metrics",
+          "latency",
+          "cases"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "name": { "type": "string", "minLength": 1 },
+          "type": { "type": "string", "enum": ["bm25", "vector", "hybrid"] },
+          "status": { "type": "string", "enum": ["ok", "failed"] },
+          "queryCount": { "type": "integer", "minimum": 1 },
+          "failures": { "type": "integer", "minimum": 0 },
+          "metrics": { "$ref": "#/definitions/metrics" },
+          "latency": { "$ref": "#/definitions/latency" },
+          "cases": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "required": [
+                "id",
+                "query",
+                "topK",
+                "expected",
+                "hits",
+                "topDocs",
+                "metrics",
+                "latencyMs"
+              ],
+              "additionalProperties": false,
+              "properties": {
+                "id": { "type": "string", "minLength": 1 },
+                "query": { "type": "string", "minLength": 1 },
+                "topK": { "type": "integer", "minimum": 1 },
+                "expected": {
+                  "type": "array",
+                  "items": { "type": "string", "minLength": 1 }
+                },
+                "hits": {
+                  "type": "array",
+                  "items": { "type": "string", "minLength": 1 }
+                },
+                "topDocs": {
+                  "type": "array",
+                  "items": { "type": "string", "minLength": 1 }
+                },
+                "metrics": { "$ref": "#/definitions/metrics" },
+                "latencyMs": { "type": "number", "minimum": 0 },
+                "error": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "meta": {
+      "type": "object",
+      "required": ["indexName"],
+      "additionalProperties": false,
+      "properties": {
+        "indexName": { "type": "string", "minLength": 1 },
+        "collection": { "type": "string", "minLength": 1 }
+      }
+    }
+  },
+  "definitions": {
+    "metrics": {
+      "type": "object",
+      "required": ["precisionAtK", "recallAtK", "f1AtK", "mrr", "ndcgAtK"],
+      "additionalProperties": false,
+      "properties": {
+        "precisionAtK": { "type": "number", "minimum": 0, "maximum": 1 },
+        "recallAtK": { "type": "number", "minimum": 0, "maximum": 1 },
+        "f1AtK": { "type": "number", "minimum": 0, "maximum": 1 },
+        "mrr": { "type": "number", "minimum": 0, "maximum": 1 },
+        "ndcgAtK": { "type": "number", "minimum": 0, "maximum": 1 }
+      }
+    },
+    "latency": {
+      "type": "object",
+      "required": ["p50Ms", "p95Ms", "meanMs"],
+      "additionalProperties": false,
+      "properties": {
+        "p50Ms": { "type": "number", "minimum": 0 },
+        "p95Ms": { "type": "number", "minimum": 0 },
+        "meanMs": { "type": "number", "minimum": 0 }
+      }
+    }
+  }
+}

package/spec/output-schemas/capture-receipt.schema.json

@@ -0,0 +1,143 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/capture-receipt@1.0",
+  "title": "GNO Capture Receipt",
+  "description": "Shared receipt returned by capture surfaces after a write/open decision.",
+  "type": "object",
+  "required": [
+    "uri",
+    "collection",
+    "relPath",
+    "created",
+    "openedExisting",
+    "createdWithSuffix",
+    "contentHash",
+    "source",
+    "tags",
+    "sync",
+    "embed",
+    "collisionPolicyResult"
+  ],
+  "properties": {
+    "uri": {
+      "type": "string",
+      "description": "GNO URI for the captured note.",
+      "pattern": "^gno://[^/]+/.+"
+    },
+    "docid": {
+      "type": "string",
+      "description": "Document id when sync has resolved it."
+    },
+    "collection": {
+      "type": "string",
+      "description": "Target collection name."
+    },
+    "relPath": {
+      "type": "string",
+      "description": "Relative path within the collection."
+    },
+    "absPath": {
+      "type": "string",
+      "description": "Absolute path when the local surface exposes it."
+    },
+    "created": {
+      "type": "boolean",
+      "description": "True when a new file was written."
+    },
+    "openedExisting": {
+      "type": "boolean",
+      "description": "True when collision policy selected an existing file."
+    },
+    "createdWithSuffix": {
+      "type": "boolean",
+      "description": "True when a suffixed path was created after collision."
+    },
+    "overwritten": {
+      "type": "boolean",
+      "description": "Legacy compatibility flag for overwrite-capable surfaces."
+    },
+    "contentHash": {
+      "type": "string",
+      "description": "SHA-256 hash of normalized capture body content.",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "source": {
+      "type": "object",
+      "required": ["kind", "capturedAt"],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": [
+            "direct",
+            "web",
+            "email",
+            "meeting",
+            "chat",
+            "file",
+            "api",
+            "unknown"
+          ]
+        },
+        "title": { "type": "string" },
+        "url": { "type": "string", "format": "uri" },
+        "uri": { "type": "string" },
+        "docid": { "type": "string" },
+        "mime": { "type": "string" },
+        "ext": { "type": "string" },
+        "author": { "type": "string" },
+        "observedAt": { "type": "string", "format": "date-time" },
+        "capturedAt": { "type": "string", "format": "date-time" },
+        "externalId": { "type": "string" }
+      }
+    },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "sync": {
+      "$ref": "#/definitions/indexStatus"
+    },
+    "embed": {
+      "$ref": "#/definitions/indexStatus"
+    },
+    "collisionPolicyResult": {
+      "type": "string",
+      "enum": [
+        "created",
+        "opened_existing",
+        "created_with_suffix",
+        "overwritten",
+        "conflict"
+      ]
+    }
+  },
+  "definitions": {
+    "indexStatus": {
+      "type": "object",
+      "required": ["status"],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "not_requested",
+            "pending",
+            "running",
+            "completed",
+            "skipped",
+            "failed",
+            "unknown"
+          ]
+        },
+        "jobId": {
+          "type": ["string", "null"]
+        },
+        "reason": {
+          "type": "string"
+        },
+        "error": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}

package/spec/output-schemas/claim-verification.schema.json

@@ -0,0 +1,291 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/claim-verification@1.0",
+  "title": "GNO Claim Verification Result",
+  "description": "Deterministic claim spans, Capsule-bound evidence, semantic verdicts, coverage, and abstention.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "coordinateSpace",
+    "capsuleId",
+    "answerHash",
+    "coverageThreshold",
+    "claims",
+    "rejectedCitations",
+    "coverage",
+    "answerStatus",
+    "abstained",
+    "abstentionReason",
+    "abstentionText"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "coordinateSpace": { "const": "utf16_code_units" },
+    "capsuleId": { "$ref": "#/definitions/sha256" },
+    "answerHash": { "$ref": "#/definitions/sha256" },
+    "coverageThreshold": { "const": 1 },
+    "claims": {
+      "type": "array",
+      "maxItems": 256,
+      "items": { "$ref": "#/definitions/claim" }
+    },
+    "rejectedCitations": {
+      "type": "array",
+      "maxItems": 256,
+      "items": { "$ref": "#/definitions/rejectedCitation" }
+    },
+    "coverage": { "$ref": "#/definitions/coverage" },
+    "answerStatus": { "enum": ["verified", "abstained"] },
+    "abstained": { "type": "boolean" },
+    "abstentionReason": {
+      "enum": [
+        "contradiction_detected",
+        "coverage_below_threshold",
+        "no_substantive_claims",
+        "citation_hygiene_failed",
+        null
+      ]
+    },
+    "abstentionText": { "type": ["string", "null"] }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "abstained": { "const": false } } },
+      "then": {
+        "properties": {
+          "answerStatus": { "const": "verified" },
+          "abstentionReason": { "type": "null" },
+          "abstentionText": { "type": "null" },
+          "rejectedCitations": { "type": "array", "maxItems": 0 },
+          "claims": {
+            "type": "array",
+            "not": {
+              "contains": {
+                "type": "object",
+                "required": ["rejectedCitations"],
+                "properties": {
+                  "rejectedCitations": {
+                    "type": "array",
+                    "minItems": 1
+                  }
+                }
+              }
+            }
+          },
+          "coverage": {
+            "type": "object",
+            "properties": {
+              "totalClaims": { "type": "integer", "minimum": 1 },
+              "supportedRatio": { "const": 1 },
+              "contradictedClaims": { "const": 0 },
+              "insufficientClaims": { "const": 0 },
+              "uncertainClaims": { "const": 0 }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "abstained": { "const": true } } },
+      "then": {
+        "properties": {
+          "answerStatus": { "const": "abstained" },
+          "abstentionReason": { "type": "string" },
+          "abstentionText": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  ],
+  "definitions": {
+    "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "evidenceReference": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "evidenceId",
+        "uri",
+        "startLine",
+        "endLine",
+        "text",
+        "sourceHash",
+        "mirrorHash",
+        "passageHash"
+      ],
+      "properties": {
+        "evidenceId": { "$ref": "#/definitions/sha256" },
+        "uri": {
+          "type": "string",
+          "maxLength": 2048,
+          "pattern": "^gno://"
+        },
+        "startLine": { "type": "integer", "minimum": 1 },
+        "endLine": { "type": "integer", "minimum": 1 },
+        "text": { "type": "string", "minLength": 1 },
+        "sourceHash": { "$ref": "#/definitions/sha256" },
+        "mirrorHash": { "$ref": "#/definitions/sha256" },
+        "passageHash": { "$ref": "#/definitions/sha256" }
+      }
+    },
+    "rejectedCitation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["marker", "start", "end", "evidenceId", "reason"],
+      "properties": {
+        "marker": { "type": "string", "minLength": 1 },
+        "start": { "type": "integer", "minimum": 0 },
+        "end": { "type": "integer", "minimum": 1 },
+        "evidenceId": {
+          "oneOf": [{ "$ref": "#/definitions/sha256" }, { "type": "null" }]
+        },
+        "reason": {
+          "enum": [
+            "malformed_citation",
+            "out_of_capsule",
+            "freshness_unavailable",
+            "freshness_receipt_invalid",
+            "freshness_receipt_mismatch",
+            "evidence_stale",
+            "evidence_missing",
+            "orphan_citation"
+          ]
+        }
+      }
+    },
+    "claim": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "claimId",
+        "text",
+        "start",
+        "end",
+        "status",
+        "confidence",
+        "rationaleCode",
+        "verifierFingerprint",
+        "evidence",
+        "rejectedCitations"
+      ],
+      "properties": {
+        "claimId": { "$ref": "#/definitions/sha256" },
+        "text": { "type": "string", "minLength": 1 },
+        "start": { "type": "integer", "minimum": 0 },
+        "end": { "type": "integer", "minimum": 1 },
+        "status": {
+          "enum": ["supported", "contradicted", "insufficient", "uncertain"]
+        },
+        "confidence": {
+          "oneOf": [
+            { "type": "number", "minimum": 0, "maximum": 1 },
+            { "type": "null" }
+          ]
+        },
+        "rationaleCode": {
+          "enum": [
+            "semantic_entailment",
+            "semantic_contradiction",
+            "no_valid_evidence",
+            "semantic_judgment_unavailable"
+          ]
+        },
+        "verifierFingerprint": {
+          "oneOf": [{ "$ref": "#/definitions/sha256" }, { "type": "null" }]
+        },
+        "evidence": {
+          "type": "array",
+          "maxItems": 256,
+          "items": { "$ref": "#/definitions/evidenceReference" }
+        },
+        "rejectedCitations": {
+          "type": "array",
+          "maxItems": 256,
+          "items": { "$ref": "#/definitions/rejectedCitation" }
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "status": { "enum": ["supported", "contradicted"] }
+            }
+          },
+          "then": {
+            "properties": {
+              "confidence": { "type": "number" },
+              "verifierFingerprint": { "$ref": "#/definitions/sha256" },
+              "evidence": { "type": "array", "minItems": 1 }
+            }
+          }
+        },
+        {
+          "if": { "properties": { "status": { "const": "supported" } } },
+          "then": {
+            "properties": {
+              "rationaleCode": { "const": "semantic_entailment" }
+            }
+          }
+        },
+        {
+          "if": { "properties": { "status": { "const": "contradicted" } } },
+          "then": {
+            "properties": {
+              "rationaleCode": { "const": "semantic_contradiction" }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "status": { "enum": ["insufficient", "uncertain"] }
+            }
+          },
+          "then": {
+            "properties": {
+              "confidence": { "type": "null" },
+              "verifierFingerprint": { "type": "null" }
+            }
+          }
+        },
+        {
+          "if": { "properties": { "status": { "const": "insufficient" } } },
+          "then": {
+            "properties": {
+              "rationaleCode": { "const": "no_valid_evidence" },
+              "evidence": { "type": "array", "maxItems": 0 }
+            }
+          }
+        },
+        {
+          "if": { "properties": { "status": { "const": "uncertain" } } },
+          "then": {
+            "properties": {
+              "rationaleCode": { "const": "semantic_judgment_unavailable" },
+              "evidence": { "type": "array", "minItems": 1 }
+            }
+          }
+        }
+      ]
+    },
+    "coverage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "totalClaims",
+        "supportedClaims",
+        "contradictedClaims",
+        "insufficientClaims",
+        "uncertainClaims",
+        "supportedRatio"
+      ],
+      "properties": {
+        "totalClaims": { "type": "integer", "minimum": 0 },
+        "supportedClaims": { "type": "integer", "minimum": 0 },
+        "contradictedClaims": { "type": "integer", "minimum": 0 },
+        "insufficientClaims": { "type": "integer", "minimum": 0 },
+        "uncertainClaims": { "type": "integer", "minimum": 0 },
+        "supportedRatio": { "type": "number", "minimum": 0, "maximum": 1 }
+      }
+    }
+  }
+}

package/spec/output-schemas/collection-list.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/collection-list@1.0",
+  "title": "GNO Collection List",
+  "description": "List of configured collections",
+  "type": "array",
+  "items": {
+    "type": "object",
+    "required": ["name", "path", "pattern", "include", "exclude"],
+    "properties": {
+      "name": {
+        "type": "string",
+        "description": "Collection identifier (lowercase, alphanumeric with hyphens/underscores)",
+        "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$"
+      },
+      "path": {
+        "type": "string",
+        "description": "Absolute path to collection root directory"
+      },
+      "pattern": {
+        "type": "string",
+        "description": "Glob pattern for file matching",
+        "default": "**/*"
+      },
+      "include": {
+        "type": "array",
+        "description": "Extension allowlist (empty = all)",
+        "items": { "type": "string" }
+      },
+      "exclude": {
+        "type": "array",
+        "description": "Path patterns to skip",
+        "items": { "type": "string" }
+      },
+      "updateCmd": {
+        "type": "string",
+        "description": "Optional shell command to run before indexing"
+      },
+      "languageHint": {
+        "type": "string",
+        "description": "BCP-47 language hint for the collection"
+      }
+    }
+  }
+}