@gmickel/gno 1.25.1 → 1.27.0

package/spec/output-schemas/project-profile-apply.schema.json

@@ -0,0 +1,209 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/project-profile-apply@1.0",
+  "title": "GNO Project Profile Apply Result",
+  "description": "Deterministic, path-redacted receipt for create/update-only project profile application.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "command",
+    "status",
+    "applied",
+    "discovery",
+    "receipt",
+    "diagnostics"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "command": { "const": "apply" },
+    "status": {
+      "enum": [
+        "applied",
+        "unchanged",
+        "invalid",
+        "not_found",
+        "disabled",
+        "failed"
+      ]
+    },
+    "applied": { "type": "boolean" },
+    "discovery": { "$ref": "#/definitions/discovery" },
+    "receipt": {
+      "oneOf": [{ "$ref": "#/definitions/receipt" }, { "type": "null" }]
+    },
+    "diagnostics": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/diagnostic" }
+    }
+  },
+  "definitions": {
+    "diagnostic": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "severity", "path", "message", "remediation"],
+      "properties": {
+        "code": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]*$" },
+        "severity": { "enum": ["error", "warning"] },
+        "path": { "type": "string" },
+        "message": { "type": "string", "minLength": 1 },
+        "remediation": { "type": "string", "minLength": 1 }
+      }
+    },
+    "discovery": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "status",
+        "source",
+        "boundary",
+        "profile",
+        "ambiguous",
+        "shadowedProfiles"
+      ],
+      "properties": {
+        "status": { "enum": ["found", "not_found", "disabled", "error"] },
+        "source": { "enum": ["cwd", "override", "remote"] },
+        "boundary": {
+          "enum": ["repository", "filesystem", "explicit", "remote"]
+        },
+        "profile": {
+          "type": ["string", "null"],
+          "enum": [".gno/index.yml", null]
+        },
+        "ambiguous": { "type": "boolean" },
+        "shadowedProfiles": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "change": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "field", "destructive", "summary"],
+      "properties": {
+        "action": { "enum": ["add", "update", "repair", "review"] },
+        "field": { "type": "string", "minLength": 1 },
+        "destructive": { "const": false },
+        "summary": { "type": "string", "minLength": 1 }
+      }
+    },
+    "staleMapping": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["collection", "reason", "choices"],
+      "properties": {
+        "collection": { "type": "string", "minLength": 1 },
+        "reason": { "enum": ["name_changed", "root_changed"] },
+        "choices": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 2,
+          "items": { "enum": ["repair", "remove_explicitly"] }
+        }
+      }
+    },
+    "diff": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "changes", "staleMappings"],
+      "properties": {
+        "status": { "enum": ["in_sync", "changes_required"] },
+        "changes": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/change" }
+        },
+        "staleMappings": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/staleMapping" }
+        }
+      }
+    },
+    "resource": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "id", "disposition", "pendingIndexing"],
+      "properties": {
+        "kind": {
+          "enum": [
+            "capability",
+            "collection",
+            "content_type",
+            "contexts",
+            "profile_binding",
+            "project_affinity",
+            "stale_mapping"
+          ]
+        },
+        "id": { "type": "string", "minLength": 1 },
+        "disposition": {
+          "enum": ["created", "reused", "updated", "skipped"]
+        },
+        "pendingIndexing": { "type": "boolean" }
+      }
+    },
+    "receipt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schemaVersion",
+        "command",
+        "status",
+        "profile",
+        "diff",
+        "resources",
+        "pendingIndexing",
+        "diagnostics"
+      ],
+      "properties": {
+        "schemaVersion": { "const": "1.0" },
+        "command": { "const": "apply" },
+        "status": { "enum": ["applied", "unchanged"] },
+        "profile": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["fingerprint"],
+          "properties": {
+            "fingerprint": {
+              "type": "string",
+              "pattern": "^[a-f0-9]{64}$"
+            }
+          }
+        },
+        "diff": { "$ref": "#/definitions/diff" },
+        "resources": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/resource" }
+        },
+        "pendingIndexing": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "diagnostics": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/diagnostic" }
+        }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "status": { "enum": ["applied", "unchanged"] }
+        },
+        "required": ["status"]
+      },
+      "then": {
+        "properties": {
+          "receipt": { "$ref": "#/definitions/receipt" }
+        }
+      },
+      "else": {
+        "properties": {
+          "receipt": { "type": "null" },
+          "applied": { "const": false }
+        }
+      }
+    }
+  ]
+}

