@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/en/Python/commands/check-testing.md

@@ -0,0 +1,184 @@
+---
+description: Check Python Testing
+argument-hint: [arguments]
+---
+
+# Check Python Testing
+
+## Arguments
+
+$ARGUMENTS (optional: path to project to analyze)
+
+## MISSION
+
+Perform a complete audit of the Python project's testing strategy by verifying coverage, test quality, and best practices compliance defined in project rules.
+
+### Step 1: Structure and Test Organization
+
+Examine test organization:
+- [ ] `tests/` folder at project root
+- [ ] Mirror structure of source code (tests/domain, tests/application, etc.)
+- [ ] Test files named `test_*.py` or `*_test.py`
+- [ ] Pytest fixtures in `conftest.py`
+- [ ] Separation of unit / integration / e2e tests
+
+**Reference**: `rules/07-testing.md` section "Test Organization"
+
+### Step 2: Code Coverage
+
+Measure test coverage:
+- [ ] Overall coverage ≥ 80%
+- [ ] Domain Layer coverage ≥ 90%
+- [ ] Application Layer coverage ≥ 85%
+- [ ] Critical files at 100%
+- [ ] Coverage configuration in pyproject.toml
+
+**Command**: Run `docker run --rm -v $(pwd):/app python:3.11 sh -c "pip install pytest pytest-cov && pytest /app --cov=/app --cov-report=term-missing"`
+
+**Reference**: `rules/07-testing.md` section "Code Coverage"
+
+### Step 3: Unit Tests
+
+Analyze unit test quality:
+- [ ] Isolated tests (no external dependencies)
+- [ ] Use of mocks/stubs for dependencies
+- [ ] Fast tests (<100ms per test)
+- [ ] One test = One behavior
+- [ ] Descriptive naming: `test_should_X_when_Y`
+- [ ] AAA pattern (Arrange, Act, Assert)
+
+**Reference**: `rules/07-testing.md` section "Unit Tests"
+
+### Step 4: Integration Tests
+
+Verify integration tests:
+- [ ] Tests of interactions between components
+- [ ] Tests of Infrastructure layer (DB, API, etc.)
+- [ ] Use of test databases (fixtures)
+- [ ] Cleanup after each test (teardown)
+- [ ] Isolated and independent tests
+
+**Reference**: `rules/07-testing.md` section "Integration Tests"
+
+### Step 5: Assertions and Test Quality
+
+Check assertion quality:
+- [ ] Explicit and specific assertions
+- [ ] No multiple unrelated assertions
+- [ ] Clear error messages
+- [ ] Edge case tests
+- [ ] Error and exception tests
+- [ ] No disabled tests without reason (skip/xfail)
+
+**Reference**: `rules/07-testing.md` section "Assertions and Test Quality"
+
+### Step 6: Fixtures and Parameterization
+
+Evaluate pytest fixture usage:
+- [ ] Fixtures for common setup/teardown
+- [ ] Appropriate scope (function, class, module, session)
+- [ ] Parameterization with `@pytest.mark.parametrize`
+- [ ] Factories for complex test objects
+- [ ] No duplication in fixtures
+
+**Reference**: `rules/07-testing.md` section "Pytest Fixtures"
+
+### Step 7: Performance and Execution
+
+Analyze test performance:
+- [ ] Total execution time <30 seconds (unit tests)
+- [ ] Parallelizable tests (pytest-xdist)
+- [ ] No sleep() in tests
+- [ ] Pytest configuration in pyproject.toml
+- [ ] CI/CD with automatic test execution
+
+**Command**: Run `docker run --rm -v $(pwd):/app python:3.11 sh -c "pip install pytest && pytest /app -v --duration=10"`
+
+**Reference**: `rules/07-testing.md` section "Test Performance"
+
+### Step 8: Test-Driven Development (TDD)
+
+Verify TDD adoption:
+- [ ] Tests written before code (if applicable)
+- [ ] Red-Green-Refactor cycle
+- [ ] Tests guiding design
+- [ ] No untested code in production
+
+**Reference**: `rules/01-workflow-analysis.md` section "TDD Workflow"
+
+### Step 9: Calculate Score
+
+Point attribution (out of 25):
+- Code coverage: 7 points
+- Unit tests: 6 points
+- Integration tests: 4 points
+- Assertion quality: 3 points
+- Fixtures and organization: 3 points
+- Performance: 2 points
+
+## OUTPUT FORMAT
+
+```
+PYTHON TESTING AUDIT
+================================
+
+OVERALL SCORE: XX/25
+
+STRENGTHS:
+- [List of good testing practices observed]
+
+IMPROVEMENTS:
+- [List of minor improvements]
+
+CRITICAL ISSUES:
+- [List of critical testing gaps]
+
+DETAILS BY CATEGORY:
+
+1. COVERAGE (XX/7)
+   Status: [Coverage analysis]
+   Overall Coverage: XX%
+   Domain: XX%
+   Application: XX%
+   Infrastructure: XX%
+
+2. UNIT TESTS (XX/6)
+   Status: [Unit test quality]
+   Number of Tests: XX
+   Isolated Tests: XX%
+   Average Time: XXms
+
+3. INTEGRATION TESTS (XX/4)
+   Status: [Integration tests]
+   Number of Tests: XX
+   Infrastructure Coverage: XX%
+
+4. ASSERTIONS (XX/3)
+   Status: [Assertion quality]
+   Specific Assertions: XX%
+   Edge Case Tests: XX
+
+5. FIXTURES (XX/3)
+   Status: [Organization and fixtures]
+   Reusable Fixtures: XX
+   Parameterized Tests: XX
+
+6. PERFORMANCE (XX/2)
+   Status: [Test performance]
+   Total Time: XXs
+   Tests >1s: XX
+
+TOP 3 PRIORITY ACTIONS:
+1. [Most critical action to improve tests]
+2. [Second priority action]
+3. [Third priority action]
+```
+
+## NOTES
+
+- Run pytest with coverage to obtain metrics
+- Use Docker to abstract from local environment
+- Identify critical files without tests
+- Propose missing tests for key functionalities
+- Suggest concrete improvements for existing tests
+- Prioritize tests based on business risk

