Skip to content

Commit 29befc1

Browse files
HecFrancocursoragent
HecFranco
and
cursoragent
committed
Release v1.0.0: initial Console Debug Bundle
Production-safe browser console debugging with cdbg(), role-based gate, Twig integration, FrankenPHP demos, and full documentation. Co-authored-by: Cursor <cursoragent@cursor.com>
0 parents  commit 29befc1

1,606 files changed

Lines changed: 1312667 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.cursor/mcp.json‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"mcpServers": {
3+
"engram": {
4+
"command": "engram",
5+
"args": ["mcp"]
6+
}
7+
}
8+
}

‎.cursor/rules/00-global.mdc‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
description: Global rules for Symfony bundle repository
3+
alwaysApply: true
4+
---
5+
6+
Assume this repository is a reusable Symfony bundle.
7+
8+
Prefer:
9+
- minimal, local changes
10+
- starting with files already open or explicitly mentioned
11+
- the smallest viable patch first
12+
- preserving backward compatibility unless explicitly requested otherwise
13+
14+
Do not scan the whole repository unless explicitly required.
15+
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/10-php-symfony-bundle.mdc‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
---
2+
description: PHP and Symfony bundle rules
3+
globs:
4+
- "src/**/*.php"
5+
- "config/**/*.php"
6+
- "config/**/*.yaml"
7+
- "config/**/*.yml"
8+
alwaysApply: false
9+
---
10+
11+
Target this bundle compatibility by default: PHP >=8.1 (<8.6); mandatory Symfony minors 7.4, 8.0, and 8.1 (Symfony 8.x requires PHP 8.4+). Broader `^6.0 || ^7.0 || ^8.0` constraints remain in composer.json.
12+
13+
Prefer:
14+
- modern PHP with strict typing and explicit return types
15+
- PSR-12 coding style
16+
- final classes by default
17+
- readonly where appropriate
18+
- constructor injection
19+
- small focused services
20+
- framework conventions over custom abstractions
21+
- preserving public extension points
22+
- keeping DI extension, compiler pass wiring, and form type options backward compatible
23+
- PHPDoc in English for non-trivial classes, methods, and complex behavior
24+
25+
Do not introduce BC breaks unless explicitly requested.
26+
Do not add PHPDoc in Spanish.
27+
Do not rename public services, configuration keys, or Twig integrations without warning.
28+
Do not touch unrelated namespaces or files.

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

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
description: Twig templates and public bundle assets
3+
globs:
4+
- "templates/**/*.twig"
5+
- "src/**/Resources/views/**/*.twig"
6+
- "src/Resources/public/**/*"
7+
alwaysApply: false
8+
---
9+
10+
Prefer:
11+
- small, backward-compatible template and public asset changes
12+
- preserving current block structure
13+
- local DOM updates
14+
- reusing existing classes, ids, and hooks
15+
- minimal asset changes
16+
17+
Do not edit generated files inside src/Resources/public/build.
18+
Do not rewrite entire templates or public asset trees for a local change.

‎.cursor/rules/30-frontend-ts-vite-pentatrion.mdc‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
description: Frontend rules for bundle assets with TypeScript, Vite and Pentatrion
3+
globs:
4+
- "src/Resources/assets/**/*.ts"
5+
- "src/Resources/assets/**/*.tsx"
6+
- "src/Resources/assets/**/*.js"
7+
- "src/Resources/assets/**/*.jsx"
8+
- "src/Resources/assets/**/*.vue"
9+
- "src/Resources/assets/**/*.scss"
10+
- "src/Resources/assets/**/*.sass"
11+
- "src/Resources/assets/**/*.css"
12+
- "vite.config.ts"
13+
- "vite.config.js"
14+
alwaysApply: false
15+
---
16+
17+
Work only on the requested entrypoint, module, component, or stylesheet.
18+
19+
Prefer:
20+
- strict TypeScript typing
21+
- small modules and focused edits
22+
- preserving the current Vite entrypoint strategy
23+
- editing existing initialization code instead of creating parallel bootstraps
24+
- assuming assets live under src/Resources/assets
25+
- assuming generated files may end up under src/Resources/public/build
26+
- preserving integration points used by Twig or Symfony rendering
27+
- JSDoc in English for exported APIs, non-obvious functions, and complex behavior
28+
29+
Do not inspect dist, build, minified, or generated assets.
30+
Do not add JSDoc in Spanish.
31+
Do not edit generated build output.
32+
Do not rewrite the whole frontend architecture unless explicitly requested.

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

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
description: Tests and quality rules
3+
globs:
4+
- "tests/**/*.php"
5+
- "tests/**/*.ts"
6+
- "tests/**/*.js"
7+
- "src/Resources/assets/**/*.test.ts"
8+
- "src/Resources/assets/**/*.spec.ts"
9+
- "src/Resources/assets/**/*.test.js"
10+
- "src/Resources/assets/**/*.spec.js"
11+
- "phpunit.xml*"
12+
- "vitest.config.*"
13+
- "eslint.config.*"
14+
alwaysApply: false
15+
---
16+
17+
When changing behavior, prefer adding or updating the nearest relevant test.
18+
19+
Prefer:
20+
- one focused test
21+
- minimal fixture changes
22+
- preserving the existing testing style
23+
- test updates close to the changed behavior
24+
25+
Do not introduce new testing frameworks unless explicitly requested.
26+
Do not rewrite unrelated tests.

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

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
description: Documentation and release notes rules
3+
globs:
4+
- "README.md"
5+
- "docs/**/*.md"
6+
alwaysApply: false
7+
---
8+
9+
Prefer:
10+
- documentation updates aligned with real code changes and current compatibility ranges
11+
- concise, actionable release notes
12+
- updating CHANGELOG and UPGRADING together for notable user-facing changes
13+
- preserving existing document structure and tone
14+
- keeping examples consistent with actual defaults and routes in this bundle
15+
16+
Do not invent features, versions, or commands that are not present in the repository.
17+
Do not remove past release history unless explicitly requested.

0 commit comments

Comments
 (0)