package/spec/output-schemas/project-profile-command.schema.json

@@ -0,0 +1,160 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/project-profile-command@1.0",
+  "title": "GNO Project Profile Read Command",
+  "description": "Deterministic, path-redacted result shared by profile check, show, and diff.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "command",
+    "status",
+    "valid",
+    "discovery",
+    "profile",
+    "diff",
+    "diagnostics"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "command": { "enum": ["check", "show", "diff"] },
+    "status": { "enum": ["valid", "invalid", "not_found", "disabled"] },
+    "valid": { "type": "boolean" },
+    "discovery": { "$ref": "#/definitions/discovery" },
+    "profile": {
+      "oneOf": [{ "$ref": "#/definitions/profile" }, { "type": "null" }]
+    },
+    "diff": {
+      "oneOf": [{ "$ref": "#/definitions/diff" }, { "type": "null" }]
+    },
+    "diagnostics": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/diagnostic" }
+    }
+  },
+  "definitions": {
+    "diagnostic": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "severity", "path", "message", "remediation"],
+      "properties": {
+        "code": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]*$" },
+        "severity": { "enum": ["error", "warning"] },
+        "path": { "type": "string" },
+        "message": { "type": "string", "minLength": 1 },
+        "remediation": { "type": "string", "minLength": 1 }
+      }
+    },
+    "discovery": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "status",
+        "source",
+        "boundary",
+        "profile",
+        "ambiguous",
+        "shadowedProfiles"
+      ],
+      "properties": {
+        "status": { "enum": ["found", "not_found", "disabled", "error"] },
+        "source": { "enum": ["cwd", "override", "remote"] },
+        "boundary": {
+          "enum": ["repository", "filesystem", "explicit", "remote"]
+        },
+        "profile": {
+          "type": ["string", "null"],
+          "enum": [".gno/index.yml", null]
+        },
+        "ambiguous": { "type": "boolean" },
+        "shadowedProfiles": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "profile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["fingerprint", "desiredState"],
+      "properties": {
+        "fingerprint": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "desiredState": {
+          "oneOf": [{ "type": "object" }, { "type": "null" }]
+        }
+      }
+    },
+    "change": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "field", "destructive", "summary"],
+      "properties": {
+        "action": { "enum": ["add", "update", "repair", "review"] },
+        "field": { "type": "string", "minLength": 1 },
+        "destructive": { "type": "boolean" },
+        "summary": { "type": "string", "minLength": 1 }
+      }
+    },
+    "staleMapping": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["collection", "reason", "choices"],
+      "properties": {
+        "collection": { "type": "string", "minLength": 1 },
+        "reason": { "enum": ["name_changed", "root_changed"] },
+        "choices": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 2,
+          "items": { "enum": ["repair", "remove_explicitly"] }
+        }
+      }
+    },
+    "diff": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "changes", "staleMappings"],
+      "properties": {
+        "status": { "enum": ["in_sync", "changes_required"] },
+        "changes": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/change" }
+        },
+        "staleMappings": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/staleMapping" }
+        }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": { "valid": { "const": true } },
+        "required": ["valid"]
+      },
+      "then": {
+        "properties": {
+          "status": { "const": "valid" },
+          "profile": { "$ref": "#/definitions/profile" }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "command": { "const": "diff" } },
+        "required": ["command"]
+      },
+      "then": {
+        "properties": {
+          "diff": {
+            "oneOf": [{ "$ref": "#/definitions/diff" }, { "type": "null" }]
+          }
+        }
+      },
+      "else": {
+        "properties": { "diff": { "type": "null" } }
+      }
+    }
+  ]
+}

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