package/Dev/i18n/en/Python/commands/dependency-audit.md

@@ -0,0 +1,198 @@
+---
+description: Python Dependency Audit
+argument-hint: [arguments]
+---
+
+# Python Dependency Audit
+
+You are a Python security expert. You must audit project dependencies to identify vulnerabilities, obsolete packages, and license issues.
+
+## Arguments
+$ARGUMENTS
+
+Arguments:
+- (Optional) Focus: security, outdated, licenses, all
+
+Example: `/python:dependency-audit security` or `/python:dependency-audit all`
+
+## MISSION
+
+### Step 1: Identify Configuration
+
+```bash
+# Possible dependency files
+ls -la requirements*.txt pyproject.toml setup.py Pipfile poetry.lock
+
+# List installed dependencies
+pip list --format=json
+pip freeze
+```
+
+### Step 2: Security Audit
+
+```bash
+# Use pip-audit (recommended)
+pip install pip-audit
+pip-audit
+
+# Or safety (alternative)
+pip install safety
+safety check -r requirements.txt
+
+# Or with native pip (Python 3.12+)
+pip audit
+```
+
+### Step 3: Check for Updates
+
+```bash
+# Obsolete packages
+pip list --outdated --format=json
+
+# With pip-tools
+pip install pip-tools
+pip-compile --upgrade --dry-run
+
+# With poetry
+poetry show --outdated
+
+# With pipenv
+pipenv update --dry-run
+```
+
+### Step 4: License Audit
+
+```bash
+# Install pip-licenses
+pip install pip-licenses
+
+# List licenses
+pip-licenses --format=markdown
+
+# Filter problematic licenses
+pip-licenses --fail-on="GPL;AGPL"
+
+# JSON export
+pip-licenses --format=json --output-file=licenses.json
+```
+
+### Step 5: Transitive Dependency Analysis
+
+```bash
+# Dependency tree
+pip install pipdeptree
+pipdeptree
+
+# JSON format
+pipdeptree --json
+
+# Reverse dependencies (who uses what)
+pipdeptree --reverse --packages requests
+```
+
+### Step 6: Generate Report
+
+```
+══════════════════════════════════════════════════════════════
+📦 PYTHON DEPENDENCY AUDIT
+══════════════════════════════════════════════════════════════
+
+──────────────────────────────────────────────────────────────
+🔒 SECURITY VULNERABILITIES
+──────────────────────────────────────────────────────────────
+
+| Package | Version | CVE | Severity | Fixed In |
+|---------|---------|-----|----------|----------|
+| requests | 2.25.0 | CVE-2023-32681 | HIGH | 2.31.0 |
+| urllib3 | 1.26.5 | CVE-2023-45803 | MEDIUM | 1.26.18 |
+| pillow | 9.0.0 | CVE-2023-44271 | CRITICAL | 10.0.1 |
+
+⚠️ REQUIRED ACTIONS:
+1. `pip install requests>=2.31.0` (HIGH priority)
+2. `pip install urllib3>=1.26.18` (MEDIUM priority)
+3. `pip install pillow>=10.0.1` (CRITICAL priority)
+
+──────────────────────────────────────────────────────────────
+📈 OBSOLETE PACKAGES
+──────────────────────────────────────────────────────────────
+
+### MAJOR Updates (Possible breaking changes)
+| Package | Current | Latest | Changelog |
+|---------|---------|--------|-----------|
+| django | 3.2.23 | 5.0.1 | [Changelog](url) |
+| pydantic | 1.10.13 | 2.5.3 | [Migration](url) |
+
+### MINOR Updates (Recommended)
+| Package | Current | Latest |
+|---------|---------|--------|
+| fastapi | 0.104.0 | 0.109.0 |
+| sqlalchemy | 2.0.23 | 2.0.25 |
+
+### PATCH Updates (Security/Bugfix)
+| Package | Current | Latest |
+|---------|---------|--------|
+| httpx | 0.26.0 | 0.26.1 |
+
+──────────────────────────────────────────────────────────────
+📜 LICENSES
+──────────────────────────────────────────────────────────────
+
+### Summary
+| Type | Count | Packages |
+|------|-------|----------|
+| MIT | 45 | requests, fastapi, ... |
+| Apache-2.0 | 12 | google-cloud-*, ... |
+| BSD-3-Clause | 8 | numpy, pandas, ... |
+| GPL-3.0 | 2 | ⚠️ package-x, package-y |
+| UNKNOWN | 1 | ❓ private-package |
+
+### ⚠️ Detected Copyleft Licenses
+These licenses may have legal implications:
+
+| Package | License | Impact |
+|---------|---------|--------|
+| package-x | GPL-3.0 | Derived code must be GPL |
+| package-y | AGPL-3.0 | Even for SaaS |
+
+**Recommendation**: Verify compatibility with project license.
+
+──────────────────────────────────────────────────────────────
+📊 STATISTICS
+──────────────────────────────────────────────────────────────
+
+| Metric | Value |
+|--------|-------|
+| Total packages | 87 |
+| Direct | 23 |
+| Transitive | 64 |
+| Vulnerabilities | 3 |
+| Obsolete | 15 |
+| Licenses OK | 82 |
+| Licenses to verify | 5 |
+
+──────────────────────────────────────────────────────────────
+🔧 CORRECTION COMMANDS
+──────────────────────────────────────────────────────────────
+
+# Fix critical vulnerabilities
+pip install --upgrade requests>=2.31.0 urllib3>=1.26.18 pillow>=10.0.1
+
+# Update security patches
+pip install --upgrade httpx
+
+# Generate updated requirements.txt
+pip freeze > requirements.txt
+
+# Or with pip-tools
+pip-compile --upgrade requirements.in
+
+──────────────────────────────────────────────────────────────
+🎯 PRIORITIES
+──────────────────────────────────────────────────────────────
+
+1. [ ] CRITICAL: Fix pillow (CVE-2023-44271)
+2. [ ] HIGH: Fix requests (CVE-2023-32681)
+3. [ ] MEDIUM: Fix urllib3 (CVE-2023-45803)
+4. [ ] Verify GPL licenses (package-x, package-y)
+5. [ ] Plan pydantic v1 → v2 migration
+```

