@bluefly/openstandardagents 0.4.8 → 0.5.0

package/spec/v0.5/extensions/token-efficiency/token-efficiency.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.5/extensions/token-efficiency.schema.json",
+  "title": "OSSA Token Efficiency Extension",
+  "description": "Extension schema for token efficiency, budget management, knowledge graph refs, and model routing",
+  "type": "object",
+  "properties": {
+    "optimization": {
+      "type": "object",
+      "properties": {
+        "enabled": { "type": "boolean", "default": true },
+        "baseline_tokens": { "type": "integer" },
+        "target_tokens": { "type": "integer" },
+        "target_reduction": { "type": "string" },
+        "techniques": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "knowledge_graph_refs",
+              "template_compression",
+              "semantic_compression",
+              "dynamic_budgets",
+              "checkpoint_retry",
+              "cascade_composition",
+              "circuit_breaker",
+              "observation_masking",
+              "lazy_loading",
+              "hierarchical_context",
+              "intelligent_routing",
+              "prefiltering",
+              "manifest_fingerprint"
+            ]
+          }
+        },
+        "benchmarks": {
+          "type": "object",
+          "properties": {
+            "baseline": { "type": "object" },
+            "optimized": { "type": "object" },
+            "improvement": { "type": "object" }
+          }
+        }
+      }
+    }
+  }
+}

package/spec/v0.5/mcp.schema.json

@@ -0,0 +1 @@
+{"$schema":"http://json-schema.org/draft-07/schema#","$id":"https://openstandardagents.org/schemas/v0.4/mcp.schema.json","title":"OSSA v0.4 MCP Server Manifest Schema","description":"Open Standard for Software Agents (OSSA) - MCP Server manifest. Defines governed MCP server packages with identity, trust, and federation metadata.","type":"object","required":["apiVersion","kind","metadata","spec"],"properties":{"apiVersion":{"type":"string","pattern":"^ossa/v[0-9]+(\\.[0-9]+)*(-[a-zA-Z0-9.]+)?$","description":"OSSA API version","examples":["ossa/v1","ossa/v0.4"]},"kind":{"type":"string","const":"MCPServer","description":"Resource type — must be MCPServer"},"metadata":{"type":"object","required":["name"],"properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9-]*$","description":"DNS-style server name"},"version":{"type":"string","pattern":"^[0-9]+\\.[0-9]+\\.[0-9]+(-[a-zA-Z0-9.]+)?$"},"description":{"type":"string"},"did":{"type":"string","pattern":"^did:ossa:mcp:[a-z0-9-]+(:[a-z0-9-]+)*$","description":"Decentralized identifier for this MCP server"},"author":{"type":"object","properties":{"name":{"type":"string"},"did":{"type":"string"},"email":{"type":"string","format":"email"},"url":{"type":"string","format":"uri"}}},"license":{"type":"string"},"labels":{"type":"object","additionalProperties":{"type":"string"}},"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"}}},"spec":{"type":"object","required":["transport"],"properties":{"description":{"type":"string"},"transport":{"type":"string","enum":["stdio","sse","streamable-http"],"description":"MCP transport type"},"command":{"type":"string","description":"Command to start the MCP server (for stdio transport)"},"args":{"type":"array","items":{"type":"string"},"description":"Command arguments"},"url":{"type":"string","format":"uri","description":"Server URL (for SSE/HTTP transport)"},"env":{"type":"object","additionalProperties":{"type":"string"},"description":"Environment variables required"},"tools":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object"},"outputSchema":{"type":"object"}}},"description":"Declared tools this server provides"},"resources":{"type":"array","items":{"type":"object","properties":{"uri":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"}}},"description":"Resources this server exposes"},"prompts":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"arguments":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"required":{"type":"boolean"}}}}}},"description":"Prompts this server exposes"},"platforms":{"type":"array","items":{"type":"string"},"description":"Compatible platforms"},"governance":{"type":"object","properties":{"approvalRequired":{"type":"boolean","default":false},"dataAccess":{"type":"object","properties":{"filesystem":{"type":"string","enum":["none","read-only","read-write","scoped"]},"network":{"type":"string","enum":["none","allowlist","full"]}}},"prohibitedActions":{"type":"array","items":{"type":"string"}}}},"trust":{"type":"object","properties":{"attestation":{"type":"string","format":"uri"},"lastAudit":{"type":"string","format":"date-time"},"signatures":{"type":"array","items":{"type":"object","properties":{"signer":{"type":"string"},"algorithm":{"type":"string"},"value":{"type":"string"}}}}}},"compliance":{"type":"array","items":{"type":"string"}}}},"extensions":{"type":"object","additionalProperties":true}}}

