@gmickel/gno 1.19.0 → 1.21.0

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
+    }
+  }
+}

package/spec/output-schemas/saved-capsule-list.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/saved-capsule-list@1.0",
+  "title": "GNO Saved Context Capsule List",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "registrations"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "registrations": {
+      "type": "array",
+      "maxItems": 10000,
+      "items": { "$ref": "gno://schemas/saved-capsule-registration@1.0" }
+    }
+  }
+}

package/spec/output-schemas/saved-capsule-registration.schema.json

@@ -0,0 +1,172 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/saved-capsule-registration@1.0",
+  "title": "GNO Saved Context Capsule Registration",
+  "description": "Metadata-only registration for one caller-owned Context Capsule file. Capsule and passage bytes are never embedded in this payload.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "registrationId",
+    "filePath",
+    "fileHash",
+    "capsuleId",
+    "indexName",
+    "question",
+    "label",
+    "notificationPreference",
+    "registeredAtMs",
+    "updatedAtMs",
+    "lastAttemptedSequence",
+    "evidence",
+    "verification"
+  ],
+  "properties": {
+    "registrationId": {
+      "type": "string",
+      "pattern": "^capsule-[a-f0-9]{40}$"
+    },
+    "filePath": { "type": "string", "minLength": 1, "maxLength": 8192 },
+    "fileHash": { "$ref": "#/definitions/sha256" },
+    "capsuleId": { "$ref": "#/definitions/sha256" },
+    "indexName": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "question": {
+      "type": ["string", "null"],
+      "minLength": 1,
+      "maxLength": 8192
+    },
+    "label": {
+      "type": ["string", "null"],
+      "minLength": 1,
+      "maxLength": 512
+    },
+    "notificationPreference": { "enum": ["none", "local"] },
+    "registeredAtMs": { "type": "integer", "minimum": 0 },
+    "updatedAtMs": { "type": "integer", "minimum": 0 },
+    "lastAttemptedSequence": { "type": "integer", "minimum": 0 },
+    "evidence": {
+      "type": "array",
+      "maxItems": 10000,
+      "items": { "$ref": "#/definitions/evidenceReference" }
+    },
+    "verification": {
+      "anyOf": [{ "$ref": "#/definitions/verification" }, { "type": "null" }]
+    }
+  },
+  "definitions": {
+    "sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "evidenceReference": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "evidenceId",
+        "canonicalUri",
+        "collection",
+        "sourceHash",
+        "mirrorHash",
+        "passageHash"
+      ],
+      "properties": {
+        "evidenceId": { "$ref": "#/definitions/sha256" },
+        "canonicalUri": { "type": "string", "pattern": "^gno://.+" },
+        "collection": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "sourceHash": { "$ref": "#/definitions/sha256" },
+        "mirrorHash": { "$ref": "#/definitions/sha256" },
+        "passageHash": { "$ref": "#/definitions/sha256" }
+      }
+    },
+    "verification": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "registrationId",
+        "triggerKind",
+        "fromSequence",
+        "throughSequence",
+        "operationStatus",
+        "affectedQuestionState",
+        "affectedReasons",
+        "receiptJson",
+        "receiptHash",
+        "errorCode",
+        "errorMessage",
+        "verifiedAtMs"
+      ],
+      "properties": {
+        "registrationId": {
+          "type": "string",
+          "pattern": "^capsule-[a-f0-9]{40}$"
+        },
+        "triggerKind": { "enum": ["manual", "journal"] },
+        "fromSequence": { "type": "integer", "minimum": 0 },
+        "throughSequence": { "type": "integer", "minimum": 0 },
+        "operationStatus": { "enum": ["completed", "failed"] },
+        "affectedQuestionState": {
+          "enum": ["unaffected", "affected", "unknown"]
+        },
+        "affectedReasons": {
+          "type": "array",
+          "maxItems": 4,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "content_stale",
+              "content_missing",
+              "ranking_changed",
+              "fingerprint_changed"
+            ]
+          }
+        },
+        "receiptJson": {
+          "type": ["string", "null"],
+          "maxLength": 16777216
+        },
+        "receiptHash": {
+          "anyOf": [{ "$ref": "#/definitions/sha256" }, { "type": "null" }]
+        },
+        "errorCode": {
+          "type": ["string", "null"],
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "errorMessage": {
+          "type": ["string", "null"],
+          "minLength": 1,
+          "maxLength": 4096
+        },
+        "verifiedAtMs": { "type": "integer", "minimum": 0 }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": { "operationStatus": { "const": "completed" } },
+            "required": ["operationStatus"]
+          },
+          "then": {
+            "properties": {
+              "affectedQuestionState": {
+                "enum": ["unaffected", "affected"]
+              },
+              "receiptJson": { "type": "string", "minLength": 1 },
+              "receiptHash": { "$ref": "#/definitions/sha256" },
+              "errorCode": { "type": "null" },
+              "errorMessage": { "type": "null" }
+            }
+          },
+          "else": {
+            "properties": {
+              "affectedQuestionState": { "const": "unknown" },
+              "affectedReasons": { "type": "array", "maxItems": 0 },
+              "receiptJson": { "type": "null" },
+              "receiptHash": { "type": "null" },
+              "errorCode": { "type": "string", "minLength": 1 },
+              "errorMessage": { "type": "string", "minLength": 1 }
+            }
+          }
+        }
+      ]
+    }
+  }
+}

