@gmickel/gno 1.20.0 → 1.22.0

package/spec/output-schemas/capsule-reverified-event.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/capsule-reverified-event@1.0",
+  "title": "GNO Metadata-only Saved Capsule Reverification Event",
+  "description": "Closed local event emitted only after a saved Capsule verification result commits.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "type",
+    "registrationId",
+    "capsuleId",
+    "operationStatus",
+    "affectedQuestionState",
+    "changedAt"
+  ],
+  "properties": {
+    "type": { "const": "capsule-reverified" },
+    "registrationId": {
+      "type": "string",
+      "pattern": "^capsule-[a-f0-9]{40}$"
+    },
+    "capsuleId": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "operationStatus": { "enum": ["completed", "failed"] },
+    "affectedQuestionState": {
+      "enum": ["unaffected", "affected", "unknown"]
+    },
+    "changedAt": { "type": "string", "format": "date-time" }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": { "operationStatus": { "const": "completed" } },
+        "required": ["operationStatus"]
+      },
+      "then": {
+        "properties": {
+          "affectedQuestionState": { "enum": ["unaffected", "affected"] }
+        }
+      },
+      "else": {
+        "properties": {
+          "affectedQuestionState": { "const": "unknown" }
+        }
+      }
+    }
+  ]
+}

package/spec/output-schemas/changes.schema.json

