github/spec-kit · error · BundlerError

Catalog file not found: {path}

Error message

Catalog file not found: {path}

What it means

Error "Catalog file not found: {path}" thrown in github/spec-kit.

Source

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

            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}' "
                    f"from {url}."
                )
            _validate_remote_url(source.id, url)
            return _http_get_json(source.id, url)

        raise BundlerError(f"Unsupported catalog URL scheme: {url}")

View on GitHub (pinned to bf88c9f9a8)

Solutions

1. Point the catalog source at an existing catalog file path, or update the file:// URL to a file that exists.

When it happens

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