package/spec/output-schemas/saved-capsule-reverification.schema.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/saved-capsule-reverification@1.0",
+  "title": "GNO Saved Context Capsule Reverification Result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "registration", "verification", "receipt"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "registration": {
+      "$ref": "gno://schemas/saved-capsule-registration@1.0"
+    },
+    "verification": {
+      "$ref": "gno://schemas/saved-capsule-registration@1.0#/definitions/verification"
+    },
+    "receipt": {
+      "anyOf": [
+        { "$ref": "gno://schemas/context-capsule-verification@1.0" },
+        { "type": "null" }
+      ]
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "verification": {
+            "type": "object",
+            "properties": { "operationStatus": { "const": "completed" } },
+            "required": ["operationStatus"]
+          }
+        },
+        "required": ["verification"]
+      },
+      "then": {
+        "properties": {
+          "verification": {
+            "type": "object",
+            "properties": { "triggerKind": { "const": "manual" } },
+            "required": ["triggerKind"]
+          },
+          "receipt": {
+            "$ref": "gno://schemas/context-capsule-verification@1.0"
+          }
+        }
+      },
+      "else": {
+        "properties": {
+          "verification": {
+            "type": "object",
+            "properties": { "triggerKind": { "const": "manual" } },
+            "required": ["triggerKind"]
+          },
+          "receipt": { "type": "null" }
+        }
+      }
+    }
+  ]
+}

package/spec/output-schemas/saved-capsule-unwatch.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/saved-capsule-unwatch@1.0",
+  "title": "GNO Saved Context Capsule Unwatch Receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "registrationId", "removed"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "registrationId": {
+      "type": "string",
+      "pattern": "^capsule-[a-f0-9]{40}$"
+    },
+    "removed": { "const": true }
+  }
+}

package/spec/output-schemas/saved-capsule-watch.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/saved-capsule-watch@1.0",
+  "title": "GNO Saved Context Capsule Watch Result",
+  "allOf": [
+    {
+      "$ref": "gno://schemas/saved-capsule-registration@1.0"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "verification": { "type": "null" }
+      },
+      "required": ["verification"]
+    }
+  ]
+}

package/src/app/context-runtime-contract.ts

@@ -24,8 +24,9 @@ import { resolveModelUri } from "../llm/registry";
 const fingerprint = (value: unknown): string =>
   sha256Text(canonicalVerifierJson(value));
 
-const configFingerprint = (deps: ContextCapsuleRuntimeDeps): string =>
-  fingerprint(deps.config);
+export const contextRuntimeConfigFingerprint = (
+  deps: Pick<ContextCapsuleRuntimeDeps, "config">
+): string => fingerprint(deps.config);
 
 const configuredContextFingerprint = (
   deps: ContextCapsuleRuntimeDeps
@@ -75,7 +76,7 @@ const capsuleCapabilityStates = (
     ["embedding_unavailable"]
   ),
   reranking: capabilityState(
-    input.depthPolicy !== "fast",
+    input.depthPolicy !== "fast" && !input.noRerank,
     draft.retrieval.reranked,
     ["reranking_unavailable"]
   ),
@@ -191,10 +192,14 @@ export const projectContextCapsule = (
       request: {
         author: input.author,
         lang: input.lang,
+        intent: input.intent,
+        exclude: input.exclude,
+        minScore: input.minScore,
         queryModes: input.queryModes,
         limit: input.limit,
         candidateLimit: input.candidateLimit,
         graphRequested: input.graph,
+        rerankRequested: input.depthPolicy !== "fast" && !input.noRerank,
       },
       capabilityStates,
       indexSnapshot: {
@@ -221,7 +226,7 @@ export const projectContextCapsule = (
         : null,
     },
     fingerprints: {
-      config: configFingerprint(deps),
+      config: contextRuntimeConfigFingerprint(deps),
       retrieval: retrievalFingerprint(base, snapshots.contextFingerprint),
       embeddingModel: capabilities.semanticSearch
         ? sha256Text(deps.embedPort?.modelUri ?? "")
@@ -292,7 +297,7 @@ export const currentContextFingerprints = (
   capsule: ContextCapsuleV1,
   deps: ContextCapsuleRuntimeDeps
 ) => ({
-  config: configFingerprint(deps),
+  config: contextRuntimeConfigFingerprint(deps),
   retrieval: retrievalFingerprint(capsule, configuredContextFingerprint(deps)),
   embeddingModel: capsule.capabilities.semanticSearch
     ? sha256Text(