github/spec-kit · error · BundlerError

Corrupt records file: a contributed component is missing its

Error message

Corrupt records file: a contributed component is missing its 'id'.

What it means

Error "Corrupt records file: a contributed component is missing its 'id'." thrown in github/spec-kit.

Source

Thrown at src/specify_cli/bundler/models/records.py:212

    if ref.priority is not None:
        data["priority"] = ref.priority
    if ref.strategy is not None:
        data["strategy"] = ref.strategy
    return data


def _component_from_dict(data: Any) -> ComponentRef:
    if not isinstance(data, dict):
        raise BundlerError("Each contributed component must be a mapping.")
    kind = str(data.get("kind", "")).strip()
    cid = str(data.get("id", "")).strip()
    if kind not in COMPONENT_KINDS:
        raise BundlerError(
            f"Corrupt records file: component 'kind' must be one of "
            f"{list(COMPONENT_KINDS)}, got {kind or '<missing>'!r}."
        )
    if not cid:
        raise BundlerError(
            "Corrupt records file: a contributed component is missing its 'id'."
        )
    return ComponentRef(
        kind=kind,
        id=cid,
        version=(str(data["version"]) if data.get("version") else None),
        source=(str(data["source"]) if data.get("source") else None),
        priority=_parse_priority(data.get("priority")),
        strategy=(str(data["strategy"]) if data.get("strategy") else None),
    )


def _parse_priority(raw: Any) -> int | None:
    if raw is None:
        return None
    if isinstance(raw, bool) or not isinstance(raw, (int, str)):
        raise BundlerError(f"Component priority must be an integer, got {raw!r}.")
    try:

View on GitHub (pinned to bf88c9f9a8)

Solutions

1. Add the missing 'id' field to the contributed component in the records file, or reinstall the bundle to regenerate valid records.

When it happens

Trigger: Thrown at src/specify_cli/bundler/models/records.py:212 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/38b6a951446848b2. Report an issue: GitHub.