@raishin/vanguard-frontier-agentic 1.0.0

package/schemas/AGENTS.md

@@ -0,0 +1,11 @@
+# AGENTS.md
+
+## Purpose
+- Store JSON Schema contracts for catalog metadata and manifests.
+
+## Rules
+- Schema-required-field changes are breaking for npm consumers.
+- Keep schema enums aligned with validator constants in `tests/validate-catalog.py`.
+- Update `docs/release-versioning.md` if schema compatibility policy changes.
+- Run `npm run validate` after schema edits.
+

package/schemas/agent.schema.json

@@ -0,0 +1,96 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Agent Metadata",
+  "type": "object",
+  "required": [
+    "id",
+    "name",
+    "version",
+    "type",
+    "provider",
+    "harnesses",
+    "summary",
+    "source_type",
+    "official_docs",
+    "security_notes",
+    "last_verified",
+    "path"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "type": {
+      "const": "agent"
+    },
+    "provider": {
+      "enum": [
+        "aws",
+        "azure",
+        "oracle",
+        "oci",
+        "gcp",
+        "kubernetes",
+        "terraform",
+        "multi-cloud",
+        "generic"
+      ]
+    },
+    "harnesses": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "enum": [
+          "codex",
+          "copilot",
+          "claude-code",
+          "cursor",
+          "gemini",
+          "kiro",
+          "other"
+        ]
+      }
+    },
+    "summary": {
+      "type": "string",
+      "minLength": 20
+    },
+    "source_type": {
+      "enum": [
+        "original",
+        "adapted",
+        "reference-only"
+      ]
+    },
+    "official_docs": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "format": "uri"
+      }
+    },
+    "security_notes": {
+      "type": "string",
+      "minLength": 20
+    },
+    "last_verified": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+    },
+    "path": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/mcp-reference.schema.json

@@ -0,0 +1,116 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MCP Reference Metadata",
+  "type": "object",
+  "required": [
+    "id",
+    "name",
+    "type",
+    "provider",
+    "harnesses",
+    "summary",
+    "source_type",
+    "official_docs",
+    "security_notes",
+    "last_verified",
+    "path",
+    "official_project_url",
+    "vendor",
+    "auth_model",
+    "install_example",
+    "unofficial_warning"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "type": {
+      "const": "mcp-reference"
+    },
+    "provider": {
+      "enum": [
+        "aws",
+        "azure",
+        "oracle",
+        "oci",
+        "gcp",
+        "kubernetes",
+        "terraform",
+        "multi-cloud",
+        "generic"
+      ]
+    },
+    "harnesses": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "enum": [
+          "codex",
+          "copilot",
+          "claude-code",
+          "cursor",
+          "gemini",
+          "kiro",
+          "other"
+        ]
+      }
+    },
+    "summary": {
+      "type": "string",
+      "minLength": 20
+    },
+    "source_type": {
+      "enum": [
+        "original",
+        "adapted",
+        "reference-only"
+      ]
+    },
+    "official_docs": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "format": "uri"
+      }
+    },
+    "security_notes": {
+      "type": "string",
+      "minLength": 20
+    },
+    "last_verified": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+    },
+    "path": {
+      "type": "string",
+      "minLength": 1
+    },
+    "official_project_url": {
+      "type": "string",
+      "format": "uri"
+    },
+    "vendor": {
+      "type": "string",
+      "minLength": 1
+    },
+    "auth_model": {
+      "type": "string",
+      "minLength": 10
+    },
+    "install_example": {
+      "type": "string",
+      "minLength": 10
+    },
+    "unofficial_warning": {
+      "type": "string",
+      "minLength": 10
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/rule.schema.json

@@ -0,0 +1,91 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Rule Metadata",
+  "type": "object",
+  "required": [
+    "id",
+    "name",
+    "type",
+    "provider",
+    "harnesses",
+    "summary",
+    "source_type",
+    "official_docs",
+    "security_notes",
+    "last_verified",
+    "path"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "type": {
+      "const": "rule"
+    },
+    "provider": {
+      "enum": [
+        "aws",
+        "azure",
+        "oracle",
+        "oci",
+        "gcp",
+        "kubernetes",
+        "terraform",
+        "multi-cloud",
+        "generic"
+      ]
+    },
+    "harnesses": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "enum": [
+          "codex",
+          "copilot",
+          "claude-code",
+          "cursor",
+          "gemini",
+          "kiro",
+          "other"
+        ]
+      }
+    },
+    "summary": {
+      "type": "string",
+      "minLength": 20
+    },
+    "source_type": {
+      "enum": [
+        "original",
+        "adapted",
+        "reference-only"
+      ]
+    },
+    "official_docs": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "format": "uri"
+      }
+    },
+    "security_notes": {
+      "type": "string",
+      "minLength": 20
+    },
+    "last_verified": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+    },
+    "path": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/skill-manifest.schema.json

@@ -0,0 +1,76 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Skill Integrity Manifest",
+  "type": "object",
+  "required": [
+    "manifest_version",
+    "algorithm",
+    "root",
+    "entries"
+  ],
+  "properties": {
+    "manifest_version": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "algorithm": {
+      "const": "sha256"
+    },
+    "root": {
+      "const": "skills"
+    },
+    "entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "path",
+          "aggregate_sha256",
+          "files"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9][a-z0-9-]*$"
+          },
+          "path": {
+            "type": "string",
+            "pattern": "^skills/"
+          },
+          "aggregate_sha256": {
+            "type": "string",
+            "pattern": "^[a-f0-9]{64}$"
+          },
+          "files": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "path",
+                "sha256",
+                "bytes"
+              ],
+              "properties": {
+                "path": {
+                  "type": "string"
+                },
+                "sha256": {
+                  "type": "string",
+                  "pattern": "^[a-f0-9]{64}$"
+                },
+                "bytes": {
+                  "type": "integer",
+                  "minimum": 0
+                }
+              },
+              "additionalProperties": false
+            }
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/skill.schema.json

@@ -0,0 +1,96 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Skill Metadata",
+  "type": "object",
+  "required": [
+    "id",
+    "name",
+    "version",
+    "type",
+    "provider",
+    "harnesses",
+    "summary",
+    "source_type",
+    "official_docs",
+    "security_notes",
+    "last_verified",
+    "path"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "type": {
+      "const": "skill"
+    },
+    "provider": {
+      "enum": [
+        "aws",
+        "azure",
+        "oracle",
+        "oci",
+        "gcp",
+        "kubernetes",
+        "terraform",
+        "multi-cloud",
+        "generic"
+      ]
+    },
+    "harnesses": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "enum": [
+          "codex",
+          "copilot",
+          "claude-code",
+          "cursor",
+          "gemini",
+          "kiro",
+          "other"
+        ]
+      }
+    },
+    "summary": {
+      "type": "string",
+      "minLength": 20
+    },
+    "source_type": {
+      "enum": [
+        "original",
+        "adapted",
+        "reference-only"
+      ]
+    },
+    "official_docs": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "format": "uri"
+      }
+    },
+    "security_notes": {
+      "type": "string",
+      "minLength": 20
+    },
+    "last_verified": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+    },
+    "path": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "additionalProperties": true
+}