Distributed solution - new madengine CLI

.gitignore

@@ -6,6 +6,22 @@ __pycache__/
 # C extensions
 *.so
 
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
 # Distribution / packaging
 .Python
 build/
@@ -36,7 +52,7 @@ MANIFEST
 pip-log.txt
 pip-delete-this-directory.txt
 
-# Unit test / coverage reports
+# Testing and coverage
 htmlcov/
 .tox/
 .nox/
@@ -49,6 +65,23 @@ coverage.xml
 *.py,cover
 .hypothesis/
 .pytest_cache/
+
+# MADEngine specific
+credential.json
+data.json
+*.log
+*.csv
+*.html
+library_trace.csv
+library_perf.csv
+perf.csv
+perf.html
+
+# Temporary and build files
+temp/
+tmp/
+*.tmp
+.pytest_cache/
 cover/
 
 # Translations

.pre-commit-config.yaml

@@ -0,0 +1,36 @@
+# Pre-commit hooks configuration
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.4.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-json
+      - id: check-toml
+      - id: check-added-large-files
+      - id: check-merge-conflict
+      - id: debug-statements
+
+  - repo: https://github.com/psf/black
+    rev: 23.3.0
+    hooks:
+      - id: black
+        language_version: python3
+
+  - repo: https://github.com/pycqa/isort
+    rev: 5.12.0
+    hooks:
+      - id: isort
+
+  - repo: https://github.com/pycqa/flake8
+    rev: 6.0.0
+    hooks:
+      - id: flake8
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.3.0
+    hooks:
+      - id: mypy
+        additional_dependencies: [types-requests, types-PyYAML]
+        exclude: ^(tests/|scripts/)

CHANGELOG.md

@@ -0,0 +1,68 @@
+# Changelog
+
+All notable changes to MADEngine will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Comprehensive development tooling and configuration
+- Pre-commit hooks for code quality
+- Makefile for common development tasks
+- Developer guide with coding standards
+- Type checking with mypy
+- Code formatting with black and isort
+- Enhanced .gitignore for better file exclusions
+- CI/CD configuration templates
+- **Major Documentation Refactor**: Complete integration of distributed execution and CLI guides into README.md
+- Professional open-source project structure with badges and table of contents
+- Comprehensive MAD package integration documentation
+- Enhanced model discovery and tag system documentation
+- Modern deployment scenarios and configuration examples
+
+### Changed
+- Improved package initialization and imports
+- Replaced print statements with proper logging in main CLI
+- Enhanced error handling and logging throughout codebase
+- Cleaned up setup.py for better maintainability
+- Updated development dependencies in pyproject.toml
+- **Complete README.md overhaul**: Merged all documentation into a single, comprehensive source
+- Restructured documentation to emphasize MAD package integration
+- Enhanced CLI usage examples and distributed execution workflows
+- Improved developer contribution guidelines and legacy compatibility notes
+
+### Fixed
+- Removed Python cache files from repository
+- Fixed import organization and structure
+- Improved docstring formatting and consistency
+
+### Removed
+- Unnecessary debug print statements
+- Python cache files and build artifacts
+- **Legacy documentation files**: `docs/distributed-execution-solution.md` and `docs/madengine-cli-guide.md`
+- Redundant documentation scattered across multiple files
+
+## [Previous Versions]
+
+For changes in previous versions, please refer to the git history.
+
+---
+
+## Guidelines for Changelog Updates
+
+### Categories
+- **Added** for new features
+- **Changed** for changes in existing functionality
+- **Deprecated** for soon-to-be removed features
+- **Removed** for now removed features
+- **Fixed** for any bug fixes
+- **Security** for vulnerability fixes
+
+### Format
+- Keep entries brief but descriptive
+- Include ticket/issue numbers when applicable
+- Group related changes together
+- Use present tense ("Add feature" not "Added feature")
+- Target audience: users and developers of the project