package/Dev/i18n/en/Python/commands/generate-endpoint.md

@@ -0,0 +1,90 @@
+---
+description: Generate FastAPI Endpoint
+argument-hint: [arguments]
+---
+
+# Generate FastAPI Endpoint
+
+You are a senior Python developer. You must generate a complete FastAPI endpoint with Pydantic validation, error handling, and tests.
+
+## Arguments
+$ARGUMENTS
+
+Arguments:
+- Resource name (e.g., `user`, `product`, `order`)
+- (Optional) Type (crud, list, detail, action)
+
+Example: `/python:generate-endpoint user crud`
+
+## MISSION
+
+### Step 1: Endpoint Structure
+
+```
+app/
+├── api/
+│   └── v1/
+│       └── endpoints/
+│           └── {resource}.py
+├── schemas/
+│   └── {resource}.py
+├── crud/
+│   └── {resource}.py
+├── models/
+│   └── {resource}.py
+└── tests/
+    └── api/
+        └── v1/
+            └── test_{resource}.py
+```
+
+### Step 2: SQLAlchemy Model
+
+[Create model template with UUID, timestamps, etc.]
+
+### Step 3: Pydantic Schemas
+
+[Create schemas: Base, Create, Update, InDB, Response, List]
+
+### Step 4: CRUD Operations
+
+[Create CRUD class with get, create, update, delete, pagination]
+
+### Step 5: FastAPI Endpoint
+
+[Create router with GET, POST, PATCH, DELETE endpoints]
+
+### Step 6: Tests
+
+[Create test class with all endpoint tests]
+
+### Step 7: Router Registration
+
+[Add router to main API file]
+
+### Summary
+
+```
+══════════════════════════════════════════════════════════════
+✅ ENDPOINT GENERATED - {resource}
+══════════════════════════════════════════════════════════════
+
+📁 Files Created:
+- app/models/{resource}.py
+- app/schemas/{resource}.py
+- app/crud/{resource}.py
+- app/api/v1/endpoints/{resource}.py
+- app/tests/api/v1/test_{resource}.py
+
+🔗 Available Endpoints:
+- GET    /api/v1/{resource}s/     - Paginated list
+- POST   /api/v1/{resource}s/     - Creation
+- GET    /api/v1/{resource}s/{id} - Detail
+- PATCH  /api/v1/{resource}s/{id} - Update
+- DELETE /api/v1/{resource}s/{id} - Deletion
+
+🔧 Next Steps:
+1. Add router to app/api/v1/api.py
+2. Create Alembic migration
+3. Run tests: pytest app/tests/api/v1/test_{resource}.py
+```

