github/spec-kit · error · IntegrationValidationError

Catalog index {index} out of range (0-{len(display_order) -

Error message

Catalog index {index} out of range (0-{len(display_order) - 1}).

What it means

Error "Catalog index {index} out of range (0-{len(display_order) - 1})." thrown in github/spec-kit.

Source

Thrown at src/specify_cli/integrations/catalog.py:591

            if isinstance(raw_priority, bool):
                priority = yaml_idx + 1
            else:
                try:
                    priority = int(raw_priority)
                except (TypeError, ValueError, OverflowError):
                    # OverflowError: int(float("inf")) — a ``priority: .inf``.
                    priority = yaml_idx + 1
            priority_pairs.append((priority, yaml_idx))
        if not priority_pairs:
            raise IntegrationValidationError(
                "Catalog config contains no removable catalog entries."
            )
        # Stable sort: ties keep their YAML order, matching list-view ordering.
        priority_pairs.sort(key=lambda p: p[0])
        display_order: List[int] = [yaml_idx for _, yaml_idx in priority_pairs]

        if index < 0 or index >= len(display_order):
            raise IntegrationValidationError(
                f"Catalog index {index} out of range (0-{len(display_order) - 1})."
            )

        target_yaml_idx = display_order[index]
        removed = catalogs.pop(target_yaml_idx)

        if any(_is_removable_catalog_entry(item) for item in catalogs):
            data["catalogs"] = catalogs
            with open(config_path, "w", encoding="utf-8") as f:
                yaml.dump(
                    data,
                    f,
                    default_flow_style=False,
                    sort_keys=False,
                    allow_unicode=True,
                )
        else:
            # Removing the final entry: delete the config file rather than

View on GitHub (pinned to bf88c9f9a8)

Solutions

1. Choose a catalog index within the displayed range.

When it happens

Trigger: Thrown at src/specify_cli/integrations/catalog.py:591 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/5f3c010730dc0372. Report an issue: GitHub.