@@ -0,0 +1,280 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/changes@1.0",
+  "title": "GNO Knowledge Changes",
+  "type": "object",
+  "required": ["schemaVersion", "changes", "page", "warnings"],
+  "properties": {
+    "schemaVersion": { "type": "string", "const": "1.0" },
+    "changes": {
+      "type": "array",
+      "maxItems": 1000,
+      "items": { "$ref": "#/definitions/change" }
+    },
+    "page": {
+      "type": "object",
+      "required": [
+        "nextCursor",
+        "earliestCursor",
+        "latestCursor",
+        "cursorExpired",
+        "truncated",
+        "retentionTruncated"
+      ],
+      "properties": {
+        "nextCursor": { "type": ["string", "null"], "maxLength": 512 },
+        "earliestCursor": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        },
+        "latestCursor": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "cursorExpired": { "type": "boolean" },
+        "truncated": { "type": "boolean" },
+        "retentionTruncated": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    },
+    "warnings": { "type": "array", "items": { "type": "string" } }
+  },
+  "additionalProperties": false,
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "page": {
+            "type": "object",
+            "properties": { "cursorExpired": { "const": true } },
+            "required": ["cursorExpired"]
+          }
+        },
+        "required": ["page"]
+      },
+      "then": {
+        "properties": {
+          "changes": { "type": "array", "maxItems": 0 },
+          "page": {
+            "type": "object",
+            "properties": {
+              "nextCursor": { "type": "null" },
+              "retentionTruncated": { "const": true }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "page": {
+            "type": "object",
+            "properties": { "truncated": { "const": true } },
+            "required": ["truncated"]
+          }
+        },
+        "required": ["page"]
+      },
+      "then": {
+        "properties": {
+          "page": {
+            "type": "object",
+            "properties": {
+              "nextCursor": { "type": "string", "minLength": 1 }
+            }
+          }
+        }
+      },
+      "else": {
+        "properties": {
+          "page": {
+            "type": "object",
+            "properties": { "nextCursor": { "type": "null" } }
+          }
+        }
+      }
+    }
+  ],
+  "definitions": {
+    "snapshot": {
+      "type": "object",
+      "required": [
+        "relPath",
+        "docid",
+        "uri",
+        "sourceHash",
+        "mirrorHash",
+        "active"
+      ],
+      "properties": {
+        "relPath": { "type": "string" },
+        "docid": { "type": "string", "pattern": "^#[a-f0-9]{6,}$" },
+        "uri": { "type": "string", "pattern": "^gno://.+" },
+        "sourceHash": { "$ref": "#/definitions/sha256" },
+        "mirrorHash": {
+          "anyOf": [{ "$ref": "#/definitions/sha256" }, { "type": "null" }]
+        },
+        "active": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    },
+    "setDelta": {
+      "type": "object",
+      "required": ["added", "removed"],
+      "properties": {
+        "added": {
+          "type": "array",
+          "maxItems": 16,
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1, "maxLength": 256 }
+        },
+        "removed": {
+          "type": "array",
+          "maxItems": 16,
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1, "maxLength": 256 }
+        }
+      },
+      "additionalProperties": false
+    },
+    "dateDelta": {
+      "type": "object",
+      "required": ["added", "removed", "changed"],
+      "properties": {
+        "added": {
+          "type": "array",
+          "maxItems": 16,
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1, "maxLength": 256 }
+        },
+        "removed": {
+          "type": "array",
+          "maxItems": 16,
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1, "maxLength": 256 }
+        },
+        "changed": {
+          "type": "array",
+          "maxItems": 16,
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1, "maxLength": 256 }
+        }
+      },
+      "additionalProperties": false
+    },
+    "structureDelta": {
+      "type": "object",
+      "required": ["headings", "links", "typedEdges", "dates", "truncated"],
+      "properties": {
+        "headings": { "$ref": "#/definitions/setDelta" },
+        "links": { "$ref": "#/definitions/setDelta" },
+        "typedEdges": { "$ref": "#/definitions/setDelta" },
+        "dates": { "$ref": "#/definitions/dateDelta" },
+        "truncated": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    },
+    "sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "change": {
+      "type": "object",
+      "required": [
+        "id",
+        "kind",
+        "collection",
+        "observedAt",
+        "previous",
+        "current",
+        "structureDelta"
+      ],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "kind": {
+          "type": "string",
+          "enum": ["create", "update", "rename", "inactivate", "reactivate"]
+        },
+        "collection": { "type": "string", "minLength": 1 },
+        "observedAt": { "type": "string", "format": "date-time" },
+        "previous": {
+          "anyOf": [{ "$ref": "#/definitions/snapshot" }, { "type": "null" }]
+        },
+        "current": {
+          "anyOf": [{ "$ref": "#/definitions/snapshot" }, { "type": "null" }]
+        },
+        "structureDelta": { "$ref": "#/definitions/structureDelta" }
+      },
+      "additionalProperties": false,
+      "allOf": [
+        {
+          "if": {
+            "properties": { "kind": { "const": "create" } },
+            "required": ["kind"]
+          },
+          "then": {
+            "properties": {
+              "previous": { "type": "null" },
+              "current": {
+                "type": "object",
+                "properties": { "active": { "const": true } },
+                "required": ["active"]
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": { "kind": { "enum": ["update", "rename"] } },
+            "required": ["kind"]
+          },
+          "then": {
+            "properties": {
+              "previous": { "$ref": "#/definitions/snapshot" },
+              "current": { "$ref": "#/definitions/snapshot" }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": { "kind": { "const": "inactivate" } },
+            "required": ["kind"]
+          },
+          "then": {
+            "properties": {
+              "previous": {
+                "type": "object",
+                "properties": { "active": { "const": true } },
+                "required": ["active"]
+              },
+              "current": {
+                "type": "object",
+                "properties": { "active": { "const": false } },
+                "required": ["active"]
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": { "kind": { "const": "reactivate" } },
+            "required": ["kind"]
+          },
+          "then": {
+            "properties": {
+              "previous": {
+                "type": "object",
+                "properties": { "active": { "const": false } },
+                "required": ["active"]
+              },
+              "current": {
+                "type": "object",
+                "properties": { "active": { "const": true } },
+                "required": ["active"]
+              }
+            }
+          }
+        }
+      ]
+    }
+  }
+}

package/spec/output-schemas/document-diff.schema.json

@@ -0,0 +1,185 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/document-diff@1.0",
+  "title": "GNO Document Structural Diff",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "status",
+    "document",
+    "change",
+    "content",
+    "history",
+    "warnings"
+  ],
+  "properties": {
+    "schemaVersion": { "type": "string", "const": "1.0" },
+    "status": {
+      "type": "string",
+      "enum": ["available", "expired", "unavailable"]
+    },
+    "document": {
+      "type": "object",
+      "required": ["id", "uri", "title", "collection", "relPath", "active"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^#[a-f0-9]{6,}$" },
+        "uri": { "type": "string", "pattern": "^gno://.+" },
+        "title": { "type": ["string", "null"] },
+        "collection": { "type": "string" },
+        "relPath": { "type": "string" },
+        "active": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    },
+    "change": {
+      "anyOf": [
+        { "$ref": "gno://schemas/changes@1.0#/definitions/change" },
+        { "type": "null" }
+      ]
+    },
+    "content": {
+      "type": "object",
+      "required": ["status", "reason"],
+      "properties": {
+        "status": { "type": "string", "const": "not_retained" },
+        "reason": { "type": "string", "const": "journal_metadata_only" }
+      },
+      "additionalProperties": false
+    },
+    "history": {
+      "type": "object",
+      "required": ["status", "reason"],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": ["available", "partial", "unavailable"]
+        },
+        "reason": {
+          "type": ["string", "null"],
+          "enum": [
+            null,
+            "structure_delta_truncated",
+            "change_expired",
+            "no_retained_change",
+            "change_not_found"
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
+    "warnings": { "type": "array", "items": { "type": "string" } }
+  },
+  "additionalProperties": false,
+  "allOf": [
+    {
+      "if": {
+        "properties": { "status": { "const": "available" } },
+        "required": ["status"]
+      },
+      "then": {
+        "properties": {
+          "change": {
+            "$ref": "gno://schemas/changes@1.0#/definitions/change"
+          },
+          "history": {
+            "type": "object",
+            "properties": {
+              "status": { "enum": ["available", "partial"] }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "status": { "const": "expired" } },
+        "required": ["status"]
+      },
+      "then": {
+        "properties": {
+          "change": { "type": "null" },
+          "history": {
+            "type": "object",
+            "properties": {
+              "status": { "const": "unavailable" },
+              "reason": { "const": "change_expired" }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "status": { "const": "unavailable" } },
+        "required": ["status"]
+      },
+      "then": {
+        "properties": {
+          "change": { "type": "null" },
+          "history": {
+            "type": "object",
+            "properties": {
+              "status": { "const": "unavailable" },
+              "reason": {
+                "enum": ["no_retained_change", "change_not_found"]
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "history": {
+            "type": "object",
+            "properties": { "status": { "const": "available" } },
+            "required": ["status"]
+          }
+        },
+        "required": ["history"]
+      },
+      "then": {
+        "properties": {
+          "history": {
+            "type": "object",
+            "properties": { "reason": { "type": "null" } }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "history": {
+            "type": "object",
+            "properties": { "status": { "const": "partial" } },
+            "required": ["status"]
+          }
+        },
+        "required": ["history"]
+      },
+      "then": {
+        "properties": {
+          "change": {
+            "type": "object",
+            "properties": {
+              "structureDelta": {
+                "type": "object",
+                "properties": { "truncated": { "const": true } },
+                "required": ["truncated"]
+              }
+            },
+            "required": ["structureDelta"]
+          },
+          "history": {
+            "type": "object",
+            "properties": {
+              "reason": { "const": "structure_delta_truncated" }
+            }
+          }
+        }
+      }
+    }
+  ]
+}

package/spec/output-schemas/impact.schema.json

@@ -0,0 +1,122 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/impact@1.0",
+  "title": "GNO Knowledge Impact",
+  "type": "object",
+  "required": ["schemaVersion", "root", "impacted", "meta"],
+  "properties": {
+    "schemaVersion": { "type": "string", "const": "1.0" },
+    "root": { "$ref": "#/definitions/node" },
+    "impacted": {
+      "type": "array",
+      "maxItems": 999,
+      "items": {
+        "type": "object",
+        "required": ["document", "depth", "evidencePath"],
+        "properties": {
+          "document": { "$ref": "#/definitions/node" },
+          "depth": { "type": "integer", "minimum": 1, "maximum": 6 },
+          "evidencePath": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 6,
+            "items": { "$ref": "#/definitions/step" }
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "meta": {
+      "type": "object",
+      "required": [
+        "maxDepth",
+        "maxNodes",
+        "maxEdges",
+        "frontierLimit",
+        "visitedLimit",
+        "returnedNodes",
+        "returnedEdges",
+        "truncated",
+        "warnings"
+      ],
+      "properties": {
+        "maxDepth": { "type": "integer", "minimum": 1, "maximum": 6 },
+        "maxNodes": { "type": "integer", "minimum": 1, "maximum": 1000 },
+        "maxEdges": { "type": "integer", "minimum": 1, "maximum": 5000 },
+        "frontierLimit": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 1000
+        },
+        "visitedLimit": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 5000
+        },
+        "returnedNodes": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 1000
+        },
+        "returnedEdges": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 5000
+        },
+        "truncated": { "type": "boolean" },
+        "warnings": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "node": {
+      "type": "object",
+      "required": ["id", "uri", "title", "collection", "relPath"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^#[a-f0-9]{6,}$" },
+        "uri": { "type": "string", "pattern": "^gno://.+" },
+        "title": { "type": ["string", "null"] },
+        "collection": { "type": "string" },
+        "relPath": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "endpoint": {
+      "type": "object",
+      "required": ["id", "uri"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^#[a-f0-9]{6,}$" },
+        "uri": { "type": "string", "pattern": "^gno://.+" }
+      },
+      "additionalProperties": false
+    },
+    "step": {
+      "type": "object",
+      "required": [
+        "source",
+        "target",
+        "edgeType",
+        "relationType",
+        "confidence",
+        "edgeSource"
+      ],
+      "properties": {
+        "source": { "$ref": "#/definitions/endpoint" },
+        "target": { "$ref": "#/definitions/endpoint" },
+        "edgeType": { "type": "string", "minLength": 1 },
+        "relationType": { "type": "string", "minLength": 1 },
+        "confidence": {
+          "type": "string",
+          "enum": ["parsed", "configured", "manual", "inferred"]
+        },
+        "edgeSource": {
+          "type": "string",
+          "enum": ["wikilink", "markdown-link", "frontmatter-relation"]
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}