package/Dev/i18n/en/Python/commands/generate-model.md

@@ -0,0 +1,96 @@
+---
+description: Generate SQLAlchemy Model
+argument-hint: [arguments]
+---
+
+# Generate SQLAlchemy Model
+
+You are a senior Python developer. You must generate a complete SQLAlchemy model with relations, validations, and Alembic migration.
+
+## Arguments
+$ARGUMENTS
+
+Arguments:
+- Model name (e.g., `User`, `Product`, `Order`)
+- (Optional) Fields in format field:type (e.g., `name:str email:str:unique`)
+
+Example: `/python:generate-model Product name:str price:decimal category_id:uuid:fk`
+
+## MISSION
+
+### Step 1: Analyze Requirements
+
+Identify:
+- Model and table name
+- Fields and their types
+- Relations (ForeignKey, OneToMany, ManyToMany)
+- Indexes and constraints
+- Validations
+
+### Step 2: SQLAlchemy 2.0 Model
+
+[Create complete model with Mapped, relationships, constraints]
+
+### Step 3: Common Column Types
+
+[Reference for SQLAlchemy types: Integer, String, Text, DateTime, UUID, JSONB, etc.]
+
+### Step 4: Relations
+
+[Examples: OneToMany, ManyToMany with association table]
+
+### Step 5: Alembic Migration
+
+[Create migration file with upgrade/downgrade functions]
+
+### Step 6: Commands
+
+```bash
+# Generate migration automatically
+alembic revision --autogenerate -m "Create {model}s table"
+
+# Verify migration
+alembic upgrade --sql head
+
+# Apply migration
+alembic upgrade head
+
+# Rollback if necessary
+alembic downgrade -1
+```
+
+### Summary
+
+```
+══════════════════════════════════════════════════════════════
+✅ MODEL GENERATED - {Model}
+══════════════════════════════════════════════════════════════
+
+📁 Files Created:
+- app/models/{model}.py
+
+📊 Table Structure:
+| Column | Type | Constraints |
+|--------|------|-------------|
+| id | UUID | PK |
+| name | VARCHAR(255) | NOT NULL, INDEX |
+| slug | VARCHAR(255) | UNIQUE, INDEX |
+| description | TEXT | NULLABLE |
+| price | NUMERIC(10,2) | DEFAULT 0.00, CHECK >= 0 |
+| quantity | INTEGER | DEFAULT 0 |
+| is_active | BOOLEAN | DEFAULT true, INDEX |
+| category_id | UUID | FK -> categories.id |
+| created_at | DATETIME | DEFAULT now() |
+| updated_at | DATETIME | DEFAULT now(), ON UPDATE |
+
+🔗 Relations:
+- category: ManyToOne -> Category
+- order_items: OneToMany -> OrderItem
+
+🔧 Commands:
+# Generate migration
+alembic revision --autogenerate -m "Create {model}s table"
+
+# Apply
+alembic upgrade head
+```

