feat: Added PHP memory optimisation rule and indexed it in AGENTS.md

Author: ivangrynenko

.cursor/rules/confluence-editing-standards.mdc

@@ -0,0 +1,45 @@
+# Confluence Editing Standards (Markdown Authoring)
+
+Purpose: Ensure Markdown renders cleanly in Confluence by applying spacing, nesting, and code formatting rules during page creation/updates.
+
+## Lists & Spacing
+- Always insert a blank line between list items.
+
+- Use nested sub-bullets for subpoints; never concatenate multiple points on a single line.
+
+- For ordered lists, keep each step single-purpose; add an empty line between steps when a step has sub-bullets.
+
+## Inline vs Code Blocks
+- Prefer inline code for short, single-line commands or file paths (e.g., `composer install`).
+
+- Use fenced code blocks only when necessary (multi-line commands, config snippets). Verify Confluence renders the block without collapsing; otherwise, convert to inline steps.
+
+- Do not mix bullets and code blocks without a blank line before and after the block.
+
+## Headings & Anchors
+- Keep headings concise; avoid trailing punctuation.
+
+- When using Markdown format, avoid enabling heading anchors if they introduce ID artifacts in rendered output.
+
+## Tables
+- Keep tables simple (5–7 columns max). Prefer bullets when content wraps heavily.
+
+- Add a brief sentence above a large table explaining what it captures.
+
+## Nested Structure
+- Depth guidance: limit nesting to two levels (bullet → sub-bullet). If content requires more depth, split into a new subsection.
+
+## Check Before Publish (Quicklist)
+- Bullets have blank lines between items.
+
+- Sub-bullets are properly indented and grouped.
+
+- Commands are inline where possible; multi-line blocks tested for rendering.
+
+- No anchor artifacts in headings.
+
+- Tables are readable; consider bullets if wide.
+
+## Optional Page Label Cue
+When editing an existing Confluence page, if the page has label `format-spaced-lists`, apply these spacing rules strictly even if the original content is inconsistent.
+

.cursor/rules/php-memory-optimisation.mdc

@@ -0,0 +1,85 @@
+---
+description: PHP memory optimisation standards and actionable checks
+globs: *.php, *.ini
+---
+# PHP Memory Optimisation Standards
+
+Guidance and automated checks to reduce peak memory usage in PHP applications. Based on widely accepted practices and the article "PHP Memory Optimization Tips" by Khouloud Haddad.
+
+<rule>
+name: php_memory_optimisation
+description: Detect memory-heavy patterns and suggest streaming, generators, and better data handling
+filters:
+  - type: file_extension
+    pattern: "\\.php$"
+
+actions:
+  - type: enforce
+    conditions:
+      # Avoid loading entire DB result sets into memory.
+      - pattern: "->fetchAll\\("
+        message: "Avoid fetchAll() on large result sets; iterate with fetch() in a loop or wrap with a generator (yield)."
+
+      - pattern: "\\bmysqli_fetch_all\\("
+        message: "Avoid mysqli_fetch_all() for large queries; prefer streaming fetch (e.g., mysqli_fetch_assoc in a loop)."
+
+      # Avoid repeated full-file loads inside loops.
+      - pattern: "foreach\\s*\\([^)]*\\)\\s*\\{[^}]*file_get_contents\\("
+        message: "Avoid file_get_contents() inside loops; stream with SplFileObject or read once and reuse."
+
+      # Avoid array_merge in tight loops as it copies arrays.
+      - pattern: "foreach\\s*\\([^)]*\\)\\s*\\{[^}]*=\\s*array_merge\\("
+        message: "Avoid array_merge() inside loops; append elements directly or preallocate arrays."
+
+      # Use caution with range() on large ranges (allocates full array).
+      - pattern: "\\brange\\s*\\("
+        message: "range() allocates full arrays; for large ranges consider generators (yield) to avoid high memory."
+
+  - type: suggest
+    message: |
+      **PHP memory optimisation recommendations:**
+
+      - **Stream database results:** Prefer `$stmt->fetch(PDO::FETCH_ASSOC)` in a `while` loop or use generators instead of `fetchAll()`.
+      - **Use generators (yield):** Iterate large datasets without allocating full arrays.
+      - **Stream files:** Use `SplFileObject` or chunked reads instead of `file_get_contents()` for large files.
+      - **Minimise array copying:** Avoid `array_merge()` in loops; push items directly or pre-size with known capacity (e.g., `SplFixedArray`).
+      - **Free memory explicitly:** `unset($var)` after large data is no longer needed; consider `gc_collect_cycles()` for long-running scripts.
+      - **Profile memory:** Use `memory_get_usage()` and tools like Xdebug/Blackfire to spot peaks.
+      - **OPcache:** Ensure OPcache is enabled and sized appropriately in production.
+
+  - type: validate
+    conditions:
+      # Detect full-file reads that likely could be streamed.
+      - pattern: "\\bfile\\s*\\("
+        message: "file() reads entire files into memory; prefer SplFileObject for line-by-line streaming."
+
+metadata:
+  priority: high
+  version: 1.0
+</rule>
+
+<rule>
+name: php_ini_opcache_recommendations
+description: Recommend enabling OPcache for lower memory and better performance when editing php.ini
+filters:
+  - type: file_extension
+    pattern: "\\.ini$"
+
+actions:
+  - type: suggest
+    message: |
+      **OPcache recommendations (php.ini):**
+      - Set `opcache.enable=1` and `opcache.enable_cli=1` for CLI scripts that process large datasets.
+      - Size memory pool appropriately, e.g., `opcache.memory_consumption=128` (adjust to your project).
+      - Consider `opcache.interned_strings_buffer` and `opcache.max_accelerated_files` for larger codebases.
+
+  - type: enforce
+    conditions:
+      - pattern: "(?mi)^opcache\\.enable\\s*=\\s*0"
+        message: "Enable OPcache in production (set opcache.enable=1) to reduce memory and CPU overhead."
+
+metadata:
+  priority: medium
+  version: 1.0
+</rule>
+

AGENTS.md

@@ -32,6 +32,7 @@ Below are the rule bundles and their rule files. Each item links directly to the
 - [.cursor/rules/pull-request-changelist-instructions.mdc](.cursor/rules/pull-request-changelist-instructions.mdc)
 - [.cursor/rules/readme-maintenance-standards.mdc](.cursor/rules/readme-maintenance-standards.mdc)
 - [.cursor/rules/testing-guidelines.mdc](.cursor/rules/testing-guidelines.mdc)
+ - [.cursor/rules/confluence-editing-standards.mdc](.cursor/rules/confluence-editing-standards.mdc)
 
 ### Web Stack
 - [.cursor/rules/accessibility-standards.mdc](.cursor/rules/accessibility-standards.mdc)
@@ -63,6 +64,7 @@ Below are the rule bundles and their rule files. Each item links directly to the
 - [.cursor/rules/node-dependencies.mdc](.cursor/rules/node-dependencies.mdc)
 - [.cursor/rules/php-drupal-best-practices.mdc](.cursor/rules/php-drupal-best-practices.mdc)
 - [.cursor/rules/php-drupal-development-standards.mdc](.cursor/rules/php-drupal-development-standards.mdc)
+- [.cursor/rules/php-memory-optimisation.mdc](.cursor/rules/php-memory-optimisation.mdc)
 - [.cursor/rules/project-definition-template.mdc](.cursor/rules/project-definition-template.mdc)
 - [.cursor/rules/react-patterns.mdc](.cursor/rules/react-patterns.mdc)
 - [.cursor/rules/security-practices.mdc](.cursor/rules/security-practices.mdc)