github/spec-kit · error · BundlerError

Failed to load catalog '{source.id}' ({source.url}): {exc}

Error message

Failed to load catalog '{source.id}' ({source.url}): {exc}

What it means

Error "Failed to load catalog '{source.id}' ({source.url}): {exc}" thrown in github/spec-kit.

Source

Thrown at src/specify_cli/bundler/services/catalog_stack.py:67

        project_root: Path,
        fetcher: CatalogFetcher,
        user_config_dir: Path | None = None,
    ) -> "CatalogStack":
        sources = load_source_stack(project_root, user_config_dir)
        return cls(sources, fetcher)

    @property
    def sources(self) -> list[CatalogSource]:
        return list(self._sources)

    def _entries_for(self, source: CatalogSource) -> dict[str, CatalogEntry]:
        if source.id not in self._payloads:
            try:
                raw = self._fetcher(source)
            except BundlerError:
                raise
            except Exception as exc:  # noqa: BLE001 - surface as chained BundlerError
                raise BundlerError(
                    f"Failed to load catalog '{source.id}' ({source.url}): {exc}"
                ) from exc
            self._payloads[source.id] = load_catalog_payload(raw)
        return self._payloads[source.id]

    def resolve(self, bundle_id: str) -> ResolvedBundle:
        """Return the highest-precedence entry for *bundle_id* or raise."""
        for source in self._sources:
            entries = self._entries_for(source)
            entry = entries.get(bundle_id)
            if entry is not None:
                return ResolvedBundle(entry=entry.with_provenance(source), source=source)
        raise BundlerError(
            f"Bundle '{bundle_id}' was not found in any configured catalog."
        )

    def search(self, query: str = "") -> list[ResolvedBundle]:
        """Return entries matching *query* (substring over id/name/role/tags/description).

View on GitHub (pinned to bf88c9f9a8)

Solutions

1. Inspect the inner error: fix the catalog URL/format or network issue, or remove the failing catalog source from the config.

When it happens

Trigger: Thrown at src/specify_cli/bundler/services/catalog_stack.py:67 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/a9985a2af123136d. Report an issue: GitHub.