@mcptoolshop/accessibility-suite 0.1.0

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

@@ -0,0 +1,213 @@
+{
+  "$schema": "schemas/methods.schema.json",
+  "schema_version": "methods-catalog@v0.1",
+  "spec_version": "0.1.0",
+  "generated": false,
+  "methods": [
+    {
+      "id": "adapter.wrap.envelope_v0_1",
+      "namespace": "adapter",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Wrapped a legacy tool payload into mcp.envelope.v0.1",
+      "when_to_emit": "Adapter created an envelope around non-envelope output",
+      "requires": ["envelope.schema_version == 'mcp.envelope.v0.1'"]
+    },
+    {
+      "id": "adapter.pass_through.envelope_v0_1",
+      "namespace": "adapter",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Tool returned an envelope already; adapter returned it unchanged",
+      "when_to_emit": "Adapter performed pass-through without wrapping",
+      "requires": ["no double-wrapping"]
+    },
+    {
+      "id": "adapter.provenance.attach_record_v0_1",
+      "namespace": "adapter",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Adapter attached a prov.record.v0.1 record to the envelope",
+      "when_to_emit": "Envelope contains a provenance record generated by adapter logic",
+      "requires": ["envelope.provenance.schema_version == 'prov.record.v0.1'"]
+    },
+    {
+      "id": "adapter.errors.capture",
+      "namespace": "adapter",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Adapter captured an execution failure and emitted errors[] in the envelope",
+      "when_to_emit": "Tool failed and adapter populated standardized envelope errors",
+      "requires": ["envelope.errors.length >= 1"]
+    },
+    {
+      "id": "adapter.warnings.capture",
+      "namespace": "adapter",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Adapter captured non-fatal warnings and emitted warnings[] in the envelope",
+      "when_to_emit": "Partial results, degraded mode, etc.",
+      "requires": ["envelope.warnings.length >= 1"]
+    },
+    {
+      "id": "engine.prov.record_v0_1.build",
+      "namespace": "engine",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Constructed a prov.record.v0.1 record",
+      "when_to_emit": "Provenance record created by engine/adapter",
+      "requires": ["provenance.schema_version == 'prov.record.v0.1'"]
+    },
+    {
+      "id": "engine.prov.artifact.register_input",
+      "namespace": "engine",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Registered one or more input artifacts in provenance",
+      "when_to_emit": "Inputs list populated (regardless of digest presence)",
+      "requires": ["provenance.inputs.length >= 1"]
+    },
+    {
+      "id": "engine.prov.artifact.register_output",
+      "namespace": "engine",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Registered one or more output artifacts in provenance",
+      "when_to_emit": "Outputs list populated",
+      "requires": ["provenance.outputs.length >= 1"]
+    },
+    {
+      "id": "engine.extract.evidence.json_pointer",
+      "namespace": "engine",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Evidence anchors were derived using JSON pointer-style fragments",
+      "when_to_emit": "Evidence anchors include #json:/...",
+      "requires": ["evidence[].source contains '#json:/'"]
+    },
+    {
+      "id": "engine.extract.evidence.text_lines",
+      "namespace": "engine",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Evidence anchors were derived using text line ranges",
+      "when_to_emit": "Evidence anchors include #text:line:...",
+      "requires": ["evidence[].source contains '#text:line:'"]
+    },
+    {
+      "id": "engine.coerce.evidence.v0_1",
+      "namespace": "engine",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Converted or normalized tool-provided evidence into evidence.v0.1",
+      "when_to_emit": "Tool evidence was adapted into the canonical evidence schema",
+      "requires": ["evidence[].schema_version == 'evidence.v0.1'"]
+    },
+    {
+      "id": "integrity.digest.sha256",
+      "namespace": "integrity",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Computed sha256 digest(s) for one or more artifacts",
+      "when_to_emit": "Any artifact digest uses sha256 and was computed during this run",
+      "requires": ["artifact.digest.alg == 'sha256'", "artifact.digest.value is 64 hex chars"]
+    },
+    {
+      "id": "integrity.digest.sha512",
+      "namespace": "integrity",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Computed sha512 digest(s) for one or more artifacts",
+      "when_to_emit": "Any artifact digest uses sha512 and was computed during this run",
+      "requires": ["artifact.digest.alg == 'sha512'", "artifact.digest.value is 128 hex chars"]
+    },
+    {
+      "id": "integrity.digest.blake3",
+      "namespace": "integrity",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Computed blake3 digest(s) for one or more artifacts",
+      "when_to_emit": "Any artifact digest uses blake3 and was computed during this run",
+      "requires": ["artifact.digest.alg == 'blake3'", "artifact.digest.value is 64 hex chars"]
+    },
+    {
+      "id": "integrity.record_digest.compute",
+      "namespace": "integrity",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Computed integrity.record_digest for the provenance record",
+      "when_to_emit": "prov.record.integrity.record_digest is populated",
+      "requires": ["provenance.integrity.record_digest is present"]
+    },
+    {
+      "id": "integrity.signature.create",
+      "namespace": "integrity",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Created a signature over the provenance record digest",
+      "when_to_emit": "prov.record.integrity.signature is populated (signing performed)",
+      "requires": ["provenance.integrity.signature is present"]
+    },
+    {
+      "id": "integrity.signature.verify",
+      "namespace": "integrity",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Verified a provenance record signature successfully",
+      "when_to_emit": "provenance.verify tool confirms signature validity",
+      "requires": ["signature verification succeeded"]
+    },
+    {
+      "id": "lineage.parent.link",
+      "namespace": "lineage",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Linked this provenance record to one or more parent runs via parents[]",
+      "when_to_emit": "parents[] populated to indicate dependency",
+      "requires": ["provenance.parents.length >= 1"]
+    },
+    {
+      "id": "lineage.graph.build",
+      "namespace": "lineage",
+      "status": "stable",
+      "since": "0.1.0",
+      "summary": "Built a lineage graph from one or more provenance records",
+      "when_to_emit": "A graph/DAG representation was constructed",
+      "requires": ["multiple records linked"]
+    }
+  ],
+  "namespaces": {
+    "adapter": {
+      "description": "Envelope wrapping, transport, execution wrappers",
+      "status": "stable"
+    },
+    "engine": {
+      "description": "Evidence extraction, normalization, provenance construction",
+      "status": "stable"
+    },
+    "integrity": {
+      "description": "Hashing, signatures, verification",
+      "status": "stable"
+    },
+    "lineage": {
+      "description": "Parent linking and graph operations",
+      "status": "stable"
+    },
+    "policy": {
+      "description": "Access control, retention policies",
+      "status": "reserved"
+    },
+    "attestation": {
+      "description": "Third-party attestations, compliance claims",
+      "status": "reserved"
+    },
+    "execution": {
+      "description": "Runtime environment, resource usage",
+      "status": "reserved"
+    },
+    "audit": {
+      "description": "Audit trail operations",
+      "status": "reserved"
+    }
+  }
+}

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

