GeezerVison

What

publish_versioned_docs.py (added in #6763) aborts when publishing a versioned docs space, failing with:

RuntimeError: expected one default GitBook site space, found 54

Why

The script lists site spaces with GET .../site-spaces?default=true and trusts GitBook to return only the single default space. In practice GitBook ignores the default query filter and returns every linked site space, so the script sees 54 "defaults" and bails out in _duplicate_default_space before importing the release branch. Nothing downstream (branch import, default switch, publish) ever ran, so no GitBook state was changed — the job just failed.

This was confirmed against the live Feast site with a read-only inspection: 54 total site spaces, exactly 1 with default == true, no sections (the /sections endpoint 404s), and ?default=true returning all 54 — i.e. the filter is not applied server-side.

Fix

• _list_site_spaces() now paginates (next.page) and, when a default is requested, filters on the default flag client-side, so the single default space is identified regardless of whether GitBook honors the query filter.
• The "more than one default" error now explains the sectioned-site case (each section has its own default space) and that it is unsupported, pointing at the manual process, instead of the bare count.