vexy-overnight 1.0.3__tar.gz

vexy_overnight-1.0.3/.gitignore

@@ -0,0 +1,301 @@
+__pycache__/
+__version__.py
+_Chutzpah*
+_deps
+_NCrunch_*
+_pkginfo.txt
+_private
+_Pvt_Extensions
+_ReSharper*/
+_TeamCity*
+_UpgradeReport_Files/
+_version.py
+!?*.[Cc]ache/
+!.axoCover/settings.json
+!.vscode/extensions.json
+!.vscode/launch.json
+!.vscode/settings.json
+!.vscode/tasks.json
+!**/[Pp]ackages/build/
+!Directory.Build.rsp
+!dist/.gitkeep
+._*
+.*crunch*.local.xml
+.axoCover/*
+.builds
+.cache
+.coverage
+.coverage.*
+.cr/personal
+.DS_Store
+.DS_Store?
+.eggs/
+.env
+.fake/
+.history/
+.hypothesis/
+.idea/
+.installed.cfg
+.ionide/
+.localhistory/
+.mfractor/
+.mypy_cache
+.nox/
+.ntvs_analysis.dat
+.paket/paket.exe
+.pytest_cache/
+.Python
+.ruff_cache/
+.sass-cache/
+.Spotlight-V100
+.tox/
+.Trashes
+.venv
+.vs/
+.vscode
+.vscode/
+.vscode/*
+.vshistory/
+[Aa][Rr][Mm]/
+[Aa][Rr][Mm]64/
+[Bb]in/
+[Bb]uild[Ll]og.*
+[Dd]ebug/
+[Dd]ebugPS/
+[Dd]ebugPublic/
+[Ee]xpress/
+[Ll]og/
+[Ll]ogs/
+[Oo]bj/
+[Rr]elease/
+[Rr]eleasePS/
+[Rr]eleases/
+[Tt]est[Rr]esult*/
+[Ww][Ii][Nn]32/
+*_autogen/
+*_h.h
+*_i.c
+*_p.c
+*_wpftmp.csproj
+*- [Bb]ackup ([0-9]).rdl
+*- [Bb]ackup ([0-9][0-9]).rdl
+*- [Bb]ackup.rdl
+*.[Cc]ache
+*.[Pp]ublish.xml
+*.[Rr]e[Ss]harper
+*.a
+*.app
+*.appx
+*.appxbundle
+*.appxupload
+*.aps
+*.azurePubxml
+*.bim_*.settings
+*.bim.layout
+*.binlog
+*.btm.cs
+*.btp.cs
+*.build.csdef
+*.cab
+*.cachefile
+*.code-workspace
+*.cover
+*.coverage
+*.coveragexml
+*.d
+*.dbmdl
+*.dbproj.schemaview
+*.dll
+*.dotCover
+*.DotSettings.user
+*.dsp
+*.dsw
+*.dylib
+*.e2e
+*.egg
+*.egg-info/
+*.exe
+*.gch
+*.GhostDoc.xml
+*.gpState
+*.ilk
+*.iobj
+*.ipdb
+*.jfm
+*.jmconfig
+*.la
+*.lai
+*.ldf
+*.lib
+*.lo
+*.log
+*.mdf
+*.meta
+*.mm.*
+*.mod
+*.msi
+*.msix
+*.msm
+*.msp
+*.ncb
+*.ndf
+*.nuget.props
+*.nuget.targets
+*.nupkg
+*.nvuser
+*.o
+*.obj
+*.odx.cs
+*.opendb
+*.opensdf
+*.opt
+*.out
+*.pch
+*.pdb
+*.pfx
+*.pgc
+*.pgd
+*.pidb
+*.plg
+*.psess
+*.publishproj
+*.publishsettings
+*.pubxml
+*.py,cover
+*.py[cod]
+*.pyc
+*.rdl.data
+*.rptproj.bak
+*.rptproj.rsuser
+*.rsp
+*.rsuser
+*.sap
+*.sbr
+*.scc
+*.sdf
+*.sln.docstates
+*.sln.iml
+*.slo
+*.smod
+*.snupkg
+*.so
+*.suo
+*.svclog
+*.swo
+*.swp
+*.tlb
+*.tlh
+*.tli
+*.tlog
+*.tmp
+*.tmp_proj
+*.tss
+*.user
+*.userosscache
+*.userprefs
+*.vbp
+*.vbw
+*.VC.db
+*.VC.VC.opendb
+*.VisualState.xml
+*.vsp
+*.vspscc
+*.vspx
+*.vssscc
+*.xsd.cs
+**/[Pp]ackages/*
+**/*.DesktopClient/GeneratedArtifacts
+**/*.DesktopClient/ModelManifest.xml
+**/*.HTMLClient/GeneratedArtifacts
+**/*.Server/GeneratedArtifacts
+**/*.Server/ModelManifest.xml
+*~
+*$py.class
+~$*
+$tf/
+AppPackages/
+artifacts/
+ASALocalRun/
+AutoTest.Net/
+Backup*/
+BenchmarkDotNet.Artifacts/
+bld/
+build/
+BundleArtifacts/
+ClientBin/
+cmake_install.cmake
+CMakeCache.txt
+CMakeFiles
+CMakeLists.txt.user
+CMakeScripts
+CMakeUserPresets.json
+compile_commands.json
+cover/
+coverage.xml
+coverage*.info
+coverage*.json
+coverage*.xml
+csx/
+CTestTestfile.cmake
+develop-eggs/
+dlldata.c
+DocProject/buildhelp/
+DocProject/Help/*.hhc
+DocProject/Help/*.hhk
+DocProject/Help/*.hhp
+DocProject/Help/*.HxC
+DocProject/Help/*.HxT
+DocProject/Help/html
+DocProject/Help/Html2
+downloads/
+ecf/
+eggs/
+ehthumbs.db
+env.bak/
+env/
+ENV/
+external
+FakesAssemblies/
+FodyWeavers.xsd
+Generated_Code/
+Generated\ Files/
+healthchecksdb
+htmlcov/
+install_manifest.txt
+ipch/
+lib/
+lib64/
+Makefile
+MANIFEST
+MigrationBackup/
+mono_crash.*
+nCrunchTemp_*
+node_modules/
+nosetests.xml
+nunit-*.xml
+OpenCover/
+orleans.codegen.cs
+Package.StoreAssociation.xml
+paket-files/
+parts/
+project.fragment.lock.json
+project.lock.json
+publish/
+PublishScripts/
+rcf/
+ScaffoldingReadMe.txt
+sdist/
+ServiceFabricBackup/
+StyleCopReport.xml
+Testing
+TestResult.xml
+Thumbs.db
+UpgradeLog*.htm
+UpgradeLog*.XML
+var/
+venv.bak/
+venv/
+VERSION.txt
+wheels/
+x64/
+x86/

vexy_overnight-1.0.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Fontlab Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

vexy_overnight-1.0.3/PKG-INFO

@@ -0,0 +1,266 @@
+Metadata-Version: 2.4
+Name: vexy-overnight
+Version: 1.0.3
+Project-URL: Documentation, https://github.com/vexyart/vexy-overnight#readme
+Project-URL: Issues, https://github.com/vexyart/vexy-overnight/issues
+Project-URL: Source, https://github.com/vexyart/vexy-overnight
+Author-email: Fontlab Ltd <opensource@vexy.art>
+License: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.10
+Requires-Dist: fire>=0.6.0
+Requires-Dist: loguru<1.0,>=0.7
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tomli-w>=1.0.0
+Requires-Dist: tomli>=2.0.0
+Provides-Extra: dev
+Requires-Dist: hatch>=1.12.0; extra == 'dev'
+Requires-Dist: mypy>=1.15.0; extra == 'dev'
+Requires-Dist: pre-commit>=4.1.0; extra == 'dev'
+Requires-Dist: ruff>=0.9.7; extra == 'dev'
+Requires-Dist: uv>=0.5.8; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: myst-parser>=3.0.0; extra == 'docs'
+Requires-Dist: sphinx-autodoc-typehints>=2.0.0; extra == 'docs'
+Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == 'docs'
+Requires-Dist: sphinx>=7.2.6; extra == 'docs'
+Provides-Extra: test
+Requires-Dist: coverage[toml]>=7.6.12; extra == 'test'
+Requires-Dist: pytest-asyncio>=0.25.3; extra == 'test'
+Requires-Dist: pytest-benchmark[histogram]>=5.1.0; extra == 'test'
+Requires-Dist: pytest-cov>=6.0.0; extra == 'test'
+Requires-Dist: pytest-xdist>=3.6.1; extra == 'test'
+Requires-Dist: pytest>=8.3.4; extra == 'test'
+Description-Content-Type: text/markdown
+
+# Vexy Overnight Manager (vomgr)
+
+A unified management tool for AI assistant CLIs (Claude, Codex, Gemini), providing streamlined launching, automated continuation workflows, and configuration synchronization.
+
+## Overview
+
+Vexy Overnight Manager (`vomgr`) consolidates and simplifies the management of multiple AI assistant CLIs, replacing a collection of over-engineered legacy tools with a single, maintainable Python package. It handles:
+
+- **Unified Launching**: Start Claude, Codex, or Gemini with consistent interfaces
+- **Automated Continuation**: Smart session continuation when tasks complete
+- **Configuration Management**: Safe editing of CLI configuration files
+- **Rules Synchronization**: Keep instruction files (CLAUDE.md, AGENTS.md, etc.) in sync
+- **Tool Updates**: Manage updates for all CLI tools from one place
+
+## Features
+
+### Core Commands
+
+- `vomgr install` - Set up continuation hooks and configurations
+- `vomgr enable/disable <tool>` - Toggle continuation automation
+- `vomgr run <tool>` - Launch AI assistants with proper settings
+- `vomgr rules` - Synchronize instruction files across projects
+- `vomgr update` - Update CLI tools and the package itself
+- `vomgr status` - View current configuration state
+
+### Simplified Launchers
+
+- `vocl` - Launch Claude with optimized settings
+- `voco` - Launch Codex with profile management
+- `voge` - Launch Gemini with appropriate flags
+
+### Continuation Tools
+
+- `vocl-go` - Auto-continue Claude sessions (replaces 1500+ line claude4ever.py)
+- `voco-go` - Auto-continue Codex sessions (replaces complex codex4ever.py)
+- `voge-go` - Gemini continuation (when API available)
+
+## Installation
+
+```bash
+# Install from PyPI
+pip install vexy-overnight
+
+# Or with uv (recommended)
+uv add vexy-overnight
+
+# Install and configure
+vomgr install
+```
+
+## Quick Start
+
+```bash
+# Enable continuation for Claude
+vomgr enable claude
+
+# Launch Claude with continuation enabled
+vocl
+# Or
+vomgr run claude
+
+# Sync instruction files in current project
+vomgr rules sync
+
+# Update all CLI tools
+vomgr update --cli
+
+# Check status
+vomgr status
+```
+
+## Usage Examples
+
+### Managing Continuation Hooks
+
+```bash
+# Enable auto-continuation for Claude and Codex
+vomgr enable claude
+vomgr enable codex
+
+# Disable continuation for specific tool
+vomgr disable claude
+
+# Check what's enabled
+vomgr status
+```
+
+### Instruction File Management
+
+```bash
+# Sync instruction files (CLAUDE.md, AGENTS.md, etc.) in current directory
+vomgr rules sync
+
+# Append text to all instruction files
+vomgr rules append "Additional instructions here"
+
+# Search in instruction files
+vomgr rules search "pattern"
+
+# Replace text across instruction files
+vomgr rules replace "old text" "new text"
+
+# Manage global instruction files in home directory
+vomgr rules --global sync
+```
+
+### Launching AI Assistants
+
+```bash
+# Direct launchers (installed as console scripts)
+vocl                    # Launch Claude
+voco -m gpt5           # Launch Codex with gpt5 profile
+voge                    # Launch Gemini
+
+# Via vomgr
+vomgr run claude --cwd /path/to/project
+vomgr run codex --profile o3
+vomgr run gemini
+```
+
+### Updates and Maintenance
+
+```bash
+# Check for updates
+vomgr update --check
+
+# Update CLI tools (claude, codex, gemini)
+vomgr update --cli
+
+# Update vexy-overnight itself
+vomgr update --self
+
+# Update everything
+vomgr update --all
+
+# Dry run (show what would be updated)
+vomgr update --cli --dry-run
+```
+
+## Architecture
+
+### Simplified Design
+
+Unlike the legacy tools with 1500+ lines of complex async code, vexy-overnight:
+
+- **No iTerm2 dependency**: Uses standard subprocess calls
+- **No TTS**: Simple logging instead of speech synthesis
+- **No state machines**: Straightforward procedural flow
+- **Minimal dependencies**: Just essential packages
+- **Testable**: Every component is unit-testable
+- **Maintainable**: Clear, simple code under 200 lines per file
+
+### Configuration Safety
+
+- Creates backups before any config modification
+- Validates changes after editing
+- Provides rollback on errors
+- Preserves all existing user settings
+- Uses proper JSON/TOML libraries (no regex hacks)
+
+## Migration from Legacy Tools
+
+If you're using the old tools (claude4ever.py, codex4ever.py, etc.):
+
+```bash
+# Back up existing configurations
+vomgr install --backup-legacy
+
+# Migration automatically preserves your settings
+vomgr install --migrate
+
+# Old tools remain available until you're ready
+# Both can coexist during transition
+```
+
+## Development
+
+This project uses modern Python packaging with [uv](https://github.com/astral-sh/uv):
+
+```bash
+# Clone repository
+git clone https://github.com/vexyart/vexy-overnight
+cd vexy-overnight
+
+# Set up development environment
+uv venv --python 3.12
+uv sync
+
+# Run tests
+python -m pytest -xvs
+
+# Run with coverage
+python -m pytest --cov=src --cov-report=term-missing
+
+# Type checking
+uvx mypy src/
+
+# Format code
+uvx ruff format src/ tests/
+```
+
+## Requirements
+
+- Python 3.12+
+- One or more AI CLI tools installed:
+  - Claude Code (`npm install -g @anthropic-ai/claude-code`)
+  - Codex (`brew install codex` or from source)
+  - Gemini CLI (`npm install -g @google/gemini-cli`)
+
+## License
+
+MIT License
+
+## Contributing
+
+Contributions welcome! Please ensure:
+- All tests pass
+- 80%+ code coverage
+- Type hints on all functions
+- No functions over 20 lines
+- No files over 200 lines 

vexy_overnight-1.0.3/README.md

@@ -0,0 +1,221 @@
+# Vexy Overnight Manager (vomgr)
+
+A unified management tool for AI assistant CLIs (Claude, Codex, Gemini), providing streamlined launching, automated continuation workflows, and configuration synchronization.
+
+## Overview
+
+Vexy Overnight Manager (`vomgr`) consolidates and simplifies the management of multiple AI assistant CLIs, replacing a collection of over-engineered legacy tools with a single, maintainable Python package. It handles:
+
+- **Unified Launching**: Start Claude, Codex, or Gemini with consistent interfaces
+- **Automated Continuation**: Smart session continuation when tasks complete
+- **Configuration Management**: Safe editing of CLI configuration files
+- **Rules Synchronization**: Keep instruction files (CLAUDE.md, AGENTS.md, etc.) in sync
+- **Tool Updates**: Manage updates for all CLI tools from one place
+
+## Features
+
+### Core Commands
+
+- `vomgr install` - Set up continuation hooks and configurations
+- `vomgr enable/disable <tool>` - Toggle continuation automation
+- `vomgr run <tool>` - Launch AI assistants with proper settings
+- `vomgr rules` - Synchronize instruction files across projects
+- `vomgr update` - Update CLI tools and the package itself
+- `vomgr status` - View current configuration state
+
+### Simplified Launchers
+
+- `vocl` - Launch Claude with optimized settings
+- `voco` - Launch Codex with profile management
+- `voge` - Launch Gemini with appropriate flags
+
+### Continuation Tools
+
+- `vocl-go` - Auto-continue Claude sessions (replaces 1500+ line claude4ever.py)
+- `voco-go` - Auto-continue Codex sessions (replaces complex codex4ever.py)
+- `voge-go` - Gemini continuation (when API available)
+
+## Installation
+
+```bash
+# Install from PyPI
+pip install vexy-overnight
+
+# Or with uv (recommended)
+uv add vexy-overnight
+
+# Install and configure
+vomgr install
+```
+
+## Quick Start
+
+```bash
+# Enable continuation for Claude
+vomgr enable claude
+
+# Launch Claude with continuation enabled
+vocl
+# Or
+vomgr run claude
+
+# Sync instruction files in current project
+vomgr rules sync
+
+# Update all CLI tools
+vomgr update --cli
+
+# Check status
+vomgr status
+```
+
+## Usage Examples
+
+### Managing Continuation Hooks
+
+```bash
+# Enable auto-continuation for Claude and Codex
+vomgr enable claude
+vomgr enable codex
+
+# Disable continuation for specific tool
+vomgr disable claude
+
+# Check what's enabled
+vomgr status
+```
+
+### Instruction File Management
+
+```bash
+# Sync instruction files (CLAUDE.md, AGENTS.md, etc.) in current directory
+vomgr rules sync
+
+# Append text to all instruction files
+vomgr rules append "Additional instructions here"
+
+# Search in instruction files
+vomgr rules search "pattern"
+
+# Replace text across instruction files
+vomgr rules replace "old text" "new text"
+
+# Manage global instruction files in home directory
+vomgr rules --global sync
+```
+
+### Launching AI Assistants
+
+```bash
+# Direct launchers (installed as console scripts)
+vocl                    # Launch Claude
+voco -m gpt5           # Launch Codex with gpt5 profile
+voge                    # Launch Gemini
+
+# Via vomgr
+vomgr run claude --cwd /path/to/project
+vomgr run codex --profile o3
+vomgr run gemini
+```
+
+### Updates and Maintenance
+
+```bash
+# Check for updates
+vomgr update --check
+
+# Update CLI tools (claude, codex, gemini)
+vomgr update --cli
+
+# Update vexy-overnight itself
+vomgr update --self
+
+# Update everything
+vomgr update --all
+
+# Dry run (show what would be updated)
+vomgr update --cli --dry-run
+```
+
+## Architecture
+
+### Simplified Design
+
+Unlike the legacy tools with 1500+ lines of complex async code, vexy-overnight:
+
+- **No iTerm2 dependency**: Uses standard subprocess calls
+- **No TTS**: Simple logging instead of speech synthesis
+- **No state machines**: Straightforward procedural flow
+- **Minimal dependencies**: Just essential packages
+- **Testable**: Every component is unit-testable
+- **Maintainable**: Clear, simple code under 200 lines per file
+
+### Configuration Safety
+
+- Creates backups before any config modification
+- Validates changes after editing
+- Provides rollback on errors
+- Preserves all existing user settings
+- Uses proper JSON/TOML libraries (no regex hacks)
+
+## Migration from Legacy Tools
+
+If you're using the old tools (claude4ever.py, codex4ever.py, etc.):
+
+```bash
+# Back up existing configurations
+vomgr install --backup-legacy
+
+# Migration automatically preserves your settings
+vomgr install --migrate
+
+# Old tools remain available until you're ready
+# Both can coexist during transition
+```
+
+## Development
+
+This project uses modern Python packaging with [uv](https://github.com/astral-sh/uv):
+
+```bash
+# Clone repository
+git clone https://github.com/vexyart/vexy-overnight
+cd vexy-overnight
+
+# Set up development environment
+uv venv --python 3.12
+uv sync
+
+# Run tests
+python -m pytest -xvs
+
+# Run with coverage
+python -m pytest --cov=src --cov-report=term-missing
+
+# Type checking
+uvx mypy src/
+
+# Format code
+uvx ruff format src/ tests/
+```
+
+## Requirements
+
+- Python 3.12+
+- One or more AI CLI tools installed:
+  - Claude Code (`npm install -g @anthropic-ai/claude-code`)
+  - Codex (`brew install codex` or from source)
+  - Gemini CLI (`npm install -g @google/gemini-cli`)
+
+## License
+
+MIT License
+
+## Contributing
+
+Contributions welcome! Please ensure:
+- All tests pass
+- 80%+ code coverage
+- Type hints on all functions
+- No functions over 20 lines
+- No files over 200 lines 

vexy_overnight-1.0.3/pyproject.toml

@@ -0,0 +1,389 @@
+# this_file: pyproject.toml
+#==============================================================================
+# VEXY-OVERNIGHT PACKAGE CONFIGURATION
+# This pyproject.toml defines the package metadata, dependencies, build system,
+# and development environment for the vexy-overnight package.
+#==============================================================================
+
+#------------------------------------------------------------------------------
+# PROJECT METADATA
+# Core package information used by PyPI and package managers.
+#------------------------------------------------------------------------------
+[project]
+name = 'vexy-overnight' # Package name on PyPI
+description = '' # Short description
+readme = 'README.md' # Path to README file
+requires-python = '>=3.10' # Minimum Python version
+keywords = [
+] # Keywords for PyPI search
+dynamic = ["version"] # Fields set dynamically at build time
+
+# PyPI classifiers for package categorization
+classifiers = [
+    'Development Status :: 4 - Beta', # Package maturity level
+    'Programming Language :: Python',
+    'Programming Language :: Python :: 3.10',
+    'Programming Language :: Python :: 3.11',
+    'Programming Language :: Python :: 3.12',
+    'Programming Language :: Python :: Implementation :: CPython',
+    'Programming Language :: Python :: Implementation :: PyPy',
+    'Operating System :: OS Independent',
+    'License :: OSI Approved :: MIT License',
+    'Intended Audience :: Developers',
+]
+
+dependencies = [
+    'loguru>=0.7,<1.0',
+    "fire>=0.6.0",
+    'rich>=13.0.0',
+    'tomli>=2.0.0',
+    'tomli-w>=1.0.0',
+]
+
+# Author information
+[[project.authors]]
+name = 'Fontlab Ltd'
+email = 'opensource@vexy.art'
+
+# License information
+[project.license]
+text = 'MIT'
+
+# Project URLs
+[project.urls]
+Documentation = 'https://github.com/vexyart/vexy-overnight#readme'
+Issues = 'https://github.com/vexyart/vexy-overnight/issues'
+Source = 'https://github.com/vexyart/vexy-overnight'
+
+#------------------------------------------------------------------------------
+# OPTIONAL DEPENDENCIES
+# Additional dependencies for optional features, development, and testing.
+#------------------------------------------------------------------------------
+[project.optional-dependencies]
+
+# Development tools
+dev = [
+    'hatch>=1.12.0', # Project management and build tooling
+    'uv>=0.5.8', # Fast dependency resolver and installer
+    'ruff>=0.9.7', # Linting and formatting
+    'mypy>=1.15.0', # Type checking
+    'pre-commit>=4.1.0', # Git hook management
+]
+
+# Testing tools and frameworks
+test = [
+    'pytest>=8.3.4', # Testing framework - Keep pytest as is, update if newer pytest version is required
+    'pytest-cov>=6.0.0', # Coverage plugin for pytest - Keep pytest-cov as is, update if newer pytest-cov version is required
+    'pytest-xdist>=3.6.1', # Parallel test execution - Keep pytest-xdist as is, update if newer pytest-xdist version is required
+    'pytest-benchmark[histogram]>=5.1.0', # Benchmarking plugin - Keep pytest-benchmark as is, update if newer pytest-benchmark version is required
+    'pytest-asyncio>=0.25.3', # Async test support - Keep pytest-asyncio as is, update if newer pytest-asyncio version is required
+    'coverage[toml]>=7.6.12',
+]
+
+docs = [
+    "sphinx>=7.2.6",
+    "sphinx-rtd-theme>=2.0.0",
+    "sphinx-autodoc-typehints>=2.0.0",
+    "myst-parser>=3.0.0", # Markdown support in Sphinx
+]
+
+#------------------------------------------------------------------------------
+# COMMAND-LINE SCRIPTS
+# Entry points for command-line executables installed with the package.
+#------------------------------------------------------------------------------
+[project.scripts]
+vomgr = "vexy_overnight.cli:main"
+vocl = "vexy_overnight.launchers:vocl"
+voco = "vexy_overnight.launchers:voco"
+voge = "vexy_overnight.launchers:voge"
+
+#------------------------------------------------------------------------------
+# BUILD SYSTEM CONFIGURATION
+# Defines the tools required to build the package and the build backend.
+#------------------------------------------------------------------------------
+[build-system]
+# Hatchling is a modern build backend for Python packaging
+# hatch-vcs integrates with version control systems for versioning
+requires = [
+    'hatchling>=1.27.0', # Keep hatchling as is, update if newer hatchling version is required
+    'hatch-vcs>=0.4.0', # Keep hatch-vcs as is, update if newer hatch-vcs version is required
+]
+build-backend = 'hatchling.build' # Specifies Hatchling as the build backend
+
+
+#------------------------------------------------------------------------------
+# HATCH BUILD CONFIGURATION
+# Configures the build process, specifying which packages to include and
+# how to handle versioning.
+#------------------------------------------------------------------------------
+[tool.hatch.build]
+# Include package data files
+include = [
+    "src/vexy_overnight/py.typed", # For better type checking support
+    "src/vexy_overnight/data/**/*", # Include data files if any
+
+]
+exclude = ["**/__pycache__", "**/.pytest_cache", "**/.mypy_cache"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/vexy_overnight"]
+reproducible = true
+
+
+# Version control system hook configuration
+# Automatically updates the version file from git tags
+[tool.hatch.build.hooks.vcs]
+version-file = "src/vexy_overnight/__version__.py"
+
+# Version source configuration
+[tool.hatch.version]
+source = 'vcs' # Get version from git tags or other VCS info
+
+[tool.hatch.version.vcs]
+tag-pattern = '^(?:v)?(?P<version>\d+\.\d+\.\d+)$' # Enforce semantic version tags like v1.2.3
+
+# Metadata handling configuration
+[tool.hatch.metadata]
+allow-direct-references = true # Allow direct references in metadata (useful for local dependencies)
+
+
+#------------------------------------------------------------------------------
+# UV CONFIGURATION
+# Settings for uv so the project is always treated as a package.
+#------------------------------------------------------------------------------
+[tool.uv]
+package = true
+
+
+#------------------------------------------------------------------------------
+# DEVELOPMENT ENVIRONMENTS
+
+[tool.hatch.envs.default]
+installer = 'uv'
+features = ['dev', 'test']
+dependencies = [
+]
+
+# Commands available in the default environment
+[tool.hatch.envs.default.scripts]
+# Run tests with optional arguments
+test = 'python -m pytest {args:tests}'
+# Run tests with coverage reporting
+test-cov = "python -m pytest --cov-report=term-missing --cov-config=pyproject.toml --cov=src/vexy_overnight --cov=tests {args:tests}"
+# Run type checking
+type-check = "python -m mypy src/vexy_overnight tests"
+# Run linting and formatting
+lint = ["python -m ruff check src/vexy_overnight tests", "python -m ruff format --respect-gitignore src/vexy_overnight tests"]
+# Format and fix style issues
+fmt = ["python -m ruff format --respect-gitignore src/vexy_overnight tests", "python -m ruff check --fix src/vexy_overnight tests"]
+fix = ["python -m ruff check --fix --unsafe-fixes src/vexy_overnight tests", "python -m ruff format --respect-gitignore src/vexy_overnight tests"]
+
+#------------------------------------------------------------------------------
+# SPECIALIZED ENVIRONMENTS
+# Additional environments for specific development tasks.
+#------------------------------------------------------------------------------
+
+# Dedicated environment for linting and code quality checks
+[tool.hatch.envs.lint]
+detached = true # Create a separate, isolated environment
+features = ['dev'] # Use dev extras  dependencies 
+installer = 'uv'
+
+# Linting environment commands
+[tool.hatch.envs.lint.scripts]
+# Type checking with automatic type installation
+typing = "python -m mypy --install-types --non-interactive {args:src/vexy_overnight tests}"
+# Check style and format code
+style = ["python -m ruff check {args:.}", "python -m ruff format --respect-gitignore {args:.}"]
+# Format and fix style issues
+fmt = ["python -m ruff format --respect-gitignore {args:.}", "python -m ruff check --fix {args:.}"]
+fix = ["python -m ruff check --fix --unsafe-fixes {args:.}", "python -m ruff format --respect-gitignore {args:.}"]
+# Run all ops
+all = ["style", "typing", "fix"]
+
+# Dedicated environment for testing
+[tool.hatch.envs.test]
+features = ['test'] # Use test extras as dependencies
+installer = 'uv'
+
+# Testing environment commands
+[tool.hatch.envs.test.scripts]
+# Run tests in parallel
+test = "python -m pytest -n auto {args:tests}"
+# Run tests with coverage in parallel
+test-cov = "python -m pytest -n auto --cov-report=term-missing --cov-config=pyproject.toml --cov=src/vexy_overnight --cov=tests {args:tests}"
+# Run benchmarks
+bench = "python -m pytest -v -p no:briefcase tests/test_benchmark.py --benchmark-only"
+# Run benchmarks and save results
+bench-save = "python -m pytest -v -p no:briefcase tests/test_benchmark.py --benchmark-only --benchmark-json=benchmark/results.json"
+
+# Documentation environment
+[tool.hatch.envs.docs]
+features = ['docs']
+installer = 'uv'
+
+# Documentation environment commands
+[tool.hatch.envs.docs.scripts]
+build = "python -m sphinx -b html docs/source docs/build"
+
+# GitHub Actions workflow configuration
+[tool.hatch.envs.ci]
+features = ['test']
+installer = 'uv'
+
+
+[tool.hatch.envs.ci.scripts]
+test = "python -m pytest --cov=src/vexy_overnight --cov-report=xml"
+
+
+#------------------------------------------------------------------------------
+# CODE QUALITY TOOLS
+# Configuration for linting, formatting, and code quality enforcement.
+#------------------------------------------------------------------------------
+
+#------------------------------------------------------------------------------
+# COVERAGE CONFIGURATION
+# Settings for test coverage measurement and reporting.
+#------------------------------------------------------------------------------
+
+# Path mapping for coverage in different environments
+[tool.coverage.paths]
+vexy_overnight = ["src/vexy_overnight", "*/vexy-overnight/src/vexy_overnight"]
+tests = ["tests", "*/vexy-overnight/tests"]
+
+# Coverage report configuration
+[tool.coverage.report]
+# Lines to exclude from coverage reporting
+exclude_lines = [
+    'no cov', # Custom marker to skip coverage
+    'if __name__ == .__main__.:', # Script execution guard
+    'if TYPE_CHECKING:', # Type checking imports and code
+    'pass', # Empty pass statements
+    'raise NotImplementedError', # Unimplemented method placeholders
+    'raise ImportError', # Import error handling
+    'except ImportError', # Import error handling
+    'except KeyError', # Common error handling
+    'except AttributeError', # Common error handling
+    'except NotImplementedError', # Common error handling
+]
+
+[tool.coverage.run]
+source_pkgs = ["vexy_overnight", "tests"]
+branch = true # Measure branch coverage (if/else statements)
+parallel = true # Support parallel test execution
+omit = [
+    "src/vexy_overnight/__about__.py",
+]
+
+#------------------------------------------------------------------------------
+# MYPY CONFIGURATION
+# Configuration for type checking with mypy.
+#------------------------------------------------------------------------------
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+disallow_untyped_decorators = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+warn_unreachable = true
+exclude = ["^external/"]
+
+[[tool.mypy.overrides]]
+module = ["loguru", "pytest"]
+ignore_missing_imports = true
+
+[[tool.mypy.overrides]]
+module = ["tests.*"]
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+allow_untyped_decorators = true
+
+#------------------------------------------------------------------------------
+# PYTEST CONFIGURATION
+# Configuration for pytest, including markers, options, and benchmark settings.
+#------------------------------------------------------------------------------
+
+[tool.pytest.ini_options]
+addopts = "-v --durations=10 -p no:briefcase"
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+console_output_style = "progress"
+filterwarnings = ["ignore::DeprecationWarning", "ignore::UserWarning"]
+log_cli = true
+log_cli_level = "INFO"
+markers = [
+    "benchmark: marks tests as benchmarks (select with '-m benchmark')",
+    "unit: mark a test as a unit test",
+    "integration: mark a test as an integration test",
+    "permutation: tests for permutation functionality", 
+    "parameter: tests for parameter parsing",
+    "prompt: tests for prompt parsing",
+]
+norecursedirs = [
+    ".*",
+    "build",
+    "dist", 
+    "venv",
+    "__pycache__",
+    "*.egg-info",
+    "_private",
+]
+python_classes = ["Test*"]
+python_files = ["test_*.py"]
+python_functions = ["test_*"]
+pythonpath = ["src"]
+testpaths = ["tests"]
+
+[tool.pytest-benchmark]
+min_rounds = 100
+min_time = 0.1
+histogram = true
+storage = "file"
+save-data = true
+compare = [
+    "min",    # Minimum time
+    "max",    # Maximum time
+    "mean",   # Mean time
+    "stddev", # Standard deviation
+    "median", # Median time
+    "iqr",    # Inter-quartile range
+    "ops",    # Operations per second
+    "rounds", # Number of rounds
+]
+
+#------------------------------------------------------------------------------
+# RUFF CONFIGURATION
+# Streamlined Ruff setup with pragmatic defaults.
+#------------------------------------------------------------------------------ 
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.ruff.format]
+indent-style = "space"
+quote-style = "double"
+
+[tool.ruff.lint]
+select = [
+    'E',  # pycodestyle errors
+    'F',  # pyflakes errors
+    'B',  # flake8-bugbear
+    'I',  # import sorting
+    'N',  # pep8-naming
+    'UP', # modern Python upgrades
+]
+ignore = [
+    'E501', # rely on the formatter for line length
+]
+extend-exclude = [".git", ".venv", "venv", "dist", "build"]
+
+[tool.ruff.lint.isort]
+known-first-party = ['vexy_overnight']

vexy_overnight-1.0.3/src/vexy_overnight/__version__.py

@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '1.0.3'
+__version_tuple__ = version_tuple = (1, 0, 3)
+
+__commit_id__ = commit_id = None

vexy_overnight-1.0.3/src/vexy_overnight/py.typed

@@ -0,0 +1 @@
+# this_file: src/vexy_overnight/py.typed