@@ -1,11 +1,11 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "gno://schemas/query-diagnose@1.1",
+  "$id": "gno://schemas/query-diagnose@1.2",
   "title": "GNO Query Diagnose",
   "type": "object",
   "required": ["schemaVersion", "query", "target", "stages", "chunk", "meta"],
   "properties": {
-    "schemaVersion": { "type": "string", "enum": ["1.0", "1.1"] },
+    "schemaVersion": { "type": "string", "enum": ["1.0", "1.1", "1.2"] },
     "query": { "type": "string" },
     "target": {
       "type": "object",
@@ -149,11 +149,62 @@
         },
         "source": {
           "type": ["string", "null"],
-          "enum": ["cli_cwd", "cli_explicit", "cli_worktree", null]
+          "enum": [
+            "cli_cwd",
+            "cli_explicit",
+            "cli_worktree",
+            "project_profile",
+            null
+          ]
         }
       },
       "additionalProperties": false
     },
+    "contentTypeBoost": {
+      "type": "object",
+      "required": [
+        "baseScore",
+        "cappedContribution",
+        "combinedAuxiliaryApplied",
+        "combinedAuxiliaryCap",
+        "combinedAuxiliaryRequested",
+        "configuredFactor",
+        "contentType",
+        "finalScore",
+        "rawContribution",
+        "rawScore",
+        "rawScoreKind",
+        "ruleSource",
+        "rulesFingerprint"
+      ],
+      "properties": {
+        "baseScore": { "type": "number", "minimum": 0, "maximum": 1 },
+        "cappedContribution": {
+          "type": "number",
+          "minimum": -0.05,
+          "maximum": 0.05
+        },
+        "combinedAuxiliaryApplied": {
+          "type": "number",
+          "minimum": -0.08,
+          "maximum": 0.08
+        },
+        "combinedAuxiliaryCap": { "type": "number", "const": 0.08 },
+        "combinedAuxiliaryRequested": { "type": "number" },
+        "configuredFactor": { "type": "number", "minimum": 0.5, "maximum": 2 },
+        "contentType": { "type": "string" },
+        "finalScore": { "type": "number", "minimum": 0, "maximum": 1 },
+        "rawContribution": { "type": "number" },
+        "rawScore": { "type": "number" },
+        "rawScoreKind": {
+          "type": "string",
+          "enum": ["bm25", "hybrid_blended", "normalized", "vector_distance"]
+        },
+        "ruleSource": { "type": "string", "enum": ["configured-id", "prefix"] },
+        "rulesFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+      },
+      "additionalProperties": false
+    },
     "chunk": {
       "type": "object",
       "required": ["seq", "startLine", "endLine", "language"],
@@ -193,7 +244,9 @@
         "properties": { "schemaVersion": { "const": "1.0" } },
         "required": ["schemaVersion"]
       },
-      "then": { "properties": { "affinity": false } }
+      "then": {
+        "properties": { "affinity": false, "contentTypeBoost": false }
+      }
     },
     {
       "if": {
@@ -201,9 +254,19 @@
         "required": ["schemaVersion"]
       },
       "then": {
-        "properties": { "affinity": {} },
+        "properties": { "affinity": {}, "contentTypeBoost": false },
         "required": ["affinity"]
       }
+    },
+    {
+      "if": {
+        "properties": { "schemaVersion": { "const": "1.2" } },
+        "required": ["schemaVersion"]
+      },
+      "then": {
+        "properties": { "contentTypeBoost": {} },
+        "required": ["contentTypeBoost"]
+      }
     }
   ],
   "additionalProperties": false

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

@@ -166,7 +166,78 @@
             "type": "string"
           }
         }
