#1 - change folder for module

.github/workflows/python.yml

@@ -55,7 +55,7 @@ jobs:
         run: uv run pre-commit run --all-files
 
       - name: Test with pytest
-        run: uv run pytest tests --cov=src
+        run: uv run pytest --cov=src
 
       - name: Minimize uv cache
         run: uv cache prune --ci

.gitignore

@@ -172,3 +172,5 @@ cython_debug/
 
 # PyPI configuration file
 .pypirc
+
+.idea

.pre-commit-config.yaml

@@ -57,7 +57,6 @@ repos:
             --wrap-descriptions,
             "90",
             src,
-            tests,
           ]
 
   # bandit - find common security issues
@@ -66,10 +65,8 @@ repos:
     hooks:
       - id: bandit
         name: bandit
-        exclude: ^tests/
-        args:
-          - -r
-          - src
+        args: ["-r", "src", "-x", "*/tests/*"]
+        pass_filenames: false
 
   # prettier - formatting JS, CSS, JSON, Markdown, ...
   - repo: https://github.com/pre-commit/mirrors-prettier

shared/utils/README.md

@@ -0,0 +1,52 @@
+# Shared Utils
+
+Shared utilities and common functionality used across multiple modules in the project.
+
+## Structure
+
+```
+shared/utils/
+├── src/utils/        # Shared utilities source code
+├── pyproject.toml    # Package configuration
+└── README.md         # This file
+```
+
+## Overview
+
+This package contains reusable utility functions, helpers, and common code that can be shared between different modules of the application. It provides a centralized location for:
+
+- Common data structures and types
+- Utility functions and helpers
+- Shared configuration utilities
+- Cross-module interfaces and contracts
+
+## Installation
+
+The shared utilities are installed as a local package dependency. To install in development mode:
+
+```bash
+pip install -e shared/utils/
+```
+
+## Usage
+
+Import utilities from the shared package:
+
+```python
+from utils import your_utility_function
+# or
+from utils.module_name import specific_function
+```
+
+## Development
+
+When adding new shared utilities:
+
+1. Place them in the appropriate module under `src/utils/`
+2. Update the package's `__init__.py` if needed
+3. Add tests for new functionality
+4. Update this README if adding major new features
+
+## Dependencies
+
+Check `pyproject.toml` for current dependencies and requirements.

src/core/README.md

@@ -5,18 +5,18 @@ Core application module providing CLI interface and business logic functionality
 ## 📁 Structure
 
 ```
-src/
-├── clients/          # HTTP clients and external integrations
-├── commands/         # CLI command implementations
-├── config/           # Configuration management
-│   ├── config.yaml   # Application configuration
-│   └── logger_config.py
-├── exceptions/       # Custom exception classes
-├── models/           # Data models and schemas
-│   └── config.py     # Settings and configuration models
-├── services/         # Business logic services
-├── utils/            # Core utilities
-└── main.py           # Application entry point
+   src/
+   ├── core/                 # Core module source code
+   │   ├── clients/          # HTTP clients and external integrations
+   │   ├── commands/         # CLI command implementations
+   │   ├── config/           # Configuration management
+   │   ├── core/             # Core functionality
+   │   ├── exceptions/       # Custom exception classes
+   │   ├── models/           # Data models and schemas
+   │   ├── services/         # Business logic services
+   │   ├── utils/            # Core utilities
+   │   └── main.py           # Application entry point
+   └── tests/        # Core module tests
 ```
 
 ## 🚀 Usage

src/core/pyproject.toml

@@ -24,8 +24,5 @@ core = "core.main:entrypoint"
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
-[tool.hatch.build.targets.wheel]
-packages = ["core"]
-
 [tool.uv.sources]
 utils = { workspace = true }

src/core/core/models/config.py → src/core/src/core/models/config.py

@@ -30,7 +30,7 @@ def __init__(self):
         path = Path(__file__).parent.parent
         config_path = path / "config" / "config.yaml"
 
-        load_dotenv(dotenv_path=path.parent / ".env")
+        load_dotenv(dotenv_path=path.parent.parent / ".env")
 
         if not config_path.exists():
             raise FileNotFoundError(f"Config file not found: {config_path}")