feat: Implement standalone executable builds with a new build script, PyInstaller configuration, and GitHub Actions workflow, updating the roadmap status.

Author: southpawriter02

.github/workflows/build-executables.yml

@@ -0,0 +1,61 @@
+name: Build Executables
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build:
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            platform: linux
+          - os: macos-latest
+            platform: macos
+          - os: windows-latest
+            platform: windows
+    
+    runs-on: ${{ matrix.os }}
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install pyinstaller
+      
+      - name: Build executable
+        run: python packaging/build_executable.py
+      
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: git-chronoscope-${{ matrix.platform }}
+          path: dist/git-chronoscope-*
+
+  release:
+    needs: build
+    runs-on: ubuntu-latest
+    if: github.event_name == 'release'
+    permissions:
+      contents: write
+    
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+      
+      - name: Upload to release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: artifacts/**/*

packaging/build_executable.py

@@ -0,0 +1,85 @@
+#!/usr/bin/env python3
+"""
+Build script for creating standalone executables.
+Usage: python packaging/build_executable.py
+"""
+import os
+import sys
+import subprocess
+import platform
+import shutil
+
+
+def get_platform_suffix():
+    """Get platform-specific suffix for executable."""
+    system = platform.system().lower()
+    if system == 'windows':
+        return 'windows.exe'
+    elif system == 'darwin':
+        return 'macos'
+    else:
+        return 'linux'
+
+
+def build_executable():
+    """Build the standalone executable using PyInstaller."""
+    # Get project root
+    script_dir = os.path.dirname(os.path.abspath(__file__))
+    project_root = os.path.dirname(script_dir)
+    
+    print(f"Building git-chronoscope executable for {platform.system()}...")
+    
+    # Install PyInstaller if needed
+    try:
+        import PyInstaller
+    except ImportError:
+        print("Installing PyInstaller...")
+        subprocess.check_call([sys.executable, '-m', 'pip', 'install', 'pyinstaller'])
+    
+    # Change to project root
+    os.chdir(project_root)
+    
+    # Build command
+    cmd = [
+        sys.executable, '-m', 'PyInstaller',
+        '--onefile',
+        '--name', 'git-chronoscope',
+        '--console',
+        '--clean',
+        '--noconfirm',
+        # Hidden imports for Pygments
+        '--collect-submodules', 'pygments.lexers',
+        '--collect-submodules', 'pygments.styles',
+        # Exclude unnecessary modules
+        '--exclude-module', 'tkinter',
+        '--exclude-module', 'matplotlib',
+        '--exclude-module', 'scipy',
+        '--exclude-module', 'pytest',
+        # Entry point
+        'src/main.py',
+    ]
+    
+    print(f"Running: {' '.join(cmd)}")
+    subprocess.check_call(cmd)
+    
+    # Rename output with platform suffix
+    dist_dir = os.path.join(project_root, 'dist')
+    suffix = get_platform_suffix()
+    
+    if platform.system() == 'Windows':
+        src = os.path.join(dist_dir, 'git-chronoscope.exe')
+        dst = os.path.join(dist_dir, f'git-chronoscope-{suffix}')
+    else:
+        src = os.path.join(dist_dir, 'git-chronoscope')
+        dst = os.path.join(dist_dir, f'git-chronoscope-{suffix}')
+    
+    if os.path.exists(src):
+        shutil.move(src, dst)
+        print(f"Created: {dst}")
+    
+    print("Build complete!")
+    return dst
+
+
+if __name__ == '__main__':
+    build_executable()

packaging/pyinstaller_config.py

@@ -0,0 +1,71 @@
+# PyInstaller Configuration for git-chronoscope
+# 
+# Build with:
+#   cd git-chronoscope
+#   pip install pyinstaller
+#   pyinstaller packaging/pyinstaller_config.py
+#
+# Or use the helper script:
+#   python packaging/build_executable.py
+
+import sys
+import os
+
+# Add parent directory to path for imports
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+from PyInstaller.utils.hooks import collect_submodules
+
+block_cipher = None
+
+# Collect all Pygments submodules for syntax highlighting
+hiddenimports = collect_submodules('pygments.lexers') + collect_submodules('pygments.styles')
+
+a = Analysis(
+    [os.path.join('..', 'src', 'main.py')],
+    pathex=[os.path.dirname(os.path.dirname(os.path.abspath(__file__)))],
+    binaries=[],
+    datas=[
+        (os.path.join('..', 'README.md'), '.'),
+    ],
+    hiddenimports=hiddenimports,
+    hookspath=[],
+    hooksconfig={},
+    runtime_hooks=[],
+    excludes=[
+        'tkinter',
+        'matplotlib', 
+        'scipy',
+        'numpy.testing',
+        'pytest',
+    ],
+    win_no_prefer_redirects=False,
+    win_private_assemblies=False,
+    cipher=block_cipher,
+    noarchive=False,
+)
+
+pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher)
+
+exe = EXE(
+    pyz,
+    a.scripts,
+    a.binaries,
+    a.zipfiles,
+    a.datas,
+    [],
+    name='git-chronoscope',
+    debug=False,
+    bootloader_ignore_signals=False,
+    strip=False,
+    upx=True,
+    upx_exclude=[],
+    runtime_tmpdir=None,
+    console=True,
+    disable_windowed_traceback=False,
+    argv_emulation=False,
+    target_arch=None,
+    codesign_identity=None,
+    entitlements_file=None,
+    icon=None,
+)

roadmap/distribution/03-standalone-executable.md

@@ -1,7 +1,8 @@
 # Standalone Executable
 
 ## Implementation Status
-**⏳ NOT IMPLEMENTED**
+**✅ IMPLEMENTED**
+- Implementation: `packaging/build_executable.py`, `.github/workflows/build-executables.yml`
 
 ## 1. Feature Description