package/spec/v0.5/role.schema.json

@@ -0,0 +1,268 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.5/role.schema.json",
+  "title": "OSSA v0.5 Role Manifest Schema",
+  "description": "Open Standard for Software Agents (OSSA) v0.5 - Role manifest. Defines behavioral overlays for IDE/CLI agents (Claude Code, Cursor, etc.) with instructions, tool sets, hooks, MCP connections, and activation conditions.",
+  "type": "object",
+  "required": ["apiVersion", "kind", "metadata", "spec"],
+  "properties": {
+    "apiVersion": {
+      "type": "string",
+      "pattern": "^ossa/v[0-9]+(\\.[0-9]+)*(-[a-zA-Z0-9.]+)?$",
+      "description": "OSSA API version",
+      "examples": ["ossa/v0.5", "ossa/v1"]
+    },
+    "kind": {
+      "type": "string",
+      "const": "Role",
+      "description": "Resource type — must be Role"
+    },
+    "metadata": {
+      "$ref": "#/definitions/RoleMetadata"
+    },
+    "spec": {
+      "$ref": "#/definitions/RoleSpec"
+    },
+    "extensions": {
+      "type": "object",
+      "description": "Platform-specific extensions",
+      "additionalProperties": true
+    }
+  },
+  "definitions": {
+    "RoleMetadata": {
+      "type": "object",
+      "required": ["name"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "description": "DNS-style role name (lowercase, hyphens)",
+          "examples": ["drupal-developer", "security-auditor", "platform-operator"]
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(-[a-zA-Z0-9.]+)?$",
+          "description": "Semantic version",
+          "examples": ["1.0.0", "2.1.0-beta"]
+        },
+        "description": {
+          "type": "string",
+          "description": "Human-readable description"
+        },
+        "labels": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "description": "Key-value labels for filtering and categorization"
+        },
+        "annotations": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "description": "Non-identifying metadata"
+        }
+      }
+    },
+    "RoleSpec": {
+      "type": "object",
+      "properties": {
+        "role": {
+          "type": "string",
+          "description": "System prompt / persona definition"
+        },
+        "instructions": {
+          "$ref": "#/definitions/RoleInstructions"
+        },
+        "tools": {
+          "$ref": "#/definitions/RoleTools"
+        },
+        "hooks": {
+          "$ref": "#/definitions/RoleHooks"
+        },
+        "context": {
+          "$ref": "#/definitions/RoleContext"
+        },
+        "protocols": {
+          "$ref": "#/definitions/RoleProtocols"
+        },
+        "extends": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/RoleExtension" },
+          "description": "Role composition — inherit from other roles"
+        },
+        "activation": {
+          "$ref": "#/definitions/RoleActivation"
+        }
+      }
+    },
+    "RoleInstructions": {
+      "type": "object",
+      "properties": {
+        "preamble": {
+          "type": "string",
+          "description": "Markdown content prepended to every conversation"
+        },
+        "constraints": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Hard rules — MUST/MUST NOT statements"
+        }
+      }
+    },
+    "RoleTools": {
+      "type": "object",
+      "properties": {
+        "allowed": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Whitelist of allowed tool names"
+        },
+        "denied": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Blacklist of denied tool names (overrides allowed)"
+        },
+        "skills": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "References to OSSA Skill manifests"
+        }
+      }
+    },
+    "RoleHooks": {
+      "type": "object",
+      "properties": {
+        "on_activate": {
+          "type": "string",
+          "description": "Run when role is activated"
+        },
+        "on_deactivate": {
+          "type": "string",
+          "description": "Run when switching away from this role"
+        },
+        "pre_commit": {
+          "type": "string",
+          "description": "Run before git commits"
+        },
+        "post_save": {
+          "type": "string",
+          "description": "Run after file saves"
+        }
+      }
+    },
+    "RoleContext": {
+      "type": "object",
+      "properties": {
+        "schemas": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Paths to JSON Schema or OpenAPI spec files"
+        },
+        "files": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/RoleContextFile" },
+          "description": "Files to include in agent context"
+        },
+        "knowledge": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Paths to knowledge base documents"
+        }
+      }
+    },
+    "RoleContextFile": {
+      "type": "object",
+      "required": ["path"],
+      "properties": {
+        "path": {
+          "type": "string",
+          "description": "File path or glob pattern"
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of what this file provides"
+        }
+      }
+    },
+    "RoleProtocols": {
+      "type": "object",
+      "properties": {
+        "mcp": {
+          "$ref": "#/definitions/RoleMCPConfig"
+        }
+      }
+    },
+    "RoleMCPConfig": {
+      "type": "object",
+      "properties": {
+        "servers": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/RoleMCPServer" },
+          "description": "MCP servers available when this role is active"
+        }
+      }
+    },
+    "RoleMCPServer": {
+      "type": "object",
+      "required": ["name", "transport"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Server identifier"
+        },
+        "transport": {
+          "type": "string",
+          "enum": ["stdio", "sse"],
+          "description": "Transport type"
+        },
+        "command": {
+          "type": "string",
+          "description": "Command to spawn (stdio transport)"
+        },
+        "args": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Command arguments (stdio transport)"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "Endpoint URL (SSE transport)"
+        }
+      }
+    },
+    "RoleExtension": {
+      "type": "object",
+      "required": ["role"],
+      "properties": {
+        "role": {
+          "type": "string",
+          "description": "Name of the parent role to inherit from"
+        },
+        "override": {
+          "type": "boolean",
+          "default": false,
+          "description": "If true, child fields replace parent fields; if false, they merge"
+        }
+      }
+    },
+    "RoleActivation": {
+      "type": "object",
+      "properties": {
+        "file_patterns": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Glob patterns — activate when matching files are open"
+        },
+        "command": {
+          "type": "string",
+          "description": "CLI command to activate (e.g., /role drupal)"
+        },
+        "env": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "description": "Environment variable conditions (all must match)"
+        }
+      }
+    }
+  }
+}

