@gmickel/gno 1.18.0 → 1.19.0

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

@@ -0,0 +1,21 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/context-list@1.0",
+  "title": "GNO Context List",
+  "description": "List of configured contexts for search enhancement",
+  "type": "array",
+  "items": {
+    "type": "object",
+    "required": ["scope", "text"],
+    "properties": {
+      "scope": {
+        "type": "string",
+        "description": "Scope key: '/' (global), 'name:' (collection), or 'gno://collection/path' (prefix)"
+      },
+      "text": {
+        "type": "string",
+        "description": "Context description text for search enhancement"
+      }
+    }
+  }
+}

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

@@ -0,0 +1,313 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/doctor@1.0",
+  "title": "GNO Doctor",
+  "description": "Health check diagnostics",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["healthy", "checks", "activation"],
+  "properties": {
+    "healthy": {
+      "type": "boolean",
+      "description": "Overall health status (true if no errors)"
+    },
+    "activation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "usable",
+        "healthy",
+        "collections",
+        "connectors",
+        "connectorProjection"
+      ],
+      "properties": {
+        "schemaVersion": { "const": "1.0" },
+        "usable": { "type": "boolean" },
+        "healthy": { "type": "boolean" },
+        "collections": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "collection",
+              "ready",
+              "generatedAt",
+              "stages",
+              "semanticAvailability",
+              "remediation"
+            ],
+            "properties": {
+              "collection": { "type": "string" },
+              "ready": { "type": "boolean" },
+              "generatedAt": {
+                "type": ["string", "null"],
+                "format": "date-time"
+              },
+              "stages": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["index", "lexical", "semantic", "connector"],
+                "properties": {
+                  "index": {
+                    "$ref": "#/properties/activation/definitions/stage"
+                  },
+                  "lexical": {
+                    "$ref": "#/properties/activation/definitions/stage"
+                  },
+                  "semantic": {
+                    "$ref": "#/properties/activation/definitions/stage"
+                  },
+                  "connector": {
+                    "$ref": "#/properties/activation/definitions/stage"
+                  }
+                }
+              },
+              "semanticAvailability": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["status", "code", "command"],
+                "allOf": [
+                  {
+                    "if": {
+                      "properties": {
+                        "code": { "const": "vector_unavailable" }
+                      },
+                      "required": ["code"]
+                    },
+                    "then": {
+                      "properties": { "status": { "const": "skipped" } }
+                    }
+                  },
+                  {
+                    "if": {
+                      "properties": {
+                        "code": {
+                          "enum": [
+                            "models_missing",
+                            "embeddings_pending",
+                            "semantic_not_checked"
+                          ]
+                        }
+                      },
+                      "required": ["code"]
+                    },
+                    "then": {
+                      "properties": { "status": { "const": "pending" } }
+                    }
+                  }
+                ],
+                "properties": {
+                  "status": { "enum": ["pending", "skipped"] },
+                  "code": {
+                    "enum": [
+                      "models_missing",
+                      "embeddings_pending",
+                      "vector_unavailable",
+                      "semantic_not_checked"
+                    ]
+                  },
+                  "command": { "type": "string" }
+                }
+              },
+              "remediation": {
+                "type": ["object", "null"],
+                "additionalProperties": false,
+                "required": ["stage", "code", "command", "message"],
+                "properties": {
+                  "stage": {
+                    "enum": ["index", "lexical", "semantic", "connector"]
+                  },
+                  "code": {
+                    "$ref": "#/properties/activation/definitions/code"
+                  },
+                  "command": { "type": "string" },
+                  "message": { "type": "string" }
+                }
+              }
+            }
+          }
+        },
+        "connectors": {
+          "type": "array",
+          "maxItems": 64,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["collection", "target", "status", "remediation"],
+            "properties": {
+              "collection": { "type": "string" },
+              "target": { "type": "string" },
+              "status": {
+                "enum": ["passed", "pending", "failed", "skipped"]
+              },
+              "code": {
+                "$ref": "#/properties/activation/definitions/code"
+              },
+              "remediation": { "type": ["string", "null"] }
+            }
+          }
+        },
+        "connectorProjection": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["total", "projected", "truncated"],
+          "properties": {
+            "total": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "All configured collection and connector target pairs before projection bounds."
+            },
+            "projected": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 64,
+              "description": "Pairs included in connectors; always equals connectors.length."
+            },
+            "truncated": {
+              "type": "boolean",
+              "description": "True exactly when total is greater than projected; omitted pairs have no claimed result."
+            }
+          }
+        }
+      },
+      "definitions": {
+        "code": {
+          "enum": [
+            "no_documents",
+            "index_out_of_sync",
+            "no_probe_term",
+            "index_query_failed",
+            "retrieval_mismatch",
+            "semantic_not_checked",
+            "connector_not_requested",
+            "connector_not_configured",
+            "connector_probe_unavailable",
+            "connector_unsupported_config",
+            "connector_start_failed",
+            "connector_timeout",
+            "connector_missing_tools",
+            "connector_status_failed",
+            "connector_search_failed",
+            "connector_result_mismatch",
+            "target_runtime_unverifiable"
+          ]
+        },
+        "stage": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status", "startedAt", "completedAt", "latencyMs"],
+          "properties": {
+            "status": {
+              "enum": ["passed", "pending", "failed", "skipped"]
+            },
+            "startedAt": { "type": ["string", "null"], "format": "date-time" },
+            "completedAt": {
+              "type": ["string", "null"],
+              "format": "date-time"
+            },
+            "latencyMs": { "type": ["integer", "null"], "minimum": 0 },
+            "code": {
+              "$ref": "#/properties/activation/definitions/code"
+            }
+          }
+        }
+      }
+    },
+    "checks": {
+      "type": "array",
+      "description": "Individual diagnostic checks",
+      "items": {
+        "type": "object",
+        "required": ["name", "status", "message"],
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Check identifier"
+          },
+          "status": {
+            "type": "string",
+            "enum": ["ok", "warn", "error"],
+            "description": "Check result status"
+          },
+          "message": {
+            "type": "string",
+            "description": "Human-readable status message"
+          },
+          "details": {
+            "type": "array",
+            "description": "Additional diagnostic details and recovery guidance",
+            "items": {
+              "type": "string"
+            }
+          },
+          "embeddingFingerprint": {
+            "type": "object",
+            "description": "Embedding freshness fingerprint diagnostics",
+            "required": [
+              "model",
+              "currentFingerprint",
+              "pendingChunks",
+              "legacyChunks",
+              "mixedGroups",
+              "groups"
+            ],
+            "properties": {
+              "model": {
+                "type": "string"
+              },
+              "currentFingerprint": {
+                "type": "string"
+              },
+              "pendingChunks": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "legacyChunks": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "mixedGroups": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "groups": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "required": [
+                    "model",
+                    "fingerprint",
+                    "count",
+                    "current",
+                    "legacy"
+                  ],
+                  "properties": {
+                    "model": {
+                      "type": "string"
+                    },
+                    "fingerprint": {
+                      "type": "string"
+                    },
+                    "count": {
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "current": {
+                      "type": "boolean"
+                    },
+                    "legacy": {
+                      "type": "boolean"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,30 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/error@1.0",
+  "title": "GNO Error Response",
+  "description": "Error response for CLI JSON output",
+  "type": "object",
+  "required": ["error"],
+  "properties": {
+    "error": {
+      "type": "object",
+      "required": ["code", "message"],
+      "properties": {
+        "code": {
+          "type": "string",
+          "description": "Error code matching exit code",
+          "enum": ["VALIDATION", "RUNTIME"]
+        },
+        "message": {
+          "type": "string",
+          "description": "Human-readable error message"
+        },
+        "details": {
+          "type": "object",
+          "description": "Additional error context",
+          "additionalProperties": true
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,37 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/expansion@1.0",
+  "title": "GNO Query Expansion Result",
+  "description": "Result of query expansion for hybrid search",
+  "type": "object",
+  "required": ["lexicalQueries", "vectorQueries"],
+  "properties": {
+    "lexicalQueries": {
+      "type": "array",
+      "description": "Lexical (BM25) query variants",
+      "items": {
+        "type": "string"
+      },
+      "minItems": 0,
+      "maxItems": 5
+    },
+    "vectorQueries": {
+      "type": "array",
+      "description": "Semantic (vector) query variants",
+      "items": {
+        "type": "string"
+      },
+      "minItems": 0,
+      "maxItems": 5
+    },
+    "hyde": {
+      "type": "string",
+      "description": "Hypothetical document embedding (HyDE) text"
+    },
+    "notes": {
+      "type": "string",
+      "description": "Optional debug notes from expansion model"
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,140 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/get@1.0",
+  "title": "GNO Get Response",
+  "description": "Response from gno get command",
+  "type": "object",
+  "required": [
+    "docid",
+    "uri",
+    "content",
+    "totalLines",
+    "source",
+    "capabilities"
+  ],
+  "properties": {
+    "docid": {
+      "type": "string",
+      "description": "Document ID",
+      "pattern": "^#[a-f0-9]{6,8}$"
+    },
+    "uri": {
+      "type": "string",
+      "description": "Document URI",
+      "pattern": "^gno://[^/]+/.+"
+    },
+    "title": {
+      "type": "string",
+      "description": "Extracted document title"
+    },
+    "content": {
+      "type": "string",
+      "description": "Mirror content (Markdown)"
+    },
+    "totalLines": {
+      "type": "integer",
+      "description": "Total lines in document",
+      "minimum": 0
+    },
+    "returnedLines": {
+      "type": "object",
+      "description": "Line range returned (if partial)",
+      "properties": {
+        "start": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "end": {
+          "type": "integer",
+          "minimum": 1
+        }
+      },
+      "required": ["start", "end"]
+    },
+    "language": {
+      "type": "string",
+      "description": "Document language hint (BCP-47)"
+    },
+    "source": {
+      "type": "object",
+      "description": "Source file metadata",
+      "required": ["relPath", "mime", "ext"],
+      "properties": {
+        "absPath": {
+          "type": "string",
+          "description": "Absolute path to source file"
+        },
+        "relPath": {
+          "type": "string",
+          "description": "Path relative to collection root"
+        },
+        "mime": {
+          "type": "string",
+          "description": "MIME type of source file"
+        },
+        "ext": {
+          "type": "string",
+          "description": "File extension",
+          "pattern": "^\\.[a-zA-Z0-9]+$"
+        },
+        "modifiedAt": {
+          "type": "string",
+          "description": "Last modification time (ISO 8601)",
+          "format": "date-time"
+        },
+        "sizeBytes": {
+          "type": "integer",
+          "description": "File size in bytes",
+          "minimum": 0
+        },
+        "sourceHash": {
+          "type": "string",
+          "description": "SHA-256 hash of source file"
+        }
+      }
+    },
+    "conversion": {
+      "type": "object",
+      "description": "Conversion metadata",
+      "properties": {
+        "converterId": {
+          "type": "string"
+        },
+        "converterVersion": {
+          "type": "string"
+        },
+        "mirrorHash": {
+          "type": "string"
+        }
+      }
+    },
+    "capabilities": {
+      "type": "object",
+      "required": [
+        "editable",
+        "tagsEditable",
+        "tagsWriteback",
+        "canCreateEditableCopy",
+        "mode"
+      ],
+      "properties": {
+        "editable": { "type": "boolean" },
+        "tagsEditable": { "type": "boolean" },
+        "tagsWriteback": { "type": "boolean" },
+        "canCreateEditableCopy": { "type": "boolean" },
+        "mode": {
+          "type": "string",
+          "enum": ["editable", "read_only"]
+        },
+        "reason": { "type": "string" }
+      }
+    },
+    "tags": {
+      "type": "array",
+      "description": "Tags associated with the document",
+      "items": {
+        "type": "string"
+      }
+    }
+  }
+}

package/spec/output-schemas/graph-query.schema.json

@@ -0,0 +1,99 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/graph-query@1.0",
+  "title": "GNO Graph Query",
+  "type": "object",
+  "required": ["schemaVersion", "root", "nodes", "edges", "meta"],
+  "properties": {
+    "schemaVersion": { "type": "string", "const": "1.0" },
+    "root": { "$ref": "#/definitions/node" },
+    "nodes": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/node" }
+    },
+    "edges": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "source",
+          "target",
+          "edgeType",
+          "relationType",
+          "confidence",
+          "edgeSource",
+          "depth"
+        ],
+        "properties": {
+          "source": { "type": "string", "pattern": "^#[a-f0-9]{6,}$" },
+          "target": { "type": "string", "pattern": "^#[a-f0-9]{6,}$" },
+          "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"]
+          },
+          "depth": { "type": "integer", "minimum": 1 }
+        },
+        "additionalProperties": false
+      }
+    },
+    "meta": {
+      "type": "object",
+      "required": [
+        "direction",
+        "edgeType",
+        "maxDepth",
+        "maxNodes",
+        "frontierLimit",
+        "visitedLimit",
+        "returnedNodes",
+        "returnedEdges",
+        "truncated",
+        "warnings"
+      ],
+      "properties": {
+        "direction": { "type": "string", "enum": ["out", "in", "both"] },
+        "edgeType": { "type": ["string", "null"] },
+        "maxDepth": { "type": "integer", "minimum": 1 },
+        "maxNodes": { "type": "integer", "minimum": 1 },
+        "frontierLimit": { "type": "integer", "minimum": 1 },
+        "visitedLimit": { "type": "integer", "minimum": 1 },
+        "returnedNodes": { "type": "integer", "minimum": 1 },
+        "returnedEdges": { "type": "integer", "minimum": 0 },
+        "truncated": { "type": "boolean" },
+        "warnings": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "node": {
+      "type": "object",
+      "required": [
+        "id",
+        "uri",
+        "title",
+        "collection",
+        "relPath",
+        "depth",
+        "graphHints"
+      ],
+      "properties": {
+        "id": { "type": "string", "pattern": "^#[a-f0-9]{6,}$" },
+        "uri": { "type": "string", "pattern": "^gno://.+" },
+        "title": { "type": ["string", "null"] },
+        "collection": { "type": "string" },
+        "relPath": { "type": "string" },
+        "depth": { "type": "integer", "minimum": 0 },
+        "graphHints": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    }
+  }
+}