Initial commit

2025-11-30 08:49:50 +08:00
commit adc4b2be25
147 changed files with 24716 additions and 0 deletions
--- a/skills/mxcp-expert/assets/schemas/drift-snapshot-schema-1.json
+++ b/skills/mxcp-expert/assets/schemas/drift-snapshot-schema-1.json
@@ -0,0 +1,145 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MXCP Drift Snapshot",
+  "type": "object",
+  "required": ["version", "generated_at", "tables", "resources"],
+  "properties": {
+    "version": {
+      "type": "integer",
+      "description": "Version of the drift snapshot format. Must be 1.",
+      "enum": [1],
+      "default": 1
+    },
+    "generated_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp when the snapshot was generated"
+    },
+
+    "tables": {
+      "type": "array",
+      "description": "List of tables in the DuckDB catalog",
+      "items": {
+        "type": "object",
+        "required": ["name", "columns"],
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Name of the table"
+          },
+          "columns": {
+            "type": "array",
+            "description": "List of columns in the table",
+            "items": {
+              "type": "object",
+              "required": ["name", "type"],
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "description": "Name of the column"
+                },
+                "type": {
+                  "type": "string",
+                  "description": "DuckDB data type of the column"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "resources": {
+      "type": "array",
+      "description": "List of resources with validation results, test results, and definition",
+      "items": {
+        "type": "object",
+        "required": ["validation_results"],
+        "properties": {
+          "validation_results": {
+            "type": "object",
+            "required": ["status", "path"],
+            "properties": {
+              "status": {
+                "type": "string",
+                "enum": ["ok", "error"],
+                "description": "Validation status"
+              },
+              "path": {
+                "type": "string",
+                "description": "Path to the endpoint file (relative to repository root)"
+              },
+              "message": {
+                "type": "string",
+                "description": "Error message if validation failed"
+              }
+            },
+            "description": "Results of validation for the resource"
+          },
+          "test_results": {
+            "type": "object",
+            "required": ["status", "tests_run"],
+            "properties": {
+              "status": {
+                "type": "string",
+                "enum": ["ok", "error", "failed"],
+                "description": "Test execution status"
+              },
+              "tests_run": {
+                "type": "integer",
+                "description": "Number of tests run"
+              },
+              "tests": {
+                "type": "array",
+                "description": "List of per-test results",
+                "items": {
+                  "type": "object",
+                  "required": ["name", "status", "time"],
+                  "properties": {
+                    "name": {
+                      "type": "string",
+                      "description": "Name of the test"
+                    },
+                    "description": {
+                      "type": "string",
+                      "description": "Description of the test"
+                    },
+                    "status": {
+                      "type": "string",
+                      "enum": ["passed", "failed", "error"],
+                      "description": "Test status"
+                    },
+                    "error": {
+                      "type": "string",
+                      "description": "Error message if test failed"
+                    },
+                    "time": {
+                      "type": "number",
+                      "description": "Time taken to run the test in seconds"
+                    }
+                  }
+                }
+              }
+            },
+            "description": "Results of tests for the resource"
+          },
+          "definition": {
+            "oneOf": [
+              { "$ref": "../../endpoints/endpoint_schemas/tool-schema-1.json#/definitions/toolDefinition" },
+              { "$ref": "../../endpoints/endpoint_schemas/resource-schema-1.json#/definitions/resourceDefinition" },
+              { "$ref": "../../endpoints/endpoint_schemas/prompt-schema-1.json#/definitions/promptDefinition" }
+            ],
+            "description": "Endpoint definition"
+          },
+          "metadata": {
+            "type": "object",
+            "properties": {
+              "title": { "type": "string", "description": "Short display title" },
+              "description": { "type": "string", "description": "Longer description" }
+            },
+            "description": "Optional metadata for documentation purposes"
+          }
+        }
+      }
+    }
+  }
+}