@mcptoolshop/accessibility-suite 0.1.0

package/docs/prov-spec/spec/schemas/mcp.envelope.schema.v0.1.json

@@ -0,0 +1,141 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "mcp.envelope.v0.1",
+  "title": "mcp.envelope.v0.1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "result"],
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "const": "mcp.envelope.v0.1"
+    },
+
+    "result": {
+      "description": "Tool-specific payload. This schema intentionally does not constrain result shape.",
+      "type": ["object", "array", "string", "number", "boolean", "null"]
+    },
+
+    "provenance": {
+      "description": "Optional provenance record for this tool invocation.",
+      "anyOf": [
+        { "$ref": "prov.record.schema.v0.1.json" },
+        { "type": "null" }
+      ]
+    },
+
+    "errors": {
+      "description": "Optional structured errors emitted by the tool or adapter. Tools may also encode errors inside result; this field exists for standardization.",
+      "type": "array",
+      "items": { "$ref": "#/$defs/envelope_error" }
+    },
+
+    "warnings": {
+      "description": "Optional non-fatal warnings (e.g., degraded confidence, partial parsing).",
+      "type": "array",
+      "items": { "$ref": "#/$defs/envelope_warning" }
+    },
+
+    "meta": {
+      "description": "Optional adapter/runtime metadata. Not part of tool semantics.",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "adapter": {
+          "type": "string",
+          "description": "Adapter name (e.g., mcp, cli, api).",
+          "maxLength": 100
+        },
+        "request_id": {
+          "type": "string",
+          "description": "Optional request correlation ID.",
+          "maxLength": 200
+        },
+        "duration_ms": {
+          "type": "integer",
+          "description": "Optional duration in milliseconds.",
+          "minimum": 0
+        },
+        "schema_hints": {
+          "type": "object",
+          "description": "Optional hints about schemas used in result, if result is opaque to the caller.",
+          "additionalProperties": {
+            "type": "string",
+            "maxLength": 200
+          }
+        }
+      }
+    }
+  },
+
+  "$defs": {
+    "envelope_error": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "message"],
+      "properties": {
+        "code": {
+          "type": "string",
+          "description": "Stable error code (namespaced).",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "message": {
+          "type": "string",
+          "description": "Human-readable error message.",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "details": {
+          "type": "object",
+          "description": "Optional structured details (small).",
+          "additionalProperties": {
+            "type": ["string", "number", "boolean", "null"]
+          }
+        },
+        "retryable": {
+          "type": "boolean",
+          "description": "Whether retrying might succeed.",
+          "default": false
+        },
+        "evidence": {
+          "type": "array",
+          "description": "Optional evidence anchors supporting this error.",
+          "items": { "$ref": "evidence.schema.v0.1.json" }
+        }
+      }
+    },
+
+    "envelope_warning": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "message"],
+      "properties": {
+        "code": {
+          "type": "string",
+          "description": "Stable warning code (namespaced).",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "message": {
+          "type": "string",
+          "description": "Human-readable warning message.",
+          "minLength": 1,
+          "maxLength": 2000
+        },
+        "details": {
+          "type": "object",
+          "description": "Optional structured details (small).",
+          "additionalProperties": {
+            "type": ["string", "number", "boolean", "null"]
+          }
+        },
+        "evidence": {
+          "type": "array",
+          "description": "Optional evidence anchors supporting this warning.",
+          "items": { "$ref": "evidence.schema.v0.1.json" }
+        }
+      }
+    }
+  }
+}

