{"record":{"id":"e2e9d50e1c246c94","repo":"github/spec-kit","slug":"catalog-config-config-path-has-invalid-catalogs","errorCode":null,"errorMessage":"Catalog config {config_path} has invalid 'catalogs' value: must be a list.","messagePattern":"Catalog config (.+?) has invalid 'catalogs' value: must be a list\\.","errorType":"validation","errorClass":"IntegrationValidationError","httpStatus":null,"severity":"error","filePath":"src/specify_cli/integrations/catalog.py","lineNumber":427,"sourceCode":"        if config_path.exists():\n            try:\n                raw = yaml.safe_load(config_path.read_text(encoding=\"utf-8\"))\n            except (yaml.YAMLError, OSError, UnicodeError) as exc:\n                raise IntegrationValidationError(\n                    f\"Failed to read catalog config {config_path}: {exc}\"\n                ) from exc\n            if raw is None:\n                raw = {}\n            if not isinstance(raw, dict):\n                raise IntegrationValidationError(\n                    f\"Catalog config file {config_path} is corrupted \"\n                    \"(expected a mapping).\"\n                )\n            data = raw\n\n        catalogs = data.get(\"catalogs\", [])\n        if not isinstance(catalogs, list):\n            raise IntegrationValidationError(\n                f\"Catalog config {config_path} has invalid 'catalogs' value: \"\n                \"must be a list.\"\n            )\n\n        # Validate each existing entry before mutating anything. Fail fast so\n        # we don't silently preserve a corrupt sibling entry or derive a new\n        # priority from a bogus value.\n        existing_priorities: List[int] = []\n        valid_catalog_count = 0\n        for idx, cat in enumerate(catalogs):\n            if not isinstance(cat, dict):\n                raise IntegrationValidationError(\n                    f\"Invalid catalog entry at index {idx} in {config_path}: \"\n                    f\"expected a mapping, got {type(cat).__name__}.\"\n                )\n            existing_url = str(cat.get(\"url\", \"\")).strip()\n            if not existing_url:\n                continue","sourceCodeStart":409,"sourceCodeEnd":445,"githubUrl":"https://github.com/github/spec-kit/blob/bf88c9f9a82fa370c7a7257aa2b3cf10b457b65c/src/specify_cli/integrations/catalog.py#L409-L445","documentation":"Error \"Catalog config {config_path} has invalid 'catalogs' value: must be a list.\" thrown in github/spec-kit.","triggerScenarios":"Thrown at src/specify_cli/integrations/catalog.py:427 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Change the 'catalogs' value in the catalog config to a list of catalog entries."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"bf88c9f9a82fa370c7a7257aa2b3cf10b457b65c","analyzedAt":"2026-08-14T19:43:37.150Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}