package/spec/v0.5/skill.schema.json

@@ -0,0 +1 @@
+{"$schema":"http://json-schema.org/draft-07/schema#","$id":"https://openstandardagents.org/schemas/v0.4/skill.schema.json","title":"OSSA v0.4 Skill Manifest Schema","description":"Open Standard for Software Agents (OSSA) - Skill manifest. Defines portable, governed skill packages with identity, trust, compliance, and federation metadata. Superset of the Agent Skills (SKILL.md) specification.","type":"object","required":["apiVersion","kind","metadata","spec"],"properties":{"apiVersion":{"type":"string","pattern":"^ossa/v[0-9]+(\\.[0-9]+)*(-[a-zA-Z0-9.]+)?$","description":"OSSA API version","examples":["ossa/v1","ossa/v0.4"]},"kind":{"type":"string","const":"Skill","description":"Resource type — must be Skill"},"metadata":{"$ref":"#/definitions/SkillMetadata"},"spec":{"$ref":"#/definitions/SkillSpec"},"extensions":{"type":"object","description":"Framework-specific extensions","additionalProperties":true}},"definitions":{"SkillMetadata":{"type":"object","required":["name"],"properties":{"name":{"type":"string","pattern":"^[a-z][a-z0-9-]*$","description":"DNS-style skill name (lowercase, hyphens)","examples":["drupal-code-analysis","tdd-workflow","git-commit-review"]},"version":{"type":"string","pattern":"^[0-9]+\\.[0-9]+\\.[0-9]+(-[a-zA-Z0-9.]+)?$","description":"Semantic version","examples":["1.0.0","2.1.0-beta"]},"description":{"type":"string","description":"Human-readable description (maps to SKILL.md description frontmatter)"},"did":{"type":"string","pattern":"^did:ossa:skill:[a-z0-9-]+(:[a-z0-9-]+)*$","description":"Decentralized identifier for this skill","examples":["did:ossa:skill:drupal-code-analysis"]},"author":{"$ref":"#/definitions/Author"},"license":{"type":"string","description":"SPDX license identifier","examples":["Apache-2.0","MIT","CC-BY-4.0"]},"labels":{"type":"object","additionalProperties":{"type":"string"},"description":"Key-value labels for filtering and categorization"},"annotations":{"type":"object","additionalProperties":{"type":"string"},"description":"Non-identifying metadata"},"created":{"type":"string","format":"date-time","description":"ISO 8601 creation timestamp"},"updated":{"type":"string","format":"date-time","description":"ISO 8601 last update timestamp"}}},"Author":{"type":"object","properties":{"name":{"type":"string","description":"Author display name"},"did":{"type":"string","pattern":"^did:ossa:author:[a-z0-9-]+(:[a-z0-9-]+)*$","description":"Author DID"},"email":{"type":"string","format":"email"},"url":{"type":"string","format":"uri"},"vc":{"type":"string","format":"uri","description":"URL to verifiable credential"}}},"SkillSpec":{"type":"object","required":["description"],"properties":{"description":{"type":"string","description":"When to activate this skill. Maps to SKILL.md description. Should include trigger phrases."},"instructions":{"type":"string","description":"Full skill instructions (markdown). The body of SKILL.md. Can use !include for external file."},"instructionsFile":{"type":"string","description":"Path to external instructions file (relative to manifest). Alternative to inline instructions."},"categories":{"type":"array","items":{"type":"string"},"description":"Categorization tags for discovery","examples":[["drupal","migration","code-analysis"]]},"platforms":{"type":"array","items":{"type":"string","examples":["claude-code","cursor","codex-cli","goose","windsurf","gemini-cli","github-copilot","kiro","roo-code"]},"description":"Compatible AI coding platforms"},"allowedTools":{"type":"array","items":{"type":"string"},"description":"Pre-approved tools list. Maps to SKILL.md allowed-tools frontmatter.","examples":[["bash","file_read","file_write","web_search"]]},"runtimes":{"type":"object","description":"Runtime requirements by language","properties":{"node":{"type":"string","description":"Node.js version constraint"},"python":{"type":"string","description":"Python version constraint"},"php":{"type":"string","description":"PHP version constraint"},"ruby":{"type":"string","description":"Ruby version constraint"},"go":{"type":"string","description":"Go version constraint"}},"additionalProperties":{"type":"string"}},"dependencies":{"$ref":"#/definitions/SkillDependencies"},"trust":{"$ref":"#/definitions/TrustInfo"},"governance":{"$ref":"#/definitions/GovernanceInfo"},"compliance":{"type":"array","items":{"type":"string"},"description":"Compliance framework tags","examples":[["FedRAMP-moderate","NIST-800-53","SOC2-Type2"]]},"resources":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","description":"Relative path to resource file"},"description":{"type":"string"}},"required":["path"]},"description":"Additional resource files (templates, configs, examples)"},"scripts":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","description":"Relative path to script"},"description":{"type":"string"},"when":{"type":"string","description":"When to run: setup, teardown, on-activate"}},"required":["path"]},"description":"Helper scripts whose output enters agent context"},"tests":{"type":"array","items":{"type":"object","properties":{"prompt":{"type":"string","description":"Test prompt to send to agent with this skill"},"expectedBehavior":{"type":"string","description":"What the agent should do"},"assertions":{"type":"array","items":{"type":"string"}}},"required":["prompt","expectedBehavior"]},"description":"Skill evaluation test cases"}}},"SkillDependencies":{"type":"object","properties":{"skills":{"type":"array","items":{"type":"object","properties":{"did":{"type":"string","description":"DID of required skill"},"name":{"type":"string","description":"Skill name (if no DID)"},"version":{"type":"string","description":"Semver range"},"required":{"type":"boolean","default":true}}},"description":"Other skills this skill depends on"},"mcp":{"type":"array","items":{"type":"object","properties":{"uri":{"type":"string","format":"uri","description":"MCP server URI"},"name":{"type":"string"},"required":{"type":"boolean","default":false}}},"description":"MCP servers this skill requires"},"tools":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["cli","api","mcp-tool","library"]},"version":{"type":"string"},"required":{"type":"boolean","default":true}},"required":["name"]},"description":"External tools this skill requires"}}},"TrustInfo":{"type":"object","properties":{"attestation":{"type":"string","format":"uri","description":"URL to cryptographic attestation document"},"testsPassed":{"type":"string","description":"Test results summary","examples":["47/47","12/12"]},"coverage":{"type":"string","description":"Test coverage percentage","examples":["94%","100%"]},"lastAudit":{"type":"string","format":"date-time","description":"Last security audit timestamp"},"signatures":{"type":"array","items":{"type":"object","properties":{"signer":{"type":"string"},"algorithm":{"type":"string","examples":["ed25519","rsa-sha256"]},"value":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}},"description":"Cryptographic signatures for tamper detection"}}},"GovernanceInfo":{"type":"object","properties":{"approvalRequired":{"type":"boolean","default":false,"description":"Whether org admin approval is needed to use this skill"},"maxAutonomy":{"type":"integer","minimum":0,"maximum":5,"description":"OSSA autonomy level (0=no autonomy, 5=full autonomy)"},"dataAccess":{"type":"object","properties":{"filesystem":{"type":"string","enum":["none","read-only","read-write","scoped"]},"network":{"type":"string","enum":["none","allowlist","full"]},"secrets":{"type":"string","enum":["none","read-only","read-write"]}},"description":"Data access boundaries"},"prohibitedActions":{"type":"array","items":{"type":"string"},"description":"Explicitly forbidden actions","examples":[["file_deletion","credential_access","external_network_calls"]]},"revocation":{"type":"object","properties":{"revoked":{"type":"boolean","default":false},"reason":{"type":"string"},"revokedAt":{"type":"string","format":"date-time"},"revokedBy":{"type":"string"}},"description":"Revocation status for compromised skills"}}}}}

