Docs(fix[assets]): Drop stale tabs script

why: gp-sphinx removes tabs.js after rendering, leaving pages with a missing
asset reference even though inline tabs operate through CSS.

what:
- Filter only tabs.js from Sphinx page contexts at late priority
- Verify final tab markup and assets with a one-page Sphinx build

Author: tony

docs/conf.py

@@ -4,8 +4,10 @@
 
 import pathlib
 import sys
+import typing as t
 
 from gp_sphinx.config import make_linkcode_resolve, merge_sphinx_config
+from sphinx.application import Sphinx
 
 import libtmux
 
@@ -60,4 +62,65 @@
     exclude_patterns=["_build", "AGENTS.md", "CLAUDE.md", "superpowers/**"],
 )
 conf["myst_enable_extensions"].append("fieldlist")
+
+_shared_setup = t.cast("t.Callable[[Sphinx], None]", conf["setup"])
+
+
+def _omit_removed_inline_tabs_script(
+    app: Sphinx,
+    _pagename: str,
+    _templatename: str,
+    context: dict[str, t.Any],
+    _doctree: object | None,
+) -> None:
+    """Keep rendered pages consistent with gp-sphinx's static assets.
+
+    gp-sphinx removes ``tabs.js`` after a successful HTML build because
+    sphinx-inline-tabs needs only its CSS behavior here. Remove the matching
+    page-context entry before Sphinx renders a stale ``script`` reference.
+
+    Parameters
+    ----------
+    app : sphinx.application.Sphinx
+        Active Sphinx application.
+    _pagename : str
+        Name of the page being rendered.
+    _templatename : str
+        Template used to render the page.
+    context : dict[str, Any]
+        Template context containing Sphinx's script assets.
+    _doctree : object | None
+        Page doctree, when available.
+    """
+    if "sphinx_inline_tabs" not in app.extensions:
+        return
+
+    script_files = context.get("script_files")
+    if not isinstance(script_files, list):
+        return
+
+    context["script_files"] = [
+        asset
+        for asset in script_files
+        if getattr(asset, "filename", None) != "_static/tabs.js"
+    ]
+
+
+def setup(app: Sphinx) -> None:
+    """Configure shared gp-sphinx hooks and project asset consistency.
+
+    Parameters
+    ----------
+    app : sphinx.application.Sphinx
+        Active Sphinx application.
+    """
+    _shared_setup(app)
+    app.connect(
+        "html-page-context",
+        _omit_removed_inline_tabs_script,
+        priority=900,
+    )
+
+
+conf["setup"] = setup
 globals().update(conf)

tests/docs/test_static_assets.py

@@ -0,0 +1,70 @@
+"""Contracts for documentation assets emitted into HTML pages."""
+
+from __future__ import annotations
+
+import pathlib
+import textwrap
+
+from sphinx.testing.util import SphinxTestApp
+
+_ROOT = pathlib.Path(__file__).parents[2]
+
+
+def test_docs_setup_omits_deleted_inline_tabs_script_from_html(
+    tmp_path: pathlib.Path,
+) -> None:
+    """Rendered tabs work without referencing gp-sphinx's deleted script."""
+    source = tmp_path / "source"
+    source.mkdir()
+    (source / "conf.py").write_text(
+        textwrap.dedent(
+            f"""
+            import runpy
+
+            _site = runpy.run_path({str(_ROOT / "docs" / "conf.py")!r})
+            extensions = [
+                name
+                for name in _site["extensions"]
+                if name == "sphinx_inline_tabs"
+            ]
+            html_theme = "basic"
+            project = "asset-test"
+            setup = _site["setup"]
+            """
+        ),
+        encoding="utf-8",
+    )
+    (source / "index.rst").write_text(
+        textwrap.dedent(
+            """
+            Asset test
+            ==========
+
+            .. tab:: Python plan
+
+               Typed operation
+
+            .. tab:: Compiled tmux sequence
+
+               Rendered command
+            """
+        ),
+        encoding="utf-8",
+    )
+
+    app = SphinxTestApp(
+        srcdir=source,
+        builddir=tmp_path / "_build",
+        buildername="html",
+        freshenv=True,
+    )
+    try:
+        app.build()
+        output = tmp_path / "_build" / "html"
+        html = (output / "index.html").read_text(encoding="utf-8")
+    finally:
+        app.cleanup()
+
+    assert 'class="tab-set' in html
+    assert "_static/tabs.css" in html
+    assert "_static/tabs.js" not in html