docs: add CONTRIBUTING.md, issue templates and PR template

Author: Fahl-Design

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,32 @@
+---
+name: 🐛 Bug Report
+about: Create a report to help us improve
+title: 'bug: '
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Configure module in `acceptance.suite.yml` with ...
+2. Run test with `$I->...`
+3. See error ...
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots/Logs**
+If applicable, add screenshots or terminal output to help explain your problem.
+
+**Environment (please complete the following information):**
+ - OS: [e.g. Ubuntu 22.04]
+ - PHP Version: [e.g. 8.3.1]
+ - Codeception Version: [e.g. 5.1.0]
+ - Mock Server Version: [e.g. 1.2.0]
+
+**Additional context**
+Add any other context about the problem here (e.g., specific OpenAPI spec features used).

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: ✨ Feature Request
+about: Suggest an idea for this project
+title: 'feat: '
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,23 @@
+## Summary
+A clear and concise description of the changes in this PR.
+
+## Related Issue(s)
+Fixes #[issue-number]
+Related to #[issue-number]
+
+## Type of Change
+Please delete options that are not relevant.
+- [ ] 🐛 Bug fix (non-breaking change which fixes an issue)
+- [ ] ✨ New feature (non-breaking change which adds functionality)
+- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] 📚 Documentation update
+- [ ] 🛠️ Refactor / internal improvement
+
+## Checklist:
+- [ ] My code follows the code style of this project (`composer cs:check` passes).
+- [ ] I have performed a self-review of my own code.
+- [ ] I have commented my code, particularly in hard-to-understand areas.
+- [ ] I have made corresponding changes to the documentation.
+- [ ] My changes generate no new warnings in PHPStan (`composer stan` passes).
+- [ ] I have added tests that prove my fix is effective or that my feature works (`composer test` passes).
+- [ ] New and existing unit tests pass locally with my changes.

CONTRIBUTING.md

@@ -0,0 +1,60 @@
+# Contributing to Codeception Module for PHP OpenAPI Mock Server
+
+First off, thank you for considering contributing to this project! It's people like you who make the open-source community such an amazing place to learn, inspire, and create.
+
+## 🛠️ Development Setup
+
+To get started with development, you'll need to have PHP 8.3+ and Composer installed on your machine.
+
+1.  **Fork the repository** on GitHub.
+2.  **Clone your fork** locally:
+    ```bash
+    git clone https://github.com/your-username/codeception-module-openapi-server-mock.git
+    cd codeception-module-openapi-server-mock
+    ```
+3.  **Install dependencies**:
+    ```bash
+    composer install
+    ```
+4.  **Initialize GrumPHP**:
+    GrumPHP is used to run quality checks on every commit. It should be initialized automatically, but you can run:
+    ```bash
+    vendor/bin/grumphp git:init
+    ```
+
+## 🧪 Running Tests
+
+We use Codeception for our own internal testing. To run the tests, use:
+
+```bash
+composer test
+```
+
+This will run the acceptance tests which verify that the module correctly starts the mock server and interacts with it.
+
+## 🔍 Quality Tools
+
+We maintain high code quality standards. Before submitting a PR, ensure your code passes all checks:
+
+- **Static Analysis**: `composer stan` (runs PHPStan at Level 8)
+- **Coding Standard**: `composer cs:check` (verifies PSR-12/Symfony style)
+- **Fixing Style**: `composer cs:fix` (automatically fixes most style issues)
+
+## 📝 Pull Request Process
+
+1.  **Create a new branch** for your feature or bugfix:
+    ```bash
+    git checkout -b feat/my-new-feature
+    ```
+2.  **Commit your changes**. GrumPHP will automatically run linting and tests. If any check fails, the commit will be blocked until fixed.
+3.  **Ensure your commit messages follow conventional commits** (e.g., `feat: ...`, `fix: ...`).
+4.  **Push to your fork** and **submit a Pull Request** to the `main` branch of the original repository.
+5.  **Describe your changes** in detail in the PR description. Link any related issues.
+
+## ⚖️ Code of Conduct
+
+By participating in this project, you agree to abide by our Code of Conduct (based on the Contributor Covenant). Please be respectful and professional in all interactions.
+
+## 📜 License
+
+By contributing, you agree that your contributions will be licensed under the project's [MIT License](LICENSE).

GEMINI.md

@@ -0,0 +1,66 @@
+# Codeception Module for PHP OpenAPI Mock Server - Project Context
+
+This directory contains a Codeception module designed to provide easy access to and control over the [PHP OpenAPI Mock Server](https://github.com/WebProject-xyz/php-openapi-mock-server).
+
+## Project Overview
+
+*   **Type:** PHP Library / Codeception Module
+*   **Purpose:** Orchestrate a standalone OpenAPI mock server during automated tests and provide high-level actions for test scenarios.
+*   **Key Technologies:**
+    *   **Language:** PHP 8.3+ (PSR-12, Symfony, and Risky rulesets)
+    *   **Testing:** Codeception 5.x
+    *   **Process Management:** Symfony Process
+    *   **CI/CD:** GitHub Actions (configured in `.github/workflows/ci.yml`)
+    *   **Automation:** GrumPHP (commit hooks), PHP-CS-Fixer, PHPStan (Level 8)
+
+## Architecture
+
+The module `WebProject\Codeception\Module\OpenApiServerMock` acts as a **Helper Module**.
+- **Lifecycle Management:** It starts a PHP built-in server running the `openapi-mock-server` binary before the suite and stops it after.
+- **Auto-Detection:** It attempts to locate the mock server automatically via class reflection or directory traversal.
+- **Dynamic Control:** It communicates with the mock server via custom HTTP headers (`X-OpenApi-Mock-Active`, `X-OpenApi-Mock-StatusCode`, `X-OpenApi-Mock-Example`) to manipulate mock responses on the fly.
+- **Dependencies:** Designed to be used alongside `REST` and `PhpBrowser` modules.
+
+## Building and Running
+
+### Prerequisites
+*   PHP 8.3 or higher.
+*   Composer.
+
+### Setup
+```bash
+composer install
+vendor/bin/codecept build  # Generate Tester actions
+```
+
+### Testing
+```bash
+composer test               # Run all tests
+vendor/bin/codecept run Acceptance  # Run acceptance tests specifically
+```
+
+### Static Analysis and Linting
+```bash
+composer stan               # Run PHPStan (Level 8)
+composer cs:check           # Check coding standards
+composer cs:fix             # Fix coding standards
+```
+
+## Development Conventions
+
+*   **Namespaces:**
+    *   Source: `WebProject\Codeception\Module\`
+    *   Tests: `WebProject\Codeception\Module\Tests\`
+*   **Coding Standard:** Strict adherence to PSR-12 and Symfony coding styles via PHP-CS-Fixer.
+*   **Strict Typing:** `declare(strict_types=1);` is required in all PHP files.
+*   **Type Safety:** PHPStan Level 8 is enforced. Avoid `mixed` where possible; use specific iterable types in PHPDoc.
+*   **Commit Hooks:** GrumPHP runs `php-cs-fixer`, `phpstan`, and `codeception` on every commit.
+
+## Key Files
+
+*   `src/OpenApiServerMock.php`: The main module logic.
+*   `tests/Acceptance/MockServerCest.php`: Main acceptance tests for the module.
+*   `codeception.yml`: Global Codeception configuration.
+*   `phpstan.neon`: PHPStan configuration (Level 8).
+*   `.php-cs-fixer.php`: Coding style rules.
+*   `grumphp.yml`: Automation task definitions.