package/docs/prov-spec/spec/schemas/mcp.request.schema.v0.1.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "mcp.request.v0.1",
+  "title": "mcp.request.v0.1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "tool", "params", "artifacts"],
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "const": "mcp.request.v0.1"
+    },
+
+    "request_id": {
+      "type": "string",
+      "description": "Optional correlation ID for tracing across systems.",
+      "maxLength": 200
+    },
+
+    "tool": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Tool identifier (e.g., a11y-assist.explain, provenance.verify).",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "version": {
+          "type": "string",
+          "description": "Optional requested tool version (semver string or tag).",
+          "maxLength": 100
+        }
+      }
+    },
+
+    "params": {
+      "description": "Tool-specific parameters. This schema intentionally does not constrain param shape.",
+      "type": ["object", "array", "string", "number", "boolean", "null"]
+    },
+
+    "artifacts": {
+      "type": "array",
+      "description": "Optional artifact references supplied as inputs to this call. Tools may ignore if not applicable.",
+      "items": { "$ref": "artifact.ref.schema.v0.1.json" }
+    },
+
+    "preferences": {
+      "type": "object",
+      "description": "Optional execution preferences that are not tool semantics.",
+      "additionalProperties": false,
+      "properties": {
+        "deterministic": {
+          "type": "boolean",
+          "description": "Hint that caller prefers deterministic behavior (no timestamps, no network).",
+          "default": true
+        },
+        "max_output_bytes": {
+          "type": "integer",
+          "description": "Optional soft limit for output size.",
+          "minimum": 0
+        },
+        "locale": {
+          "type": "string",
+          "description": "Optional locale hint (e.g., en-US).",
+          "maxLength": 50
+        }
+      }
+    },
+
+    "time": {
+      "type": "string",
+      "description": "Optional RFC3339 timestamp. Omit for strict determinism.",
+      "format": "date-time"
+    }
+  }
+}

package/docs/prov-spec/spec/schemas/methods.schema.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "methods.schema.json",
+  "title": "Provenance Methods Catalog Schema",
+  "description": "Schema for the machine-readable method ID catalog",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "methods", "namespaces"],
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "schema_version": {
+      "type": "string",
+      "const": "methods-catalog@v0.1"
+    },
+    "generated": {
+      "type": "boolean",
+      "description": "Whether this file was auto-generated"
+    },
+    "methods": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/method_entry"
+      }
+    },
+    "namespaces": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/$defs/namespace_entry"
+      }
+    }
+  },
+  "$defs": {
+    "method_entry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "namespace", "status", "since", "summary"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*(_v[0-9]+_[0-9]+)?$",
+          "description": "The stable method identifier"
+        },
+        "namespace": {
+          "type": "string",
+          "description": "Primary namespace (first segment of id)"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["stable", "deprecated", "experimental"],
+          "description": "Lifecycle status"
+        },
+        "since": {
+          "type": "string",
+          "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+          "description": "Version when this method was introduced"
+        },
+        "superseded_by": {
+          "type": "string",
+          "description": "Replacement method ID if deprecated"
+        },
+        "summary": {
+          "type": "string",
+          "description": "Brief description of what the method means"
+        },
+        "when_to_emit": {
+          "type": "string",
+          "description": "Conditions under which to claim this method"
+        },
+        "requires": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Semantic requirements when claiming this method"
+        }
+      }
+    },
+    "namespace_entry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["description", "status"],
+      "properties": {
+        "description": {
+          "type": "string"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["stable", "reserved", "deprecated"]
+        }
+      }
+    }
+  }
+}

package/docs/prov-spec/spec/schemas/prov-capabilities.schema.json

@@ -0,0 +1,122 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "prov-capabilities.schema.json",
+  "title": "Provenance Capabilities Manifest",
+  "description": "Schema for third-party engine capability declarations",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "engine", "implements"],
+  "properties": {
+    "schema": {
+      "type": "string",
+      "const": "prov-capabilities@v0.1",
+      "description": "Manifest schema identifier"
+    },
+    "engine": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100,
+          "description": "Engine name"
+        },
+        "version": {
+          "type": "string",
+          "maxLength": 50,
+          "description": "Engine version (semver recommended)"
+        },
+        "vendor": {
+          "type": "string",
+          "maxLength": 200,
+          "description": "Vendor or maintainer name"
+        },
+        "repo": {
+          "type": "string",
+          "format": "uri",
+          "description": "Source repository URL"
+        },
+        "license": {
+          "type": "string",
+          "description": "SPDX license identifier"
+        }
+      }
+    },
+    "implements": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*(_v[0-9]+_[0-9]+)?$"
+      },
+      "minItems": 1,
+      "uniqueItems": true,
+      "description": "Method IDs this engine fully implements"
+    },
+    "optional": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*(_v[0-9]+_[0-9]+)?$"
+      },
+      "uniqueItems": true,
+      "description": "Method IDs this engine optionally supports"
+    },
+    "conformance_level": {
+      "type": "string",
+      "enum": ["syntax-conformant", "semantics-conformant", "fully-conformant"],
+      "default": "syntax-conformant",
+      "description": "Declared conformance level per PROV_METHODS_SPEC.md Section 9.1"
+    },
+    "constraints": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "canonicalization": {
+          "type": "string",
+          "enum": ["jcs-subset", "jcs-full", "custom"],
+          "description": "JSON canonicalization method used"
+        },
+        "max_record_bytes": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Maximum provenance record size in bytes"
+        },
+        "max_artifacts": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Maximum artifacts per record"
+        },
+        "supported_digest_algorithms": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["sha256", "sha512", "blake3"]
+          },
+          "description": "Digest algorithms this engine can compute"
+        }
+      }
+    },
+    "test_vectors_validated": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "List of test vector IDs that have been validated"
+    },
+    "known_deviations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "method_id": { "type": "string" },
+          "deviation": { "type": "string" },
+          "reason": { "type": "string" }
+        },
+        "required": ["method_id", "deviation"]
+      },
+      "description": "Documented deviations from spec"
+    }
+  }
+}

