github/spec-kit · error · BundlerError

Unknown built-in catalog '{url}'.

Error message

Unknown built-in catalog '{url}'.

What it means

Error "Unknown built-in catalog '{url}'." thrown in github/spec-kit.

Source

Thrown at src/specify_cli/bundler/services/adapters.py:141

        try:
            parsed = urlparse(url)
            # Keep malformed authorities and ports inside the BundlerError
            # contract even when a config file was edited by hand.
            _ = parsed.port
        except ValueError:
            raise BundlerError(
                f"Catalog {source.id!r} URL is malformed: {url!r}"
            ) from None
        scheme = parsed.scheme.lower()

        if scheme == "builtin":
            if url == "builtin://community":
                if allow_network:
                    return _http_get_json(source.id, COMMUNITY_CATALOG_URL)
                return _load_packaged_community_catalog()
            payload = _BUILTIN_CATALOGS.get(url)
            if payload is None:
                raise BundlerError(f"Unknown built-in catalog '{url}'.")
            return payload

        if scheme == "file":
            path = _file_url_to_path(parsed)
            if not path.exists():
                raise BundlerError(f"Catalog file not found: {path}")
            return load_json(path)

        if scheme == "" or _is_windows_drive_path(url):
            path = Path(url)
            if not path.exists():
                raise BundlerError(f"Catalog file not found: {path}")
            return load_json(path)

        if scheme in ("http", "https"):
            if not allow_network:
                raise BundlerError(
                    f"Network access disabled; cannot fetch catalog '{source.id}' "

View on GitHub (pinned to bf88c9f9a8)

Solutions

1. Use a known builtin:// catalog name, or replace the URL with a valid https://, file://, or local path catalog source.

When it happens

Trigger: Thrown at src/specify_cli/bundler/services/adapters.py:141 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/67134aa09e460d65. Report an issue: GitHub.