@gmickel/gno 1.27.1 → 1.29.0

package/spec/output-schemas/mcp-job-status.schema.json

@@ -74,6 +74,34 @@
               }
             }
           }
+        },
+        "files": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/fileSyncResult"
+          }
+        }
+      }
+    },
+    "fileSyncResult": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["relPath", "status"],
+      "properties": {
+        "relPath": { "type": "string" },
+        "status": {
+          "enum": ["added", "updated", "unchanged", "error", "skipped"]
+        },
+        "docid": { "type": "string" },
+        "mirrorHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "contentType": { "type": "string" },
+        "contentTypeSource": {
+          "enum": ["frontmatter-type", "prefix", "path-ext", "fallback"]
+        },
+        "errorCode": { "type": "string" },
+        "errorMessage": { "type": "string" },
+        "recordImport": {
+          "$ref": "gno://schemas/record-import@1.0"
         }
       }
     },

package/spec/output-schemas/multi-get.schema.json

@@ -45,6 +45,134 @@
               "mime": { "type": "string" },
               "ext": { "type": "string", "pattern": "^\\.[a-zA-Z0-9]+$" }
             }
+          },
+          "record": {
+            "type": "object",
+            "additionalProperties": false,
+            "description": "Bounded logical-record provenance for a file/export source",
+            "required": ["recordKey", "sourceLocator", "anchors", "adapter"],
+            "properties": {
+              "recordKey": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+              "sourceLocator": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 512
+              },
+              "anchors": {
+                "type": "array",
+                "maxItems": 256,
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["kind", "value"],
+                  "properties": {
+                    "kind": {
+                      "enum": [
+                        "line",
+                        "cue",
+                        "timestamp",
+                        "message",
+                        "event",
+                        "record"
+                      ]
+                    },
+                    "value": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 512
+                    },
+                    "endValue": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 512
+                    }
+                  }
+                }
+              },
+              "adapter": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["id", "version", "fingerprint"],
+                "properties": {
+                  "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+                  "version": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 64
+                  },
+                  "fingerprint": {
+                    "type": "string",
+                    "pattern": "^[a-f0-9]{64}$"
+                  }
+                }
+              },
+              "author": { "type": "string", "maxLength": 2048 },
+              "participants": {
+                "type": "array",
+                "maxItems": 256,
+                "items": { "type": "string", "minLength": 1, "maxLength": 2048 }
+              },
+              "categories": {
+                "type": "array",
+                "maxItems": 256,
+                "items": { "type": "string", "minLength": 1, "maxLength": 512 }
+              },
+              "dateFields": {
+                "type": "object",
+                "maxProperties": 256,
+                "propertyNames": { "type": "string", "maxLength": 128 },
+                "additionalProperties": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 256
+                }
+              },
+              "messageId": { "type": "string", "maxLength": 2048 },
+              "inReplyTo": { "type": "string", "maxLength": 2048 },
+              "references": {
+                "type": "array",
+                "maxItems": 256,
+                "items": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 2048
+                }
+              },
+              "threadId": { "type": "string", "maxLength": 2048 },
+              "eventId": { "type": "string", "maxLength": 2048 },
+              "sessionId": { "type": "string", "maxLength": 2048 },
+              "attachments": {
+                "type": "array",
+                "maxItems": 256,
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["name"],
+                  "properties": {
+                    "name": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 512
+                    },
+                    "mime": {
+                      "type": "string",
+                      "minLength": 1,
+                      "maxLength": 256
+                    },
+                    "bytes": {
+                      "type": "integer",
+                      "minimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "disposition": { "enum": ["inline", "attachment"] },
+                    "sha256": {
+                      "type": "string",
+                      "pattern": "^[a-f0-9]{64}$"
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }

package/spec/output-schemas/publish-artifact.schema.json

@@ -13,6 +13,7 @@
       "required": ["version", "source", "exportedAt", "spaces"],
       "properties": {
         "version": { "const": 1 },
+        "egressLineage": { "$ref": "#/definitions/egressLineage" },
         "source": { "$ref": "#/definitions/slug" },
         "exportedAt": { "type": "string", "format": "date-time" },
         "spaces": {
@@ -33,6 +34,7 @@
       "required": ["version", "source", "exportedAt", "spaces"],
       "properties": {
         "version": { "const": 2 },
+        "egressLineage": { "$ref": "#/definitions/egressLineage" },
         "source": { "$ref": "#/definitions/slug" },
         "exportedAt": { "type": "string", "format": "date-time" },
         "spaces": {
@@ -51,6 +53,35 @@
       "type": "string",
       "pattern": "^[a-f0-9]{64}$"
     },
+    "egressLineage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["effectivePolicy", "digest", "sources"],
+      "properties": {
+        "effectivePolicy": { "enum": ["local_only", "lan", "remote"] },
+        "digest": { "$ref": "#/definitions/hash" },
+        "sources": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["collection", "policy", "source"],
+            "properties": {
+              "collection": {
+                "type": "string",
+                "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$"
+              },
+              "policy": { "enum": ["local_only", "lan", "remote"] },
+              "source": {
+                "enum": ["explicit", "config_default", "legacy_default"]
+              }
+            }
+          }
+        }
+      }
+    },
     "docid": {
       "type": "string",
       "pattern": "^#[a-f0-9]{8}$"
@@ -145,6 +176,7 @@
       "properties": {
         "schemaVersion": { "const": "1.0" },
         "projectionRevision": { "$ref": "#/definitions/hash" },
+        "egressLineage": { "$ref": "#/definitions/egressLineage" },
         "generatedAt": { "type": "string", "format": "date-time" },
         "visibility": { "const": "public" },
         "capabilities": {

package/spec/output-schemas/record-import.schema.json

@@ -0,0 +1,223 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/record-import@1.0",
+  "title": "GNO Record Import Receipt",
+  "description": "Bounded reconciliation receipt for one multi-record export container.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "adapterId",
+    "adapterVersion",
+    "adapterFingerprint",
+    "snapshotState",
+    "authoritative",
+    "stoppedByCap",
+    "sourceBytesRead",
+    "records",
+    "items",
+    "itemsTruncated",
+    "warnings",
+    "failures"
+  ],
+  "properties": {
+    "adapterId": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "adapterVersion": { "type": "string", "minLength": 1, "maxLength": 64 },
+    "adapterFingerprint": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "egressLineage": { "$ref": "#/$defs/egressLineage" },
+    "snapshotState": { "enum": ["complete", "partial"] },
+    "authoritative": { "type": "boolean" },
+    "stoppedByCap": { "type": "boolean" },
+    "sourceBytesRead": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "records": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "accepted",
+        "added",
+        "updated",
+        "reactivated",
+        "unchanged",
+        "deactivated",
+        "preserved",
+        "failed"
+      ],
+      "properties": {
+        "accepted": { "type": "integer", "minimum": 0 },
+        "added": { "type": "integer", "minimum": 0 },
+        "updated": { "type": "integer", "minimum": 0 },
+        "reactivated": { "type": "integer", "minimum": 0 },
+        "unchanged": { "type": "integer", "minimum": 0 },
+        "deactivated": { "type": "integer", "minimum": 0 },
+        "preserved": { "type": "integer", "minimum": 0 },
+        "failed": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "items": {
+      "type": "array",
+      "maxItems": 1000,
+      "items": { "$ref": "#/$defs/item" }
+    },
+    "itemsTruncated": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "warnings": {
+      "type": "array",
+      "maxItems": 1,
+      "items": { "$ref": "#/$defs/warning" }
+    },
+    "failures": {
+      "type": "array",
+      "maxItems": 1000,
+      "items": { "$ref": "#/$defs/failure" }
+    }
+  },
+  "$defs": {
+    "egressLineage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["effectivePolicy", "digest", "sources"],
+      "properties": {
+        "effectivePolicy": { "enum": ["local_only", "lan", "remote"] },
+        "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "sources": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["collection", "policy", "source"],
+            "properties": {
+              "collection": {
+                "type": "string",
+                "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$"
+              },
+              "policy": { "enum": ["local_only", "lan", "remote"] },
+              "source": {
+                "enum": ["explicit", "config_default", "legacy_default"]
+              }
+            }
+          }
+        }
+      }
+    },
+    "attachment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "mime": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "bytes": { "type": "integer", "minimum": 0 },
+        "disposition": { "enum": ["inline", "attachment"] },
+        "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+      }
+    },
+    "item": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "outcome",
+        "recordKey",
+        "sourceLocator",
+        "sourceHash",
+        "adapterFingerprint",
+        "attachments"
+      ],
+      "properties": {
+        "outcome": {
+          "enum": [
+            "added",
+            "updated",
+            "reactivated",
+            "unchanged",
+            "deactivated",
+            "preserved"
+          ]
+        },
+        "recordKey": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "sourceLocator": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        },
+        "sourceHash": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "mirrorHash": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "adapterFingerprint": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "attachments": {
+          "type": "array",
+          "maxItems": 256,
+          "items": { "$ref": "#/$defs/attachment" }
+        }
+      }
+    },
+    "warning": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "message", "retryable"],
+      "properties": {
+        "code": { "const": "PARTIAL_SNAPSHOT" },
+        "message": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 240
+        },
+        "retryable": { "type": "boolean" }
+      }
+    },
+    "failure": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "message", "retryable"],
+      "properties": {
+        "code": {
+          "enum": [
+            "MALFORMED_RECORD",
+            "MISSING_ID",
+            "DUPLICATE_ID",
+            "RECORD_TOO_LARGE",
+            "SOURCE_TOO_LARGE",
+            "TIMEOUT",
+            "RECORD_LIMIT",
+            "FAILURE_LIMIT",
+            "INVALID_LOCATOR",
+            "INVALID_SOURCE_HASH",
+            "ADAPTER_FAILURE",
+            "INVALID_SNAPSHOT"
+          ]
+        },
+        "message": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 240
+        },
+        "retryable": { "type": "boolean" },
+        "stableId": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "sourceLocator": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512
+        }
+      }
+    }
+  }
+}