@@ -0,0 +1,58 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "artifact.ref.v0.1",
+  "title": "artifact.ref.v0.1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version"],
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "const": "artifact.ref.v0.1"
+    },
+    "artifact_id": {
+      "type": "string",
+      "description": "Reference by artifact_id (UUID or content-addressed id).",
+      "minLength": 1
+    },
+    "locator": {
+      "type": "string",
+      "description": "Reference by location (file path, URL, MCP resource key).",
+      "minLength": 1
+    },
+    "media_type": {
+      "type": "string",
+      "description": "Optional media type hint.",
+      "minLength": 1
+    },
+    "digest": {
+      "type": "object",
+      "description": "Optional digest hint for verification.",
+      "additionalProperties": false,
+      "required": ["alg", "value"],
+      "properties": {
+        "alg": {
+          "type": "string",
+          "enum": ["sha256", "sha512", "blake3"]
+        },
+        "value": {
+          "type": "string",
+          "pattern": "^[0-9a-fA-F]+$",
+          "minLength": 16
+        }
+      }
+    },
+    "labels": {
+      "type": "object",
+      "description": "Optional small labels for routing or UI.",
+      "additionalProperties": {
+        "type": "string",
+        "maxLength": 200
+      }
+    }
+  },
+  "anyOf": [
+    { "required": ["artifact_id"] },
+    { "required": ["locator"] }
+  ]
+}

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

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "artifact.v0.1",
+  "title": "artifact.v0.1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "artifact_id", "media_type"],
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "const": "artifact.v0.1"
+    },
+    "artifact_id": {
+      "type": "string",
+      "description": "Stable identifier for the artifact. May be a UUID or content-addressed digest (e.g., sha256:<hex>).",
+      "minLength": 1
+    },
+    "media_type": {
+      "type": "string",
+      "description": "IANA media type (MIME type), e.g., application/json, text/plain, application/pdf.",
+      "minLength": 1
+    },
+    "locator": {
+      "type": "string",
+      "description": "Optional location hint (file path, URL, MCP resource key). Not required for determinism.",
+      "minLength": 1
+    },
+    "size_bytes": {
+      "type": "integer",
+      "description": "Optional size in bytes.",
+      "minimum": 0
+    },
+    "digest": {
+      "type": "object",
+      "description": "Optional integrity digest(s).",
+      "additionalProperties": false,
+      "properties": {
+        "alg": {
+          "type": "string",
+          "description": "Digest algorithm. sha256 is recommended.",
+          "enum": ["sha256", "sha512", "blake3"]
+        },
+        "value": {
+          "type": "string",
+          "description": "Hex digest value (lowercase recommended).",
+          "pattern": "^[0-9a-fA-F]+$",
+          "minLength": 16
+        }
+      },
+      "required": ["alg", "value"]
+    },
+    "labels": {
+      "type": "object",
+      "description": "Optional small labels for consumers (e.g., role=cli_error_json).",
+      "additionalProperties": {
+        "type": "string",
+        "maxLength": 200
+      }
+    }
+  }
+}

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

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://a11y-assist.dev/schemas/assist.request.schema.v0.1.json",
+  "title": "assist.request.v0.1",
+  "description": "Request schema for a11y-assist",
+  "type": "object",
+  "required": ["profile", "input"],
+  "properties": {
+    "profile": {
+      "type": "string",
+      "enum": ["lowvision"],
+      "description": "Accessibility profile to use"
+    },
+    "input": {
+      "type": "object",
+      "required": ["kind"],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": ["cli_error_json", "raw_text", "last_log"],
+          "description": "Type of input"
+        },
+        "path": {
+          "type": "string",
+          "description": "Path to input file"
+        },
+        "text": {
+          "type": "string",
+          "description": "Raw text input"
+        }
+      },
+      "additionalProperties": false
+    },
+    "preferences": {
+      "type": "object",
+      "properties": {
+        "max_steps": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10,
+          "description": "Maximum number of plan steps to return"
+        },
+        "show_next_command": {
+          "type": "boolean",
+          "description": "Whether to show suggested safe commands"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,70 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://a11y-assist.dev/schemas/assist.response.schema.v0.1.json",
+  "title": "assist.response.v0.1",
+  "description": "Response schema for a11y-assist with optional audit metadata",
+  "type": "object",
+  "required": ["confidence", "safest_next_step", "plan"],
+  "properties": {
+    "anchored_id": {
+      "type": ["string", "null"],
+      "description": "Error ID this assist is anchored to, if found"
+    },
+    "confidence": {
+      "type": "string",
+      "enum": ["High", "Medium", "Low"],
+      "description": "Confidence level of the assist"
+    },
+    "safest_next_step": {
+      "type": "string",
+      "description": "Single safest next action to take"
+    },
+    "plan": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 1,
+      "description": "Ordered list of steps to resolve the issue"
+    },
+    "next_safe_commands": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "SAFE-only commands that can be run"
+    },
+    "notes": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Additional notes and context"
+    },
+    "methods_applied": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 0,
+      "description": "Stable method identifiers applied to produce this assist output (audit-only)"
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["field", "source"],
+        "properties": {
+          "field": {
+            "type": "string",
+            "description": "Which output field this evidence supports (e.g., safest_next_step, plan[0])"
+          },
+          "source": {
+            "type": "string",
+            "description": "Source anchor (e.g., cli.error.fix[1], cli.error.why[0], raw_text:Fix:2)"
+          },
+          "note": {
+            "type": "string",
+            "description": "Optional short note clarifying the mapping"
+          }
+        },
+        "additionalProperties": false
+      },
+      "minItems": 0,
+      "description": "Trace anchors mapping assist content back to input (audit-only)"
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://a11y-lint.dev/schemas/cli.error.schema.v0.1.json",
+  "title": "CLI Ground Truth Message",
+  "description": "Schema for accessible CLI error messages with What/Why/Fix structure",
+  "type": "object",
+  "required": ["level", "code", "what"],
+  "properties": {
+    "level": {
+      "type": "string",
+      "enum": ["OK", "WARN", "ERROR"],
+      "description": "Severity level of the message"
+    },
+    "code": {
+      "type": "string",
+      "pattern": "^[A-Z][A-Z0-9]{1,3}[0-9]{3}$",
+      "description": "Unique error code (e.g., A11Y001, CLI002)",
+      "examples": ["A11Y001", "CLI002", "FMT003"]
+    },
+    "id": {
+      "type": "string",
+      "description": "Alternate ID field (NAMESPACE.CATEGORY.DETAIL format)"
+    },
+    "title": {
+      "type": "string",
+      "description": "Human-readable title"
+    },
+    "what": {
+      "oneOf": [
+        { "type": "string", "minLength": 1, "maxLength": 200 },
+        { "type": "array", "items": { "type": "string" }, "minItems": 1 }
+      ],
+      "description": "Brief description of what happened or was checked"
+    },
+    "why": {
+      "oneOf": [
+        { "type": "string", "minLength": 1, "maxLength": 500 },
+        { "type": "array", "items": { "type": "string" }, "minItems": 1 }
+      ],
+      "description": "Explanation of why this matters for accessibility"
+    },
+    "fix": {
+      "oneOf": [
+        { "type": "string", "minLength": 1, "maxLength": 500 },
+        { "type": "array", "items": { "type": "string" }, "minItems": 1 }
+      ],
+      "description": "Actionable suggestion for how to fix the issue"
+    },
+    "location": {
+      "type": "object",
+      "description": "Location of the issue in the source",
+      "properties": {
+        "file": { "type": "string" },
+        "line": { "type": "integer", "minimum": 1 },
+        "column": { "type": "integer", "minimum": 1 },
+        "context": { "type": "string", "maxLength": 200 }
+      }
+    },
+    "rule": {
+      "type": "string",
+      "description": "Name of the accessibility rule that was checked"
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Additional rule-specific metadata",
+      "additionalProperties": true
+    }
+  },
+  "if": {
+    "properties": {
+      "level": { "const": "ERROR" }
+    }
+  },
+  "then": {
+    "required": ["level", "code", "what", "why", "fix"]
+  },
+  "additionalProperties": true
+}

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

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "evidence.v0.1",
+  "title": "evidence.v0.1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "field", "source"],
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "const": "evidence.v0.1"
+    },
+    "field": {
+      "type": "string",
+      "description": "Which output field this evidence supports (e.g., safest_next_step, plan[0], summary).",
+      "minLength": 1,
+      "maxLength": 200
+    },
+    "source": {
+      "type": "string",
+      "description": "Source anchor referencing an artifact + optional fragment, e.g. artifact:<id>#json:/fix/1 or artifact:<id>#text:line:12-14.",
+      "minLength": 1,
+      "maxLength": 1000
+    },
+    "method": {
+      "type": "string",
+      "description": "Optional method ID describing how this evidence mapping was derived.",
+      "minLength": 1,
+      "maxLength": 200
+    },
+    "note": {
+      "type": "string",
+      "description": "Optional short note clarifying the mapping.",
+      "maxLength": 400
+    }
+  }
+}