package/docs/prov-spec/spec/schemas/prov.record.schema.v0.1.json

@@ -0,0 +1,133 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "prov.record.v0.1",
+  "title": "prov.record.v0.1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "run_id", "tool", "inputs", "outputs", "methods", "evidence", "parents"],
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "const": "prov.record.v0.1"
+    },
+    "run_id": {
+      "type": "string",
+      "description": "Unique identifier for this tool run (UUID recommended).",
+      "minLength": 1
+    },
+    "tool": {
+      "type": "object",
+      "description": "Tool identity and versioning metadata.",
+      "additionalProperties": false,
+      "required": ["name", "version"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Tool name, e.g., a11y-assist, payroll-engine, etc.",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "version": {
+          "type": "string",
+          "description": "Tool version string, e.g., v0.3.1.",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "adapter": {
+          "type": "string",
+          "description": "Optional adapter name, e.g., cli, mcp, api.",
+          "maxLength": 100
+        }
+      }
+    },
+    "time": {
+      "type": "string",
+      "description": "Optional RFC3339 timestamp. Omit for strict determinism.",
+      "format": "date-time"
+    },
+    "inputs": {
+      "type": "array",
+      "description": "Artifacts consumed by this run.",
+      "items": { "$ref": "artifact.schema.v0.1.json" }
+    },
+    "outputs": {
+      "type": "array",
+      "description": "Artifacts produced by this run.",
+      "items": { "$ref": "artifact.schema.v0.1.json" }
+    },
+    "methods": {
+      "type": "array",
+      "description": "Stable method identifiers applied during this run (append-only over time).",
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 200,
+        "pattern": "^[a-z0-9]+([._-][a-z0-9]+)*$"
+      }
+    },
+    "evidence": {
+      "type": "array",
+      "description": "Evidence mappings from outputs back to input sources.",
+      "items": { "$ref": "evidence.schema.v0.1.json" }
+    },
+    "parents": {
+      "type": "array",
+      "description": "Lineage references to prior run IDs that this run depends on.",
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 200
+      }
+    },
+    "integrity": {
+      "type": "object",
+      "description": "Optional integrity metadata for the provenance record itself.",
+      "additionalProperties": false,
+      "properties": {
+        "record_digest": {
+          "type": "object",
+          "description": "Digest over a canonical serialization of this provenance record (excluding signatures).",
+          "additionalProperties": false,
+          "required": ["alg", "value"],
+          "properties": {
+            "alg": {
+              "type": "string",
+              "enum": ["sha256", "sha512", "blake3"]
+            },
+            "value": {
+              "type": "string",
+              "pattern": "^[0-9a-fA-F]+$",
+              "minLength": 16
+            }
+          }
+        },
+        "signature": {
+          "type": "object",
+          "description": "Optional signature over record_digest for audit-grade provenance.",
+          "additionalProperties": false,
+          "required": ["alg", "key_id", "value"],
+          "properties": {
+            "alg": {
+              "type": "string",
+              "description": "Signature algorithm identifier.",
+              "minLength": 1,
+              "maxLength": 100
+            },
+            "key_id": {
+              "type": "string",
+              "description": "Identifier for the signing key (public key reference).",
+              "minLength": 1,
+              "maxLength": 200
+            },
+            "value": {
+              "type": "string",
+              "description": "Signature value (base64 recommended).",
+              "minLength": 16,
+              "maxLength": 5000
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/docs/prov-spec/spec/vectors/adapter.wrap.envelope_v0_1/expected.json

@@ -0,0 +1,4 @@
+{
+  "schema_version": "mcp.envelope.v0.1",
+  "result": {"ok": true, "count": 3, "message": "Operation completed"}
+}

package/docs/prov-spec/spec/vectors/adapter.wrap.envelope_v0_1/input.json

@@ -0,0 +1 @@
+{"ok": true, "count": 3, "message": "Operation completed"}

package/docs/prov-spec/spec/vectors/adapter.wrap.envelope_v0_1/negative/double_wrapped.json

@@ -0,0 +1,14 @@
+{
+  "_vector_meta": {
+    "id": "adapter.wrap.envelope_v0_1/negative/double_wrapped",
+    "expect": "fail",
+    "reason": "Envelope is double-wrapped (nested envelope in result)"
+  },
+  "envelope": {
+    "schema_version": "mcp.envelope.v0.1",
+    "result": {
+      "schema_version": "mcp.envelope.v0.1",
+      "result": {"ok": true}
+    }
+  }
+}

package/docs/prov-spec/spec/vectors/adapter.wrap.envelope_v0_1/negative/wrong_schema_version.json

@@ -0,0 +1,11 @@
+{
+  "_vector_meta": {
+    "id": "adapter.wrap.envelope_v0_1/negative/wrong_schema_version",
+    "expect": "fail",
+    "reason": "Envelope has wrong schema_version"
+  },
+  "envelope": {
+    "schema_version": "mcp.envelope.v0.2",
+    "result": {"ok": true}
+  }
+}

package/docs/prov-spec/spec/vectors/engine.extract.evidence.json_pointer/expected.json

@@ -0,0 +1,24 @@
+{
+  "evidence": [
+    {
+      "schema_version": "evidence.v0.1",
+      "field": "anchored_id",
+      "source": "artifact:clierr-01#json:/id"
+    },
+    {
+      "schema_version": "evidence.v0.1",
+      "field": "safest_next_step",
+      "source": "artifact:clierr-01#json:/why/0"
+    },
+    {
+      "schema_version": "evidence.v0.1",
+      "field": "plan[0]",
+      "source": "artifact:clierr-01#json:/fix/0"
+    },
+    {
+      "schema_version": "evidence.v0.1",
+      "field": "plan[1]",
+      "source": "artifact:clierr-01#json:/fix/1"
+    }
+  ]
+}

package/docs/prov-spec/spec/vectors/engine.extract.evidence.json_pointer/input.json

@@ -0,0 +1,8 @@
+{
+  "artifact_id": "clierr-01",
+  "content": {
+    "id": "PAYROLL.EXPORT.SFTP.AUTH",
+    "why": ["Credential method mismatch", "SFTP server rejected key"],
+    "fix": ["Use password auth", "Update SSH key"]
+  }
+}

package/docs/prov-spec/spec/vectors/integrity.digest.sha256/expected.json

@@ -0,0 +1,7 @@
+{
+  "canonical_form": "{\"key\":\"value\",\"nested\":{\"a\":1,\"b\":2},\"number\":42}",
+  "digest": {
+    "alg": "sha256",
+    "value": "54fb66ce0aa908012dc9c432d77d16df95a3d5033a557d1c14cfc6d82a63ae34"
+  }
+}

package/docs/prov-spec/spec/vectors/integrity.digest.sha256/input.json

@@ -0,0 +1 @@
+{"key": "value", "number": 42, "nested": {"a": 1, "b": 2}}

package/docs/prov-spec/spec/vectors/integrity.digest.sha256/negative/non_hex_chars.json

@@ -0,0 +1,16 @@
+{
+  "_vector_meta": {
+    "id": "integrity.digest.sha256/negative/non_hex_chars",
+    "expect": "fail",
+    "reason": "Digest value contains non-hex characters"
+  },
+  "artifact": {
+    "schema_version": "artifact.v0.1",
+    "artifact_id": "test-001",
+    "media_type": "application/json",
+    "digest": {
+      "alg": "sha256",
+      "value": "ghijkl1234567890ghijkl1234567890ghijkl1234567890ghijkl1234567890"
+    }
+  }
+}