package/spec/output-schemas/retrieval-trace-common.schema.json

@@ -27,6 +27,35 @@
         "index": { "$ref": "#/definitions/sha256" }
       }
     },
+    "egressLineage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["effectivePolicy", "digest", "sources"],
+      "properties": {
+        "effectivePolicy": { "enum": ["local_only", "lan", "remote"] },
+        "digest": { "$ref": "#/definitions/sha256" },
+        "sources": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["collection", "policy", "source"],
+            "properties": {
+              "collection": {
+                "type": "string",
+                "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$"
+              },
+              "policy": { "enum": ["local_only", "lan", "remote"] },
+              "source": {
+                "enum": ["explicit", "config_default", "legacy_default"]
+              }
+            }
+          }
+        }
+      }
+    },
     "summary": { "$ref": "gno://schemas/retrieval-trace-summary@1.0" },
     "trace": {
       "type": "object",
@@ -79,6 +108,7 @@
             }
           ]
         },
+        "egressLineage": { "$ref": "#/definitions/egressLineage" },
         "fingerprints": { "$ref": "#/definitions/fingerprints" },
         "createdAtMs": { "type": "integer", "minimum": 0 },
         "updatedAtMs": { "type": "integer", "minimum": 0 },
@@ -465,6 +495,7 @@
         },
         "format": { "enum": ["agentic-receipt", "qrels"] },
         "artifactHash": { "$ref": "#/definitions/sha256" },
