Release v2.0.31: REQ-GIT-001 git hygiene, Code of Conduct, and CI docs.

Author: HecFranco

.cursor/rules/00-global.mdc

@@ -0,0 +1,15 @@
+---
+description: Global rules for Symfony bundle repository
+alwaysApply: true
+---
+
+Assume this repository is a reusable Symfony bundle.
+
+Prefer:
+- minimal, local changes
+- starting with files already open or explicitly mentioned
+- the smallest viable patch first
+- preserving backward compatibility unless explicitly requested otherwise
+
+Do not scan the whole repository unless explicitly required.
+Do not read vendor, cache, generated, build, coverage, lock, or binary files unless strictly needed for the task (for example dependency/release sync).

.cursor/rules/01-git-commits.mdc

@@ -0,0 +1,10 @@
+---
+description: Git commit message rules for this repository
+alwaysApply: true
+---
+
+When creating git commits in this repository:
+
+- NEVER add `Co-authored-by: Cursor` or any Cursor agent co-author trailer to commit messages.
+- NEVER add `Co-authored-by: cursoragent@cursor.com` or similar Cursor attribution lines.
+- Commit messages must list only human authors; tooling attribution belongs in PR descriptions or release notes, not in git trailers.

.cursor/rules/10-php-symfony-bundle.mdc

@@ -0,0 +1,28 @@
+---
+description: PHP and Symfony bundle rules
+globs:
+  - "src/**/*.php"
+  - "config/**/*.php"
+  - "config/**/*.yaml"
+  - "config/**/*.yml"
+alwaysApply: false
+---
+
+Target this bundle compatibility by default: PHP >=8.1 and Symfony 6/7/8.
+
+Prefer:
+- modern PHP with strict typing and explicit return types
+- PSR-12 coding style
+- final classes by default
+- readonly where appropriate
+- constructor injection
+- small focused services
+- framework conventions over custom abstractions
+- preserving public extension points
+- keeping DI extension, compiler pass wiring, and form type options backward compatible
+- PHPDoc in English for non-trivial classes, methods, and complex behavior
+
+Do not introduce BC breaks unless explicitly requested.
+Do not add PHPDoc in Spanish.
+Do not rename public services, configuration keys, or Twig integrations without warning.
+Do not touch unrelated namespaces or files.

.cursor/rules/20-twig-and-public-assets.mdc

@@ -0,0 +1,18 @@
+---
+description: Twig templates and public bundle assets
+globs:
+  - "templates/**/*.twig"
+  - "src/**/Resources/views/**/*.twig"
+  - "src/Resources/public/**/*"
+alwaysApply: false
+---
+
+Prefer:
+- small, backward-compatible template and public asset changes
+- preserving current block structure
+- local DOM updates
+- reusing existing classes, ids, and hooks
+- minimal asset changes
+
+Do not edit generated files inside src/Resources/public/build.
+Do not rewrite entire templates or public asset trees for a local change.

.cursor/rules/40-tests-quality.mdc

@@ -0,0 +1,26 @@
+---
+description: Tests and quality rules
+globs:
+  - "tests/**/*.php"
+  - "tests/**/*.ts"
+  - "tests/**/*.js"
+  - "src/Resources/assets/**/*.test.ts"
+  - "src/Resources/assets/**/*.spec.ts"
+  - "src/Resources/assets/**/*.test.js"
+  - "src/Resources/assets/**/*.spec.js"
+  - "phpunit.xml*"
+  - "vitest.config.*"
+  - "eslint.config.*"
+alwaysApply: false
+---
+
+When changing behavior, prefer adding or updating the nearest relevant test.
+
+Prefer:
+- one focused test
+- minimal fixture changes
+- preserving the existing testing style
+- test updates close to the changed behavior
+
+Do not introduce new testing frameworks unless explicitly requested.
+Do not rewrite unrelated tests.

.cursor/rules/50-docs-and-release.mdc

@@ -0,0 +1,17 @@
+---
+description: Documentation and release notes rules
+globs:
+  - "README.md"
+  - "docs/**/*.md"
+alwaysApply: false
+---
+
+Prefer:
+- documentation updates aligned with real code changes and current compatibility ranges
+- concise, actionable release notes
+- updating CHANGELOG and UPGRADING together for notable user-facing changes
+- preserving existing document structure and tone
+- keeping examples consistent with actual defaults and routes in this bundle
+
+Do not invent features, versions, or commands that are not present in the repository.
+Do not remove past release history unless explicitly requested.

.cursorignore

@@ -0,0 +1,56 @@
+# Dependencies
+/vendor/
+/node_modules/
+
+# Symfony runtime
+/var/
+
+# Build outputs
+/dist/
+/build/
+/coverage/
+/.vite/
+/.storybook-static/
+
+# Bundle public generated assets
+/src/Resources/public/build/
+
+# Caches / analysis
+/.php-cs-fixer.cache
+/.phpstan.cache
+/.psalm/
+.phpstan.result.cache
+/phpunit.xml.cache
+/.phpunit.cache/
+
+# Package manager locks
+pnpm-lock.yaml
+package-lock.json
+yarn.lock
+composer.lock
+
+# IDE / local
+/.idea/
+/.vscode/
+/.env
+/.env.*
+!.env.example
+
+# Heavy / binary / logs
+*.log
+*.sql
+*.sql.gz
+*.csv
+*.xlsx
+*.pdf
+*.zip
+*.tar
+*.gz
+*.mp4
+*.mov
+*.webm
+
+# Secrets
+*.pem
+*.key
+*.p12

.githooks/commit-msg

@@ -0,0 +1,13 @@
+#!/usr/bin/env sh
+# Strip Cursor agent co-author trailers from commit messages (REQ-GIT-001).
+set -eu
+
+MSG_FILE="${1:?commit message file required}"
+tmp="$(mktemp)"
+
+sed -e '/^Co-authored-by: Cursor <cursoragent@cursor.com>$/d' \
+    -e '/^Co-authored-by:.*cursoragent@cursor\.com/d' \
+    "$MSG_FILE" > "$tmp"
+
+mv "$tmp" "$MSG_FILE"
+exit 0

.githooks/pre-commit

@@ -8,6 +8,20 @@ on:
     branches: [main, master]
 
 jobs:
+  git-hygiene:
+    name: Git history (no Cursor co-author)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Check for Cursor co-author trailers (REQ-GIT-001)
+        run: |
+          chmod +x .scripts/check-no-cursor-coauthor.sh
+          ./.scripts/check-no-cursor-coauthor.sh HEAD
+
   test:
     name: PHP ${{ matrix.php }} - Symfony ${{ matrix.symfony }}
     runs-on: ubuntu-latest