github/spec-kit · error · IntegrationDescriptorError

Unsupported schema version: {self.data['schema_version']} (e

Error message

Unsupported schema version: {self.data['schema_version']} (expected {self.SCHEMA_VERSION})

What it means

Error "Unsupported schema version: {self.data['schema_version']} (expected {self.SCHEMA_VERSION})" thrown in github/spec-kit.

Source

Thrown at src/specify_cli/integrations/catalog.py:702

            raise IntegrationDescriptorError(
                f"Unable to read descriptor {path}: {exc}"
            )

    # -- Validation -------------------------------------------------------

    def _validate(self) -> None:
        if not isinstance(self.data, dict):
            raise IntegrationDescriptorError(
                f"Descriptor root must be a YAML mapping, got {type(self.data).__name__}"
            )
        for field in self.REQUIRED_TOP_LEVEL:
            if field not in self.data:
                raise IntegrationDescriptorError(
                    f"Missing required field: {field}"
                )

        if self.data["schema_version"] != self.SCHEMA_VERSION:
            raise IntegrationDescriptorError(
                f"Unsupported schema version: {self.data['schema_version']} "
                f"(expected {self.SCHEMA_VERSION})"
            )

        integ = self.data["integration"]
        if not isinstance(integ, dict):
            raise IntegrationDescriptorError(
                "'integration' must be a mapping"
            )
        for field in ("id", "name", "version", "description"):
            if field not in integ:
                raise IntegrationDescriptorError(
                    f"Missing integration.{field}"
                )
            if not isinstance(integ[field], str):
                raise IntegrationDescriptorError(
                    f"integration.{field} must be a string, got {type(integ[field]).__name__}"
                )

View on GitHub (pinned to bf88c9f9a8)

Solutions

1. Set schema_version in the descriptor to the supported SCHEMA_VERSION value.

When it happens

Trigger: Thrown at src/specify_cli/integrations/catalog.py:702 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of github/spec-kit@bf88c9f9a8 (2026-08-14). Data as JSON: /api/errors/4447549016acaf8c. Report an issue: GitHub.