+        "egressLineage": { "$ref": "#/definitions/egressLineage" },
         "createdAtMs": { "type": "integer", "minimum": 0 }
       }
     },

package/spec/output-schemas/retrieval-trace-export.schema.json

@@ -20,6 +20,9 @@
           "properties": {
             "schemaVersion": { "const": "1.0" },
             "format": { "const": "agentic-receipt" },
+            "egressLineage": {
+              "$ref": "gno://schemas/retrieval-trace-common@1.0#/definitions/egressLineage"
+            },
             "traces": {
               "type": "array",
               "minItems": 1,

package/spec/output-schemas/retrieval-trace-qrels.schema.json

@@ -8,6 +8,9 @@
   "properties": {
     "schemaVersion": { "const": "1.0" },
     "format": { "const": "qrels" },
+    "egressLineage": {
+      "$ref": "gno://schemas/retrieval-trace-common@1.0#/definitions/egressLineage"
+    },
     "cases": {
       "type": "array",
       "minItems": 1,

package/spec/output-schemas/retrieval-trace-summary.schema.json

@@ -26,6 +26,9 @@
         "config": { "$ref": "#/definitions/sha256" },
         "index": { "$ref": "#/definitions/sha256" }
       }
+    },
+    "egressLineage": {
+      "$ref": "gno://schemas/retrieval-trace-common@1.0#/definitions/egressLineage"
     }
   },
   "type": "object",
@@ -55,6 +58,7 @@
     },
     "queryShape": { "$ref": "#/definitions/textShape" },
     "goalShape": { "$ref": "#/definitions/textShape" },