-      }
+      },
+      "additionalProperties": false
+    },
+    "contentTypeBoost": {
+      "type": "object",
+      "required": [
+        "baseScore",
+        "cappedContribution",
+        "combinedAuxiliaryApplied",
+        "combinedAuxiliaryCap",
+        "combinedAuxiliaryRequested",
+        "configuredFactor",
+        "contentType",
+        "finalScore",
+        "rawContribution",
+        "rawScore",
+        "rawScoreKind",
+        "ruleSource",
+        "rulesFingerprint"
+      ],
+      "properties": {
+        "baseScore": { "type": "number", "minimum": 0, "maximum": 1 },
+        "cappedContribution": {
+          "type": "number",
+          "minimum": -0.05,
+          "maximum": 0.05
+        },
+        "combinedAuxiliaryApplied": {
+          "type": "number",
+          "minimum": -0.08,
+          "maximum": 0.08
+        },
+        "combinedAuxiliaryCap": { "type": "number", "const": 0.08 },
+        "combinedAuxiliaryRequested": { "type": "number" },
+        "configuredFactor": { "type": "number", "minimum": 0.5, "maximum": 2 },
+        "contentType": { "type": "string" },
+        "finalScore": { "type": "number", "minimum": 0, "maximum": 1 },
+        "rawContribution": { "type": "number" },
+        "rawScore": { "type": "number" },
+        "rawScoreKind": {
+          "type": "string",
+          "enum": ["bm25", "hybrid_blended", "normalized", "vector_distance"]
+        },
+        "ruleSource": { "type": "string", "enum": ["configured-id", "prefix"] },
+        "rulesFingerprint": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+      },
+      "additionalProperties": false
+    },
+    "explainLine": {
+      "type": "object",
+      "required": ["stage", "message"],
+      "properties": {
+        "stage": { "type": "string" },
+        "message": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "explainResult": {
+      "type": "object",
+      "required": ["rank", "docid", "score"],
+      "properties": {
+        "rank": { "type": "integer", "minimum": 1 },
+        "docid": { "type": "string", "pattern": "^#[a-f0-9]{6,8}$" },
+        "score": { "type": "number" },
+        "fusionScore": { "type": "number" },
+        "bm25Score": { "type": "number" },
+        "vecScore": { "type": "number" },
+        "rerankScore": { "type": "number" },
+        "projectAffinity": { "type": "object" },
+        "contentTypeBoost": { "$ref": "#/$defs/contentTypeBoost" }
+      },
+      "additionalProperties": false
     }
   },
   "properties": {
@@ -331,6 +402,21 @@
           "type": "array",
           "items": { "type": "string" },
           "description": "Tags ANY filter applied (if any)"
+        },
+        "explain": {
+          "type": "object",
+          "required": ["lines", "results"],
+          "properties": {
+            "lines": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/explainLine" }
+            },
+            "results": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/explainResult" }
+            }
+          },
+          "additionalProperties": false
         }
       }
     }

package/spec/output-schemas/setup-profile-result.schema.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "gno://schemas/setup-profile-result@1.0",
+  "title": "GNO Setup Profile Result",
+  "description": "Closed opt-in project-profile apply composition around verified setup and optional connectors.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "status", "profile", "setup", "connectors"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "status": {
+      "enum": ["completed", "completed_with_actions", "failed"]
+    },
+    "profile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["check", "apply"],
+      "properties": {
+        "check": {
+          "allOf": [
+            { "$ref": "gno://schemas/project-profile-command@1.0" },
+            {
+              "type": "object",
+              "properties": { "command": { "const": "check" } },
+              "required": ["command"]
+            }
+          ]
+        },
+        "apply": {
+          "oneOf": [
+            { "$ref": "gno://schemas/project-profile-apply@1.0" },
+            { "type": "null" }
+          ]
+        }
+      }
+    },
+    "setup": { "$ref": "gno://schemas/setup-command-result@1.0" },
+    "connectors": {
+      "$ref": "gno://schemas/setup-activation-result@1.0#/properties/connectors"
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": { "status": { "const": "completed" } },
+        "required": ["status"]
+      },
+      "then": {
+        "properties": {
+          "profile": {
+            "type": "object",
+            "properties": {
+              "check": {
+                "type": "object",
+                "properties": { "status": { "const": "valid" } }
+              },
+              "apply": {
+                "type": "object",
+                "properties": {
+                  "status": { "enum": ["applied", "unchanged"] }
+                }
+              }
+            }
+          },
+          "setup": {
+            "type": "object",
+            "properties": { "status": { "const": "completed" } }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "status": { "const": "failed" } },
+        "required": ["status"]
+      },
+      "then": {
+        "properties": {
+          "setup": {
+            "type": "object",
+            "properties": { "status": { "const": "failed" } }
+          }
+        }
+      }
+    }
+  ]
+}