codebase restructure and organization.

scripts/move_wheels.py

@@ -0,0 +1,13 @@
+"""Move Poetry-built wheels from dist/ to python-dist/ to avoid conflicts
+with Electron build artifacts.
+"""
+
+import shutil
+from pathlib import Path
+
+dist = Path("dist")
+target = Path("python-dist")
+target.mkdir(parents=True, exist_ok=True)
+
+for wheel in dist.glob("*.whl"):
+    shutil.move(str(wheel), target / wheel.name)

scripts/sync_version.py

@@ -0,0 +1,64 @@
+"""Update project version references to stay aligned with the Electron build.
+
+Reads `package.json`, writes the same version into `src/version.py`, and
+updates the `[tool.poetry] version` field inside `pyproject.toml`. Run this
+before any Python packaging commands so the wheel version matches the
+Electron artifacts.
+"""
+
+import json
+import re
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+PACKAGE_JSON = ROOT / "package.json"
+VERSION_PY = ROOT / "meshchatx" / "src" / "version.py"
+PYPROJECT_TOML = ROOT / "pyproject.toml"
+
+
+def read_package_version() -> str:
+    with PACKAGE_JSON.open() as handle:
+        return json.load(handle)["version"]
+
+
+def write_version_module(version: str) -> None:
+    content = (
+        '"""\n'
+        "Auto-generated helper so Python tooling and the Electron build\n"
+        "share the same version string.\n"
+        '"""\n\n'
+        f"__version__ = {version!r}\n"
+    )
+    if VERSION_PY.exists() and VERSION_PY.read_text() == content:
+        return
+    VERSION_PY.write_text(content)
+
+
+def update_poetry_version(version: str) -> None:
+    if not PYPROJECT_TOML.exists():
+        return
+    content = PYPROJECT_TOML.read_text()
+
+    def replacer(match):
+        return f"{match.group(1)}{version}{match.group(2)}"
+
+    new_content, replaced = re.subn(
+        r'(?m)^(version\s*=\s*")[^"]*(")',
+        replacer,
+        content,
+        count=1,
+    )
+    if replaced == 0:
+        raise RuntimeError("failed to update version in pyproject.toml")
+    if new_content != content:
+        PYPROJECT_TOML.write_text(new_content)
+
+
+def main() -> None:
+    version = read_package_version()
+    write_version_module(version)
+    update_poetry_version(version)
+
+
+if __name__ == "__main__":
+    main()

scripts/test_wheel.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+set -e
+
+WHEEL_PATH="python-dist/reticulum_meshchatx-2.41.0-py3-none-any.whl"
+
+if [ ! -f "$WHEEL_PATH" ]; then
+    echo "Error: Wheel not found at $WHEEL_PATH"
+    exit 1
+fi
+
+echo "Creating test virtual environment..."
+TEST_VENV=$(mktemp -d)/test-venv
+python3 -m venv "$TEST_VENV"
+
+echo "Installing wheel..."
+"$TEST_VENV/bin/pip" install --upgrade pip
+"$TEST_VENV/bin/pip" install "$WHEEL_PATH"
+
+echo ""
+echo "Checking installation..."
+"$TEST_VENV/bin/python" << 'PYTHON_SCRIPT'
+import meshchatx.meshchat as meshchat
+import os
+from pathlib import Path
+
+# Check if meshchat module is importable
+print(f'meshchat module location: {meshchat.__file__}')
+
+# Check if public directory exists
+meshchat_dir = os.path.dirname(meshchat.__file__)
+package_dir = os.path.dirname(os.path.dirname(meshchat_dir))
+public_path = os.path.join(package_dir, 'public')
+print(f'Checking for public at: {public_path}')
+print(f'Exists: {os.path.exists(public_path)}')
+
+# Try get_file_path
+from meshchatx.meshchat import get_file_path
+test_path = get_file_path('public')
+print(f'get_file_path("public"): {test_path}')
+print(f'Exists: {os.path.exists(test_path)}')
+
+if os.path.exists(test_path):
+    index_html = os.path.join(test_path, 'index.html')
+    print(f'index.html exists: {os.path.exists(index_html)}')
+else:
+    print('WARNING: public directory not found!')
+    print('Checking parent directories...')
+    current = package_dir
+    for i in range(3):
+        test = os.path.join(current, 'public')
+        print(f'  {test}: {os.path.exists(test)}')
+        current = os.path.dirname(current)
+PYTHON_SCRIPT
+
+echo ""
+echo "Test complete. Virtual environment at: $TEST_VENV"
+echo "To test running meshchat: $TEST_VENV/bin/meshchat --help"
+