+    "egressLineage": { "$ref": "#/definitions/egressLineage" },
     "fingerprints": { "$ref": "#/definitions/fingerprints" },
     "createdAtMs": { "type": "integer", "minimum": 0 },
     "updatedAtMs": { "type": "integer", "minimum": 0 },

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

@@ -149,6 +149,100 @@
           }
         }
       }
+    },
+    "record": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Bounded logical-record provenance for a file/export source",
+      "required": ["recordKey", "sourceLocator", "anchors", "adapter"],
+      "properties": {
+        "recordKey": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "sourceLocator": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "anchors": {
+          "type": "array",
+          "maxItems": 256,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["kind", "value"],
+            "properties": {
+              "kind": {
+                "enum": [
+                  "line",
+                  "cue",
+                  "timestamp",
+                  "message",
+                  "event",
+                  "record"
+                ]
+              },
+              "value": { "type": "string", "minLength": 1, "maxLength": 512 },
+              "endValue": { "type": "string", "minLength": 1, "maxLength": 512 }
+            }
+          }
+        },
+        "adapter": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["id", "version", "fingerprint"],
+          "properties": {
+            "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+            "version": { "type": "string", "minLength": 1, "maxLength": 64 },
+            "fingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+          }
+        },
+        "author": { "type": "string", "maxLength": 2048 },
+        "participants": {
+          "type": "array",
+          "maxItems": 256,
+          "items": { "type": "string", "minLength": 1, "maxLength": 2048 }
+        },
+        "categories": {
+          "type": "array",
+          "maxItems": 256,
+          "items": { "type": "string", "minLength": 1, "maxLength": 512 }
+        },
+        "dateFields": {
+          "type": "object",
+          "maxProperties": 256,
+          "propertyNames": { "type": "string", "maxLength": 128 },
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256
+          }
+        },
+        "messageId": { "type": "string", "maxLength": 2048 },
+        "inReplyTo": { "type": "string", "maxLength": 2048 },
+        "references": {
+          "type": "array",
+          "maxItems": 256,
+          "items": { "type": "string", "minLength": 1, "maxLength": 2048 }
+        },
+        "threadId": { "type": "string", "maxLength": 2048 },
+        "eventId": { "type": "string", "maxLength": 2048 },
+        "sessionId": { "type": "string", "maxLength": 2048 },
+        "attachments": {
+          "type": "array",
+          "maxItems": 256,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name"],
+            "properties": {
+              "name": { "type": "string", "minLength": 1, "maxLength": 512 },
+              "mime": { "type": "string", "minLength": 1, "maxLength": 256 },
+              "bytes": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+              },
+              "disposition": { "enum": ["inline", "attachment"] },
+              "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+            }
+          }
+        }
+      }
     }
   }
 }