GitoxideLabs/gitoxide · error

no item index implies having an object id

Error message

no item index implies having an object id

What it means

An `unreachable!()` panic in gix-protocol's fetch ref-mapping initialization. When building `Mapping` values, a refspec match with no `item_index` is expected to always resolve to an object-id source; the panic fires if the matched `SourceRef` is anything other than `ObjectId` in that case. It marks a broken invariant between the refspec match group results and the mapping construction.

Solutions

1. Check the remote ref advertisement for malformed entries (`git ls-remote <url>`) and fix/replace the remote if it serves invalid data
2. Simplify the fetch refspec in `.git/config` (use explicit `+refs/heads/*:refs/remotes/origin/*` style) and retry
3. Upgrade gix / gix-protocol and gix-refspec — the panic signals a crate-level invariant bug to report upstream with the remote URL and refspec

// validate the remote advertisement before fetching
let advertised = repo.remote_at("origin")?.refspecs()?.iter().count();
if advertised == 0 { return Err("no refspecs configured for fetch".into()); }

fn expects_object_id(m: &Mapping) -> bool { m.item_index.is_none() }

std::panic::catch_unwind(|| perform_fetch(repo, specs))
    .map_err(|_| "gix fetch hit an internal refmap invariant; retry with plain git fetch")?

When it happens

Trigger: Running `git fetch` (via gix fetch handshake/refmap init) against a remote whose advertised refs lead the refspec matcher to produce a match with `item_index == None` but a non-`ObjectId` `lhs` source — e.g. a malformed or adversarial remote ref advertisement, or a bug in `gix-refspec` match-group logic.

Common situations: Fetching from a remotes URL with unusual or hand-crafted ref advertisement (refs pointing at tags/symbolic entries where objects are expected), or using a refspec configuration that the matcher resolves inconsistently; most often surfaced as a gix bug report rather than a user error.

Understand the failure class

Background: "This is a bug, please report it": internal invariant violations, unreachable panics, and SNH errors explained — this error's family across 47 libraries.

Related errors

• this case should have been removed during processing
• BUG: tries to obtain object id from symbolic target
• BUG: expected peeled reference target but found symbolic one
• Bug in lookup_symbol_has_path - must return lookup symbols
• this impl is needed to allow passing a known valid partial…

AI-assisted analysis of GitoxideLabs/gitoxide@e73179060b (2026-09-08). Data as JSON: /api/errors/2d6f7b08ff68648c. Report an issue: GitHub.

Appendix: source

Thrown at gix-protocol/src/fetch/refmap/init.rs:76

            .match_lhs(remote_refs.iter().map(|r| {
                let (full_ref_name, target, object) = r.unpack();
                gix_refspec::match_group::Item {
                    full_ref_name,
                    target: target.unwrap_or(&null),
                    object,
                }
            }))
            .validated()?;

        let mappings = res.mappings;
        let mappings = mappings
            .into_iter()
            .map(|m| Mapping {
                remote: m.item_index.map_or_else(
                    || {
                        Source::ObjectId(match m.lhs {
                            gix_refspec::match_group::SourceRef::ObjectId(id) => id,
                            _ => unreachable!("no item index implies having an object id"),
                        })
                    },
                    |idx| Source::Ref(remote_refs[idx].clone()),
                ),
                local: m.rhs.map(std::borrow::Cow::into_owned),
                spec_index: if m.spec_index < num_explicit_specs {
                    SpecIndex::ExplicitInRemote(m.spec_index)
                } else {
                    SpecIndex::Implicit(m.spec_index - num_explicit_specs)
                },
            })
            .collect();

        Ok(Self {
            mappings,
            refspecs: fetch_refspecs,
            extra_refspecs,
            fixes,

View on GitHub (pinned to e73179060b)