package/Dev/i18n/en/Python/commands/type-coverage.md

@@ -0,0 +1,119 @@
+---
+description: Check Python Type Coverage
+argument-hint: [arguments]
+---
+
+# Check Python Type Coverage
+
+You are a Python expert. You must verify type annotation coverage in the project and identify untyped functions/methods.
+
+## Arguments
+$ARGUMENTS
+
+Arguments:
+- (Optional) Path to specific module
+- (Optional) Minimum coverage threshold (e.g., `80`)
+
+Example: `/python:type-coverage app/` or `/python:type-coverage app/api/ 90`
+
+## MISSION
+
+### Step 1: MyPy Configuration
+
+[Show mypy configuration in pyproject.toml]
+
+### Step 2: Launch Analysis
+
+```bash
+# Standard MyPy
+mypy app/
+
+# With coverage report
+mypy app/ --txt-report type-coverage/
+
+# HTML report
+mypy app/ --html-report type-coverage-html/
+
+# Progressive strict mode
+mypy app/ --strict --warn-return-any
+```
+
+### Step 3: Coverage Analysis Script
+
+[Python script to analyze type coverage using AST]
+
+### Step 4: Typing Patterns
+
+[Show patterns: TypeAlias, Generics, Protocols, Callable, Overload, etc.]
+
+### Step 5: Generate Report
+
+```
+══════════════════════════════════════════════════════════════
+📊 TYPE COVERAGE REPORT
+══════════════════════════════════════════════════════════════
+
+──────────────────────────────────────────────────────────────
+📈 GLOBAL SUMMARY
+──────────────────────────────────────────────────────────────
+
+| Metric | Value | Threshold | Status |
+|--------|-------|-----------|--------|
+| Global Coverage | 78.5% | 80% | ⚠️ |
+| Total Functions | 245 | - | - |
+| Fully Typed | 192 | - | - |
+| Partially Typed | 38 | - | - |
+| Untyped | 15 | - | - |
+
+──────────────────────────────────────────────────────────────
+📁 COVERAGE BY MODULE
+──────────────────────────────────────────────────────────────
+
+| Module | Functions | Typed | Coverage |
+|--------|-----------|-------|----------|
+| app/api/ | 45 | 45 | 100% ✅ |
+| app/core/ | 32 | 30 | 93.8% ✅ |
+| app/services/ | 58 | 52 | 89.7% ✅ |
+| app/crud/ | 40 | 35 | 87.5% ✅ |
+| app/models/ | 28 | 20 | 71.4% ⚠️ |
+| app/utils/ | 42 | 10 | 23.8% ❌ |
+
+──────────────────────────────────────────────────────────────
+❌ UNTYPED FUNCTIONS
+──────────────────────────────────────────────────────────────
+
+### app/utils/helpers.py
+
+| Line | Function | Missing |
+|------|----------|---------|
+| 15 | `parse_date` | return type |
+| 28 | `format_currency` | param: amount, return |
+| 45 | `slugify` | return type |
+| 67 | `calculate_hash` | param: data |
+
+──────────────────────────────────────────────────────────────
+🔧 SUGGESTED CORRECTIONS
+──────────────────────────────────────────────────────────────
+
+### app/utils/helpers.py:15
+
+```python
+# Before
+def parse_date(date_str):
+    ...
+
+# After
+def parse_date(date_str: str) -> datetime | None:
+    ...
+```
+
+──────────────────────────────────────────────────────────────
+🎯 PRIORITIES
+──────────────────────────────────────────────────────────────
+
+1. [ ] Type app/utils/ (23.8% → 80%+)
+2. [ ] Complete app/models/ (71.4% → 90%+)
+3. [ ] Fix 23 mypy errors
+4. [ ] Add mypy plugin for SQLAlchemy
+5. [ ] Configure pre-commit hook mypy
+```