github/spec-kit · error · IntegrationValidationError

Catalog config {config_path} has invalid 'catalogs' value: m

Error message

Catalog config {config_path} has invalid 'catalogs' value: must be a list.

What it means

Error "Catalog config {config_path} has invalid 'catalogs' value: must be a list." thrown in github/spec-kit.

Source

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

        if config_path.exists():
            try:
                raw = yaml.safe_load(config_path.read_text(encoding="utf-8"))
            except (yaml.YAMLError, OSError, UnicodeError) as exc:
                raise IntegrationValidationError(
                    f"Failed to read catalog config {config_path}: {exc}"
                ) from exc
            if raw is None:
                raw = {}
            if not isinstance(raw, dict):
                raise IntegrationValidationError(
                    f"Catalog config file {config_path} is corrupted "
                    "(expected a mapping)."
                )
            data = raw

        catalogs = data.get("catalogs", [])
        if not isinstance(catalogs, list):
            raise IntegrationValidationError(
                f"Catalog config {config_path} has invalid 'catalogs' value: "
                "must be a list."
            )

        # Validate each existing entry before mutating anything. Fail fast so
        # we don't silently preserve a corrupt sibling entry or derive a new
        # priority from a bogus value.
        existing_priorities: List[int] = []
        valid_catalog_count = 0
        for idx, cat in enumerate(catalogs):
            if not isinstance(cat, dict):
                raise IntegrationValidationError(
                    f"Invalid catalog entry at index {idx} in {config_path}: "
                    f"expected a mapping, got {type(cat).__name__}."
                )
            existing_url = str(cat.get("url", "")).strip()
            if not existing_url:
                continue

View on GitHub (pinned to bf88c9f9a8)

Solutions

1. Change the 'catalogs' value in the catalog config to a list of catalog entries.

When it happens

Trigger: Thrown at src/specify_cli/integrations/catalog.py:427 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/e2e9d50e1c246c94. Report an issue: GitHub.