fix(pypi): publish under periscope-agentsview, not periscope

The PyPI name "periscope" is registered by an unrelated project (a
subtitle downloader), so the wheel builder's package identity is now
periscope-agentsview instead. The installed console script and
internal module/import name stay "periscope" -- only the PyPI
distribution name (and therefore the wheel filename and dist-info
directory) change.

Also fixes release.yml's smoke-test step, which still referenced the
old wheel filename.

Author: diazMelgarejo

.github/workflows/release.yml

@@ -343,7 +343,7 @@ jobs:
         run: |
           VERSION=${GITHUB_REF#refs/tags/v}
           WHL_VERSION=$(python3 -c "import re,sys; v='${VERSION}'; m=re.match(r'^(\d+\.\d+\.\d+)-(.+)$',v); print(m.group(1)+'+'+m.group(2).replace('-','.')if m else v)")
-          pip install "wheels/periscope-${WHL_VERSION}-py3-none-manylinux_2_28_x86_64.whl"
+          pip install "wheels/periscope_agentsview-${WHL_VERSION}-py3-none-manylinux_2_28_x86_64.whl"
           periscope --version
 
       - name: Publish to PyPI

scripts/build_wheels.py

@@ -44,6 +44,18 @@ def normalize_wheel_version(version: str) -> str:
     return version
 
 
+# ---------------------------------------------------------------------------
+# Package identity
+# ---------------------------------------------------------------------------
+
+# PyPI project name. The upstream name "periscope" is registered by an
+# unrelated project (a subtitle downloader), so this fork publishes under
+# a distinct distribution name. The installed console script and the
+# internal module/import name stay "periscope" -- only the PyPI project
+# identity (and therefore the wheel filename and dist-info dir) differ.
+PYPI_DIST_NAME = "periscope-agentsview"
+PYPI_DIST_NAME_NORMALIZED = PYPI_DIST_NAME.replace("-", "_")
+
 # ---------------------------------------------------------------------------
 # Platform constants
 # ---------------------------------------------------------------------------
@@ -217,8 +229,8 @@ def build_wheel(
 
     # Normalize version for PEP 440 compliance (dashes → local identifier)
     whl_version = normalize_wheel_version(version)
-    dist_info = f"periscope-{whl_version}.dist-info"
-    whl_name = f"periscope-{whl_version}-py3-none-{wheel_tag}.whl"
+    dist_info = f"{PYPI_DIST_NAME_NORMALIZED}-{whl_version}.dist-info"
+    whl_name = f"{PYPI_DIST_NAME_NORMALIZED}-{whl_version}-py3-none-{wheel_tag}.whl"
 
     output_dir.mkdir(parents=True, exist_ok=True)
     whl_path = output_dir / whl_name
@@ -271,7 +283,7 @@ def _add(arcname: str, data: bytes, unix_mode: int = 0o644) -> None:
 def _build_metadata(version: str, readme: str | None) -> str:
     lines = [
         "Metadata-Version: 2.1",
-        "Name: periscope",
+        f"Name: {PYPI_DIST_NAME}",
         f"Version: {version}",
         "Summary: Local web viewer for AI agent sessions",
         "Home-page: https://github.com/latentsignal-org/periscope",

scripts/build_wheels_test.py

@@ -213,7 +213,7 @@ def test_nested_path_in_tar_gz(self, tmp_path: Path) -> None:
 class TestBuildWheel:
     def test_wheel_filename_matches_convention(self, tmp_path: Path) -> None:
         whl = build_wheel(b"fake", tmp_path, "0.15.0", "linux_amd64")
-        assert whl.name == "periscope-0.15.0-py3-none-manylinux_2_28_x86_64.whl"
+        assert whl.name == "periscope_agentsview-0.15.0-py3-none-manylinux_2_28_x86_64.whl"
 
     def test_wheel_is_valid_zip(self, tmp_path: Path) -> None:
         whl = build_wheel(b"fake", tmp_path, "0.15.0", "linux_amd64")
@@ -226,10 +226,10 @@ def test_wheel_contains_expected_files(self, tmp_path: Path) -> None:
         assert "periscope/__init__.py" in names
         assert "periscope/__main__.py" in names
         assert "periscope/bin/periscope" in names
-        assert "periscope-0.15.0.dist-info/METADATA" in names
-        assert "periscope-0.15.0.dist-info/WHEEL" in names
-        assert "periscope-0.15.0.dist-info/entry_points.txt" in names
-        assert "periscope-0.15.0.dist-info/RECORD" in names
+        assert "periscope_agentsview-0.15.0.dist-info/METADATA" in names
+        assert "periscope_agentsview-0.15.0.dist-info/WHEEL" in names
+        assert "periscope_agentsview-0.15.0.dist-info/entry_points.txt" in names
+        assert "periscope_agentsview-0.15.0.dist-info/RECORD" in names
 
     def test_binary_has_executable_permissions(self, tmp_path: Path) -> None:
         whl = build_wheel(b"fake", tmp_path, "0.15.0", "linux_amd64")
@@ -264,9 +264,9 @@ def test_windows_wheel_uses_exe_binary(self, tmp_path: Path) -> None:
     def test_metadata_required_fields(self, tmp_path: Path) -> None:
         whl = build_wheel(b"fake", tmp_path, "0.15.0", "linux_amd64")
         with zipfile.ZipFile(whl) as zf:
-            metadata = zf.read("periscope-0.15.0.dist-info/METADATA").decode()
+            metadata = zf.read("periscope_agentsview-0.15.0.dist-info/METADATA").decode()
         assert "Metadata-Version: 2.1" in metadata
-        assert "Name: periscope" in metadata
+        assert "Name: periscope-agentsview" in metadata
         assert "Version: 0.15.0" in metadata
         assert "Requires-Python: >=3.9" in metadata
         assert "License: MIT" in metadata
@@ -275,21 +275,21 @@ def test_metadata_required_fields(self, tmp_path: Path) -> None:
     def test_wheel_file_has_root_is_purelib_false(self, tmp_path: Path) -> None:
         whl = build_wheel(b"fake", tmp_path, "0.15.0", "linux_amd64")
         with zipfile.ZipFile(whl) as zf:
-            wheel_meta = zf.read("periscope-0.15.0.dist-info/WHEEL").decode()
+            wheel_meta = zf.read("periscope_agentsview-0.15.0.dist-info/WHEEL").decode()
         assert "Root-Is-Purelib: false" in wheel_meta
         assert "Generator: periscope-build-wheels" in wheel_meta
 
     def test_entry_points_correct(self, tmp_path: Path) -> None:
         whl = build_wheel(b"fake", tmp_path, "0.15.0", "linux_amd64")
         with zipfile.ZipFile(whl) as zf:
-            ep = zf.read("periscope-0.15.0.dist-info/entry_points.txt").decode()
+            ep = zf.read("periscope_agentsview-0.15.0.dist-info/entry_points.txt").decode()
         assert "[console_scripts]" in ep
         assert "periscope = periscope:main" in ep
 
     def test_record_contains_hashes(self, tmp_path: Path) -> None:
         whl = build_wheel(b"fake", tmp_path, "0.15.0", "linux_amd64")
         with zipfile.ZipFile(whl) as zf:
-            record = zf.read("periscope-0.15.0.dist-info/RECORD").decode()
+            record = zf.read("periscope_agentsview-0.15.0.dist-info/RECORD").decode()
         # Each non-RECORD entry should have a sha256 hash
         lines = [ln for ln in record.splitlines() if ln.strip()]
         record_line = None
@@ -306,7 +306,7 @@ def test_readme_included_in_metadata(self, tmp_path: Path) -> None:
         readme = "# periscope\nA great tool."
         whl = build_wheel(b"fake", tmp_path, "0.15.0", "linux_amd64", readme=readme)
         with zipfile.ZipFile(whl) as zf:
-            metadata = zf.read("periscope-0.15.0.dist-info/METADATA").decode()
+            metadata = zf.read("periscope_agentsview-0.15.0.dist-info/METADATA").decode()
         assert "A great tool." in metadata
 
     def test_init_py_uses_execvp_on_unix(self, tmp_path: Path) -> None:
@@ -330,12 +330,12 @@ def test_wheel_filename_with_normalized_version(self, tmp_path: Path) -> None:
         )
         assert (
             whl.name
-            == "periscope-0.29.2+periscope.2.258218f5-py3-none-manylinux_2_28_x86_64.whl"
+            == "periscope_agentsview-0.29.2+periscope.2.258218f5-py3-none-manylinux_2_28_x86_64.whl"
         )
 
     def test_wheel_filename_darwin_arm64(self, tmp_path: Path) -> None:
         whl = build_wheel(b"fake", tmp_path, "1.0.0", "darwin_arm64")
-        assert whl.name == "periscope-1.0.0-py3-none-macosx_11_0_arm64.whl"
+        assert whl.name == "periscope_agentsview-1.0.0-py3-none-macosx_11_0_arm64.whl"
 
 
 # ---------------------------------------------------------------------------
@@ -381,12 +381,12 @@ def test_correct_wheel_names(self, tmp_path: Path) -> None:
         wheels = build_all_wheels(input_dir, output_dir, "0.15.0")
         names = {w.name for w in wheels}
         expected = {
-            "periscope-0.15.0-py3-none-manylinux_2_28_x86_64.whl",
-            "periscope-0.15.0-py3-none-manylinux_2_28_aarch64.whl",
-            "periscope-0.15.0-py3-none-macosx_11_0_x86_64.whl",
-            "periscope-0.15.0-py3-none-macosx_11_0_arm64.whl",
-            "periscope-0.15.0-py3-none-win_amd64.whl",
-            "periscope-0.15.0-py3-none-win_arm64.whl",
+            "periscope_agentsview-0.15.0-py3-none-manylinux_2_28_x86_64.whl",
+            "periscope_agentsview-0.15.0-py3-none-manylinux_2_28_aarch64.whl",
+            "periscope_agentsview-0.15.0-py3-none-macosx_11_0_x86_64.whl",
+            "periscope_agentsview-0.15.0-py3-none-macosx_11_0_arm64.whl",
+            "periscope_agentsview-0.15.0-py3-none-win_amd64.whl",
+            "periscope_agentsview-0.15.0-py3-none-win_arm64.whl",
         }
         assert names == expected