package/spec/v0.5/validator.schema.json

@@ -0,0 +1,282 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.4.4/validator.schema.json",
+  "title": "OSSA v0.4.4 Validator Manifest Schema",
+  "description": "Validators are first-class OSSA agents (kind: Validator) that validate other agent manifests. Validators compose using the same operators as agents (>>, <||>, ? :) and are discoverable via the agent registry.",
+  "type": "object",
+  "required": [
+    "apiVersion",
+    "kind",
+    "metadata",
+    "spec"
+  ],
+  "properties": {
+    "apiVersion": {
+      "type": "string",
+      "const": "ossa/v0.4.4",
+      "description": "OSSA API version for validator manifests"
+    },
+    "kind": {
+      "type": "string",
+      "const": "Validator",
+      "description": "Resource type: Validator (validates other agents)"
+    },
+    "metadata": {
+      "type": "object",
+      "required": [
+        "name",
+        "agentType",
+        "agentKind"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Unique validator name (e.g., capability-compatibility-validator)"
+        },
+        "version": {
+          "type": "string",
+          "description": "Validator version (semver)",
+          "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$"
+        },
+        "description": {
+          "type": "string",
+          "description": "What this validator checks"
+        },
+        "agentType": {
+          "type": "string",
+          "const": "validator",
+          "description": "Validators have agentType: validator"
+        },
+        "agentKind": {
+          "type": "string",
+          "enum": [
+            "schema",
+            "semantic",
+            "platform",
+            "runtime",
+            "security",
+            "performance"
+          ],
+          "description": "Validator category: schema (JSON Schema), semantic (logic rules), platform (target compatibility), runtime (execution requirements), security (vulnerabilities), performance (optimization)"
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Tags for validator discovery"
+        }
+      }
+    },
+    "spec": {
+      "type": "object",
+      "required": [
+        "validates",
+        "rules"
+      ],
+      "properties": {
+        "validates": {
+          "type": "object",
+          "required": [
+            "targetTypes",
+            "phases"
+          ],
+          "properties": {
+            "targetTypes": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Agent types this validator applies to (e.g., ['claude', 'kagent'] or ['all'])",
+              "examples": [
+                ["claude", "kagent"],
+                ["all"]
+              ]
+            },
+            "phases": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "schema",
+                  "semantic",
+                  "platform",
+                  "runtime"
+                ]
+              },
+              "description": "Validation phases this validator runs in"
+            }
+          }
+        },
+        "rules": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ValidationRule"
+          },
+          "description": "Validation rules to execute"
+        },
+        "coordination": {
+          "type": "object",
+          "properties": {
+            "composable": {
+              "type": "boolean",
+              "description": "Whether this validator can compose with others",
+              "default": true
+            },
+            "operators": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [">>", "<||>", "? :"]
+              },
+              "description": "Composition operators supported (sequence >>, parallel <||>, conditional ? :)"
+            }
+          }
+        },
+        "dependencies": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Other validators this validator depends on"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "ValidationRule": {
+      "type": "object",
+      "required": [
+        "id",
+        "when",
+        "then"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique rule identifier"
+        },
+        "when": {
+          "type": "object",
+          "required": [
+            "path"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "description": "JSON path to check (e.g., 'metadata.agentType')"
+            },
+            "equals": {
+              "description": "Value must equal this"
+            },
+            "contains": {
+              "description": "Array must contain this value"
+            },
+            "matches": {
+              "type": "string",
+              "description": "Value must match this regex pattern"
+            },
+            "exists": {
+              "type": "boolean",
+              "description": "Path must exist (true) or not exist (false)"
+            }
+          }
+        },
+        "and": {
+          "type": "object",
+          "description": "Additional condition (both when and and must match)",
+          "$ref": "#/definitions/Condition"
+        },
+        "or": {
+          "type": "object",
+          "description": "Alternative condition (when or or must match)",
+          "$ref": "#/definitions/Condition"
+        },
+        "then": {
+          "type": "object",
+          "required": [
+            "enforcement",
+            "message"
+          ],
+          "properties": {
+            "enforcement": {
+              "type": "string",
+              "enum": ["error", "warning", "info"],
+              "description": "Severity level: error (blocks validation), warning (suggests improvement), info (informational)"
+            },
+            "message": {
+              "type": "string",
+              "description": "Human-readable validation message"
+            },
+            "rationale": {
+              "type": "string",
+              "description": "Why this rule exists (helps users understand the constraint)"
+            },
+            "fixes": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/Fix"
+              },
+              "description": "Suggested fixes (auto-fix proposals)"
+            },
+            "documentation": {
+              "type": "string",
+              "format": "uri",
+              "description": "Link to documentation explaining this rule"
+            }
+          }
+        }
+      }
+    },
+    "Condition": {
+      "type": "object",
+      "required": [
+        "path"
+      ],
+      "properties": {
+        "path": {
+          "type": "string"
+        },
+        "equals": {},
+        "contains": {},
+        "matches": {
+          "type": "string"
+        },
+        "exists": {
+          "type": "boolean"
+        }
+      }
+    },
+    "Fix": {
+      "type": "object",
+      "required": [
+        "action",
+        "path"
+      ],
+      "properties": {
+        "action": {
+          "type": "string",
+          "enum": ["add", "change", "remove", "compose"],
+          "description": "Fix action: add (add new field), change (modify existing), remove (delete field), compose (suggest composition)"
+        },
+        "path": {
+          "type": "string",
+          "description": "JSON path to modify"
+        },
+        "value": {
+          "description": "New value (for add/change actions)"
+        },
+        "impact": {
+          "type": "string",
+          "description": "Expected score impact (e.g., '+0.20 compatibility')",
+          "pattern": "^[+-]\\d+\\.\\d{2} [a-z]+"
+        },
+        "effort": {
+          "type": "string",
+          "enum": ["low", "medium", "high"],
+          "description": "Implementation effort estimate"
+        }
+      }
+    }
+  }
+}

package/node_modules/ajv/.runkit_example.js

@@ -1,23 +0,0 @@
-const Ajv = require("ajv")
-const ajv = new Ajv({allErrors: true})
-
-const schema = {
-  type: "object",
-  properties: {
-    foo: {type: "string"},
-    bar: {type: "number", maximum: 3},
-  },
-  required: ["foo", "bar"],
-  additionalProperties: false,
-}
-
-const validate = ajv.compile(schema)
-
-test({foo: "abc", bar: 2})
-test({foo: 2, bar: 4})
-
-function test(data) {
-  const valid = validate(data)
-  if (valid) console.log("Valid!")
-  else console.log("Invalid: " + ajv.errorsText(validate.errors))
-}