{"record":{"id":"a9985a2af123136d","repo":"github/spec-kit","slug":"failed-to-load-catalog-source-id-source-url","errorCode":null,"errorMessage":"Failed to load catalog '{source.id}' ({source.url}): {exc}","messagePattern":"Failed to load catalog '(.+?)' \\((.+?)\\): (.+?)","errorType":"exception","errorClass":"BundlerError","httpStatus":null,"severity":"error","filePath":"src/specify_cli/bundler/services/catalog_stack.py","lineNumber":67,"sourceCode":"        project_root: Path,\n        fetcher: CatalogFetcher,\n        user_config_dir: Path | None = None,\n    ) -> \"CatalogStack\":\n        sources = load_source_stack(project_root, user_config_dir)\n        return cls(sources, fetcher)\n\n    @property\n    def sources(self) -> list[CatalogSource]:\n        return list(self._sources)\n\n    def _entries_for(self, source: CatalogSource) -> dict[str, CatalogEntry]:\n        if source.id not in self._payloads:\n            try:\n                raw = self._fetcher(source)\n            except BundlerError:\n                raise\n            except Exception as exc:  # noqa: BLE001 - surface as chained BundlerError\n                raise BundlerError(\n                    f\"Failed to load catalog '{source.id}' ({source.url}): {exc}\"\n                ) from exc\n            self._payloads[source.id] = load_catalog_payload(raw)\n        return self._payloads[source.id]\n\n    def resolve(self, bundle_id: str) -> ResolvedBundle:\n        \"\"\"Return the highest-precedence entry for *bundle_id* or raise.\"\"\"\n        for source in self._sources:\n            entries = self._entries_for(source)\n            entry = entries.get(bundle_id)\n            if entry is not None:\n                return ResolvedBundle(entry=entry.with_provenance(source), source=source)\n        raise BundlerError(\n            f\"Bundle '{bundle_id}' was not found in any configured catalog.\"\n        )\n\n    def search(self, query: str = \"\") -> list[ResolvedBundle]:\n        \"\"\"Return entries matching *query* (substring over id/name/role/tags/description).","sourceCodeStart":49,"sourceCodeEnd":85,"githubUrl":"https://github.com/github/spec-kit/blob/bf88c9f9a82fa370c7a7257aa2b3cf10b457b65c/src/specify_cli/bundler/services/catalog_stack.py#L49-L85","documentation":"Error \"Failed to load catalog '{source.id}' ({source.url}): {exc}\" thrown in github/spec-kit.","triggerScenarios":"Thrown at src/specify_cli/bundler/services/catalog_stack.py:67 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Inspect the inner error: fix the catalog URL/format or network issue, or remove the failing catalog source from the config."],"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"}