From 5671c8b4d62a073fcc2a1af47d083ce1cd756d41 Mon Sep 17 00:00:00 2001
From: Emanuel Almeida <ealmeida@descomplicar.pt>
Date: Wed, 28 Oct 2026 16:02:32 +0000
Subject: [PATCH] =?UTF-8?q?style(cabecalhos):=20adiciona=20cabe=C3=A7alho?=
 =?UTF-8?q?=20Descomplicar=C2=AE=20ao=20c=C3=B3digo-fonte,=20templates,=20?=
 =?UTF-8?q?testes=20e=20scripts=20PHP/JS?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 assets/js/admin.js                                  | 8 ++++++++
 phpstan-bootstrap.php                               | 9 +++++++++
 run-tests.php                                       | 9 +++++++++
 src/Admin/AjaxHandler.php                           | 9 +++++++++
 src/Cache/CacheInvalidator.php                      | 9 +++++++++
 src/Cache/CacheManager.php                          | 9 +++++++++
 src/Config/PerformanceConfig.php                    | 9 +++++++++
 src/Database/ConnectionManager.php                  | 9 +++++++++
 src/Database/HealthCheck.php                        | 9 +++++++++
 src/Database/Migration.php                          | 9 +++++++++
 src/Database/QueryBuilder.php                       | 9 +++++++++
 src/Database/Schema.php                             | 9 +++++++++
 src/Integrations/KiviCare/HookManager.php           | 9 +++++++++
 src/Models/Restriction.php                          | 9 +++++++++
 src/Models/RestrictionType.php                      | 9 +++++++++
 src/Monitoring/PerformanceTracker.php               | 9 +++++++++
 src/Performance/MemoryManager.php                   | 9 +++++++++
 src/Performance/QueryOptimizer.php                  | 9 +++++++++
 src/Performance/ResponseOptimizer.php               | 9 +++++++++
 src/Repositories/RestrictionRepository.php          | 9 +++++++++
 src/Repositories/RestrictionRepositoryInterface.php | 9 +++++++++
 src/Security/CapabilityChecker.php                  | 9 +++++++++
 src/Security/InputSanitizer.php                     | 9 +++++++++
 src/Security/NonceManager.php                       | 9 +++++++++
 src/Security/RateLimiter.php                        | 9 +++++++++
 src/Security/SecurityIntegration.php                | 9 +++++++++
 src/Security/SecurityLogger.php                     | 9 +++++++++
 src/Security/SecurityValidationResult.php           | 9 +++++++++
 src/Security/SecurityValidator.php                  | 9 +++++++++
 src/Security/ValidationLayerResult.php              | 9 +++++++++
 src/Services/CssInjectionService.php                | 9 +++++++++
 templates/admin/bulk-operations.php                 | 9 +++++++++
 templates/admin/dashboard.php                       | 9 +++++++++
 templates/admin/main-interface.php                  | 9 +++++++++
 templates/admin/restrictions.php                    | 9 +++++++++
 templates/admin/settings-page.php                   | 9 +++++++++
 templates/agent-file-template.md                    | 8 ++++++++
 templates/plan-template.md                          | 8 ++++++++
 templates/spec-template.md                          | 8 ++++++++
 templates/tasks-template.md                         | 8 ++++++++
 tests/Integration/KiviCareIntegrationTest.php       | 9 +++++++++
 tests/Integration/WordPressHooksTest.php            | 9 +++++++++
 tests/Mocks/DatabaseMock.php                        | 9 +++++++++
 tests/Mocks/KiviCareMock.php                        | 9 +++++++++
 tests/Mocks/WordPressMock.php                       | 9 +++++++++
 tests/Performance/DatabasePerformanceTest.php       | 9 +++++++++
 tests/Unit/Cache/CacheManagerTest.php               | 9 +++++++++
 tests/Unit/Models/RestrictionTest.php               | 9 +++++++++
 tests/Unit/Models/RestrictionTypeTest.php           | 9 +++++++++
 tests/Unit/Security/SecurityValidatorTest.php       | 9 +++++++++
 tests/Utils/TestHelper.php                          | 9 +++++++++
 tests/bootstrap.php                                 | 9 +++++++++
 tests/performance/PerformanceBenchmarkTest.php      | 9 +++++++++
 53 files changed, 472 insertions(+)

diff --git a/assets/js/admin.js b/assets/js/admin.js
index df04768..415891d 100644
--- a/assets/js/admin.js
+++ b/assets/js/admin.js
@@ -1,3 +1,11 @@
+/**
+ * admin.js
+ *
+ * @author Descomplicar® Crescimento Digital
+ * @link https://descomplicar.pt
+ * @copyright 2025 Descomplicar®
+ */
+
 /**
  * Care Book Ultimate - Admin Interface JavaScript
  *
diff --git a/phpstan-bootstrap.php b/phpstan-bootstrap.php
index b9165fa..848926c 100644
--- a/phpstan-bootstrap.php
+++ b/phpstan-bootstrap.php
@@ -1,3 +1,12 @@
+/**
+ * phpstan-bootstrap.php
+ *
+ * @package    care-book-block-ultimate.phpstan-bootstrap.php
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * PHPStan Bootstrap File - WordPress Functions
diff --git a/run-tests.php b/run-tests.php
index cfbebda..f76f1ab 100644
--- a/run-tests.php
+++ b/run-tests.php
@@ -1,3 +1,12 @@
+/**
+ * run-tests.php
+ *
+ * @package    care-book-block-ultimate.run-tests.php
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Simple Test Runner for Care Book Block Ultimate
diff --git a/src/Admin/AjaxHandler.php b/src/Admin/AjaxHandler.php
index 614a6d1..d49ab72 100644
--- a/src/Admin/AjaxHandler.php
+++ b/src/Admin/AjaxHandler.php
@@ -1,3 +1,12 @@
+/**
+ * AjaxHandler.php
+ *
+ * @package    care-book-block-ultimate.src.Admin
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * AJAX Handler - Admin Interface AJAX Endpoints
diff --git a/src/Cache/CacheInvalidator.php b/src/Cache/CacheInvalidator.php
index ace229b..6ffe86e 100644
--- a/src/Cache/CacheInvalidator.php
+++ b/src/Cache/CacheInvalidator.php
@@ -1,3 +1,12 @@
+/**
+ * CacheInvalidator.php
+ *
+ * @package    care-book-block-ultimate.src.Cache
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Intelligent Cache Invalidation System
diff --git a/src/Cache/CacheManager.php b/src/Cache/CacheManager.php
index 851e88a..ec40cb5 100644
--- a/src/Cache/CacheManager.php
+++ b/src/Cache/CacheManager.php
@@ -1,3 +1,12 @@
+/**
+ * CacheManager.php
+ *
+ * @package    care-book-block-ultimate.src.Cache
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Cache Manager - Advanced WordPress Transients System
diff --git a/src/Config/PerformanceConfig.php b/src/Config/PerformanceConfig.php
index 7b193ab..4a16b8a 100644
--- a/src/Config/PerformanceConfig.php
+++ b/src/Config/PerformanceConfig.php
@@ -1,3 +1,12 @@
+/**
+ * PerformanceConfig.php
+ *
+ * @package    care-book-block-ultimate.src.Config
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Performance Configuration Manager
diff --git a/src/Database/ConnectionManager.php b/src/Database/ConnectionManager.php
index ba3abf1..bb8e2af 100644
--- a/src/Database/ConnectionManager.php
+++ b/src/Database/ConnectionManager.php
@@ -1,3 +1,12 @@
+/**
+ * ConnectionManager.php
+ *
+ * @package    care-book-block-ultimate.src.Database
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Database Connection Manager
diff --git a/src/Database/HealthCheck.php b/src/Database/HealthCheck.php
index 9fe0f95..5b3bb9b 100644
--- a/src/Database/HealthCheck.php
+++ b/src/Database/HealthCheck.php
@@ -1,3 +1,12 @@
+/**
+ * HealthCheck.php
+ *
+ * @package    care-book-block-ultimate.src.Database
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Database Health Check and Monitoring System
diff --git a/src/Database/Migration.php b/src/Database/Migration.php
index 09adc1c..65db19a 100644
--- a/src/Database/Migration.php
+++ b/src/Database/Migration.php
@@ -1,3 +1,12 @@
+/**
+ * Migration.php
+ *
+ * @package    care-book-block-ultimate.src.Database
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Database Migration System
diff --git a/src/Database/QueryBuilder.php b/src/Database/QueryBuilder.php
index 997beaf..ff66ca2 100644
--- a/src/Database/QueryBuilder.php
+++ b/src/Database/QueryBuilder.php
@@ -1,3 +1,12 @@
+/**
+ * QueryBuilder.php
+ *
+ * @package    care-book-block-ultimate.src.Database
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Advanced Query Builder
diff --git a/src/Database/Schema.php b/src/Database/Schema.php
index 1477920..4c42a58 100644
--- a/src/Database/Schema.php
+++ b/src/Database/Schema.php
@@ -1,3 +1,12 @@
+/**
+ * Schema.php
+ *
+ * @package    care-book-block-ultimate.src.Database
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Database Schema Management System
diff --git a/src/Integrations/KiviCare/HookManager.php b/src/Integrations/KiviCare/HookManager.php
index 7ae602a..4e3a401 100644
--- a/src/Integrations/KiviCare/HookManager.php
+++ b/src/Integrations/KiviCare/HookManager.php
@@ -1,3 +1,12 @@
+/**
+ * HookManager.php
+ *
+ * @package    care-book-block-ultimate.src.Integrations
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * KiviCare Hook Manager - Integration System
diff --git a/src/Models/Restriction.php b/src/Models/Restriction.php
index 2cff6d9..a79e144 100644
--- a/src/Models/Restriction.php
+++ b/src/Models/Restriction.php
@@ -1,3 +1,12 @@
+/**
+ * Restriction.php
+ *
+ * @package    care-book-block-ultimate.src.Models
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Restriction Model
diff --git a/src/Models/RestrictionType.php b/src/Models/RestrictionType.php
index 1085717..667f6c2 100644
--- a/src/Models/RestrictionType.php
+++ b/src/Models/RestrictionType.php
@@ -1,3 +1,12 @@
+/**
+ * RestrictionType.php
+ *
+ * @package    care-book-block-ultimate.src.Models
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Restriction Type Enum
diff --git a/src/Monitoring/PerformanceTracker.php b/src/Monitoring/PerformanceTracker.php
index 7f546f4..2987621 100644
--- a/src/Monitoring/PerformanceTracker.php
+++ b/src/Monitoring/PerformanceTracker.php
@@ -1,3 +1,12 @@
+/**
+ * PerformanceTracker.php
+ *
+ * @package    care-book-block-ultimate.src.Monitoring
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Performance Monitoring and Tracking System
diff --git a/src/Performance/MemoryManager.php b/src/Performance/MemoryManager.php
index e7da613..19cf8b7 100644
--- a/src/Performance/MemoryManager.php
+++ b/src/Performance/MemoryManager.php
@@ -1,3 +1,12 @@
+/**
+ * MemoryManager.php
+ *
+ * @package    care-book-block-ultimate.src.Performance
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Memory Management System
diff --git a/src/Performance/QueryOptimizer.php b/src/Performance/QueryOptimizer.php
index 214e914..d3262ad 100644
--- a/src/Performance/QueryOptimizer.php
+++ b/src/Performance/QueryOptimizer.php
@@ -1,3 +1,12 @@
+/**
+ * QueryOptimizer.php
+ *
+ * @package    care-book-block-ultimate.src.Performance
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Database Query Optimizer
diff --git a/src/Performance/ResponseOptimizer.php b/src/Performance/ResponseOptimizer.php
index 37ed84f..eb4ad28 100644
--- a/src/Performance/ResponseOptimizer.php
+++ b/src/Performance/ResponseOptimizer.php
@@ -1,3 +1,12 @@
+/**
+ * ResponseOptimizer.php
+ *
+ * @package    care-book-block-ultimate.src.Performance
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * AJAX Response Optimizer
diff --git a/src/Repositories/RestrictionRepository.php b/src/Repositories/RestrictionRepository.php
index b46350f..875b77c 100644
--- a/src/Repositories/RestrictionRepository.php
+++ b/src/Repositories/RestrictionRepository.php
@@ -1,3 +1,12 @@
+/**
+ * RestrictionRepository.php
+ *
+ * @package    care-book-block-ultimate.src.Repositories
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Restriction Repository Implementation
diff --git a/src/Repositories/RestrictionRepositoryInterface.php b/src/Repositories/RestrictionRepositoryInterface.php
index 71e3c11..da36c6d 100644
--- a/src/Repositories/RestrictionRepositoryInterface.php
+++ b/src/Repositories/RestrictionRepositoryInterface.php
@@ -1,3 +1,12 @@
+/**
+ * RestrictionRepositoryInterface.php
+ *
+ * @package    care-book-block-ultimate.src.Repositories
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Restriction Repository Interface
diff --git a/src/Security/CapabilityChecker.php b/src/Security/CapabilityChecker.php
index e1c36bd..5cfdb9e 100644
--- a/src/Security/CapabilityChecker.php
+++ b/src/Security/CapabilityChecker.php
@@ -1,3 +1,12 @@
+/**
+ * CapabilityChecker.php
+ *
+ * @package    care-book-block-ultimate.src.Security
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Capability Checker - Role-based Access Control Layer
diff --git a/src/Security/InputSanitizer.php b/src/Security/InputSanitizer.php
index 380e112..028cf15 100644
--- a/src/Security/InputSanitizer.php
+++ b/src/Security/InputSanitizer.php
@@ -1,3 +1,12 @@
+/**
+ * InputSanitizer.php
+ *
+ * @package    care-book-block-ultimate.src.Security
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Input Sanitizer - Advanced Input Validation and Sanitization Layer
diff --git a/src/Security/NonceManager.php b/src/Security/NonceManager.php
index c472c82..ed4aefd 100644
--- a/src/Security/NonceManager.php
+++ b/src/Security/NonceManager.php
@@ -1,3 +1,12 @@
+/**
+ * NonceManager.php
+ *
+ * @package    care-book-block-ultimate.src.Security
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Nonce Manager - WordPress Nonce Validation Layer
diff --git a/src/Security/RateLimiter.php b/src/Security/RateLimiter.php
index 172a86e..dc19e14 100644
--- a/src/Security/RateLimiter.php
+++ b/src/Security/RateLimiter.php
@@ -1,3 +1,12 @@
+/**
+ * RateLimiter.php
+ *
+ * @package    care-book-block-ultimate.src.Security
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Rate Limiter - Advanced Request Rate Limiting Layer
diff --git a/src/Security/SecurityIntegration.php b/src/Security/SecurityIntegration.php
index 591dc91..b477dfd 100644
--- a/src/Security/SecurityIntegration.php
+++ b/src/Security/SecurityIntegration.php
@@ -1,3 +1,12 @@
+/**
+ * SecurityIntegration.php
+ *
+ * @package    care-book-block-ultimate.src.Security
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Security Integration - WordPress Plugin Security Integration
diff --git a/src/Security/SecurityLogger.php b/src/Security/SecurityLogger.php
index 070dae3..6efebb3 100644
--- a/src/Security/SecurityLogger.php
+++ b/src/Security/SecurityLogger.php
@@ -1,3 +1,12 @@
+/**
+ * SecurityLogger.php
+ *
+ * @package    care-book-block-ultimate.src.Security
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Security Logger - Comprehensive Security Event Logging & Monitoring
diff --git a/src/Security/SecurityValidationResult.php b/src/Security/SecurityValidationResult.php
index 926337a..c3dce61 100644
--- a/src/Security/SecurityValidationResult.php
+++ b/src/Security/SecurityValidationResult.php
@@ -1,3 +1,12 @@
+/**
+ * SecurityValidationResult.php
+ *
+ * @package    care-book-block-ultimate.src.Security
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Security Validation Result - Comprehensive Validation Result Container
diff --git a/src/Security/SecurityValidator.php b/src/Security/SecurityValidator.php
index fb7c510..e5e61f4 100644
--- a/src/Security/SecurityValidator.php
+++ b/src/Security/SecurityValidator.php
@@ -1,3 +1,12 @@
+/**
+ * SecurityValidator.php
+ *
+ * @package    care-book-block-ultimate.src.Security
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Master Security Validator - 7-Layer Enterprise Security System
diff --git a/src/Security/ValidationLayerResult.php b/src/Security/ValidationLayerResult.php
index 8f3b231..a528c07 100644
--- a/src/Security/ValidationLayerResult.php
+++ b/src/Security/ValidationLayerResult.php
@@ -1,3 +1,12 @@
+/**
+ * ValidationLayerResult.php
+ *
+ * @package    care-book-block-ultimate.src.Security
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Validation Layer Result - Individual Security Layer Result Container
diff --git a/src/Services/CssInjectionService.php b/src/Services/CssInjectionService.php
index a57214c..c3c7fb0 100644
--- a/src/Services/CssInjectionService.php
+++ b/src/Services/CssInjectionService.php
@@ -1,3 +1,12 @@
+/**
+ * CssInjectionService.php
+ *
+ * @package    care-book-block-ultimate.src.Services
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Optimized CSS Injection Service
diff --git a/templates/admin/bulk-operations.php b/templates/admin/bulk-operations.php
index 8a035f5..6af9d60 100644
--- a/templates/admin/bulk-operations.php
+++ b/templates/admin/bulk-operations.php
@@ -1,3 +1,12 @@
+/**
+ * bulk-operations.php
+ *
+ * @package    care-book-block-ultimate.templates.admin
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Bulk Operations Template - Care Book Ultimate
diff --git a/templates/admin/dashboard.php b/templates/admin/dashboard.php
index d9d3ce3..fe0f134 100644
--- a/templates/admin/dashboard.php
+++ b/templates/admin/dashboard.php
@@ -1,3 +1,12 @@
+/**
+ * dashboard.php
+ *
+ * @package    care-book-block-ultimate.templates.admin
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Admin Dashboard Template
diff --git a/templates/admin/main-interface.php b/templates/admin/main-interface.php
index 7042d31..a117cc8 100644
--- a/templates/admin/main-interface.php
+++ b/templates/admin/main-interface.php
@@ -1,3 +1,12 @@
+/**
+ * main-interface.php
+ *
+ * @package    care-book-block-ultimate.templates.admin
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Main Admin Interface Template - Care Book Ultimate
diff --git a/templates/admin/restrictions.php b/templates/admin/restrictions.php
index 0ec0a7e..c175755 100644
--- a/templates/admin/restrictions.php
+++ b/templates/admin/restrictions.php
@@ -1,3 +1,12 @@
+/**
+ * restrictions.php
+ *
+ * @package    care-book-block-ultimate.templates.admin
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Restrictions Management Template
diff --git a/templates/admin/settings-page.php b/templates/admin/settings-page.php
index 810e1bc..0973897 100644
--- a/templates/admin/settings-page.php
+++ b/templates/admin/settings-page.php
@@ -1,3 +1,12 @@
+/**
+ * settings-page.php
+ *
+ * @package    care-book-block-ultimate.templates.admin
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Settings Page Template - Care Book Ultimate
diff --git a/templates/agent-file-template.md b/templates/agent-file-template.md
index 2301e0e..2cedcf5 100644
--- a/templates/agent-file-template.md
+++ b/templates/agent-file-template.md
@@ -1,3 +1,11 @@
+---
+type: Template
+title: Agent File Template
+description: >-
+  Auto-generated from all feature plans. Last updated: [DATE]
+timestamp: 2025-09-10T05:58:33.277748+00:00
+layer: wiki
+---
 # [PROJECT NAME] Development Guidelines
 
 Auto-generated from all feature plans. Last updated: [DATE]
diff --git a/templates/plan-template.md b/templates/plan-template.md
index f28a655..c52828f 100644
--- a/templates/plan-template.md
+++ b/templates/plan-template.md
@@ -1,3 +1,11 @@
+---
+type: Template
+title: Plan Template
+description: >-
+  Branch: `[###-feature-name]` | Date: [DATE] | Spec: [link]
+timestamp: 2025-09-10T05:58:33.278294+00:00
+layer: wiki
+---
 # Implementation Plan: [FEATURE]
 
 **Branch**: `[###-feature-name]` | **Date**: [DATE] | **Spec**: [link]
diff --git a/templates/spec-template.md b/templates/spec-template.md
index 7915e7d..5e07ed7 100644
--- a/templates/spec-template.md
+++ b/templates/spec-template.md
@@ -1,3 +1,11 @@
+---
+type: Template
+title: Spec Template
+description: >-
+  Template de especificação de funcionalidade para o plugin Care Booking Block Ultimate.
+timestamp: 2025-09-10T05:58:33.278792+00:00
+layer: wiki
+---
 # Feature Specification: [FEATURE NAME]
 
 **Feature Branch**: `[###-feature-name]`  
diff --git a/templates/tasks-template.md b/templates/tasks-template.md
index b8a28fa..4502c12 100644
--- a/templates/tasks-template.md
+++ b/templates/tasks-template.md
@@ -1,3 +1,11 @@
+---
+type: Template
+title: Tasks Template
+description: >-
+  Input: Design documents from `/specs/[###-feature-name]/`
+timestamp: 2025-09-10T05:58:33.277369+00:00
+layer: wiki
+---
 # Tasks: [FEATURE NAME]
 
 **Input**: Design documents from `/specs/[###-feature-name]/`
diff --git a/tests/Integration/KiviCareIntegrationTest.php b/tests/Integration/KiviCareIntegrationTest.php
index 42f9b46..73acefc 100644
--- a/tests/Integration/KiviCareIntegrationTest.php
+++ b/tests/Integration/KiviCareIntegrationTest.php
@@ -1,3 +1,12 @@
+/**
+ * KiviCareIntegrationTest.php
+ *
+ * @package    care-book-block-ultimate.tests.Integration
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Tests for KiviCare Integration
diff --git a/tests/Integration/WordPressHooksTest.php b/tests/Integration/WordPressHooksTest.php
index a023ced..da04bd2 100644
--- a/tests/Integration/WordPressHooksTest.php
+++ b/tests/Integration/WordPressHooksTest.php
@@ -1,3 +1,12 @@
+/**
+ * WordPressHooksTest.php
+ *
+ * @package    care-book-block-ultimate.tests.Integration
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Tests for WordPress Hooks Integration
diff --git a/tests/Mocks/DatabaseMock.php b/tests/Mocks/DatabaseMock.php
index 6889102..3a81b62 100644
--- a/tests/Mocks/DatabaseMock.php
+++ b/tests/Mocks/DatabaseMock.php
@@ -1,3 +1,12 @@
+/**
+ * DatabaseMock.php
+ *
+ * @package    care-book-block-ultimate.tests.Mocks
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Database Mock for Testing
diff --git a/tests/Mocks/KiviCareMock.php b/tests/Mocks/KiviCareMock.php
index f5e0527..bf680c7 100644
--- a/tests/Mocks/KiviCareMock.php
+++ b/tests/Mocks/KiviCareMock.php
@@ -1,3 +1,12 @@
+/**
+ * KiviCareMock.php
+ *
+ * @package    care-book-block-ultimate.tests.Mocks
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * KiviCare Mock for Testing
diff --git a/tests/Mocks/WordPressMock.php b/tests/Mocks/WordPressMock.php
index bbb1ab5..7e77053 100644
--- a/tests/Mocks/WordPressMock.php
+++ b/tests/Mocks/WordPressMock.php
@@ -1,3 +1,12 @@
+/**
+ * WordPressMock.php
+ *
+ * @package    care-book-block-ultimate.tests.Mocks
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * WordPress Mock for Testing
diff --git a/tests/Performance/DatabasePerformanceTest.php b/tests/Performance/DatabasePerformanceTest.php
index b4d0850..b832538 100644
--- a/tests/Performance/DatabasePerformanceTest.php
+++ b/tests/Performance/DatabasePerformanceTest.php
@@ -1,3 +1,12 @@
+/**
+ * DatabasePerformanceTest.php
+ *
+ * @package    care-book-block-ultimate.tests.Performance
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Tests for Database Performance
diff --git a/tests/Unit/Cache/CacheManagerTest.php b/tests/Unit/Cache/CacheManagerTest.php
index 2d81724..fb558cb 100644
--- a/tests/Unit/Cache/CacheManagerTest.php
+++ b/tests/Unit/Cache/CacheManagerTest.php
@@ -1,3 +1,12 @@
+/**
+ * CacheManagerTest.php
+ *
+ * @package    care-book-block-ultimate.tests.Unit
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Tests for Cache Manager
diff --git a/tests/Unit/Models/RestrictionTest.php b/tests/Unit/Models/RestrictionTest.php
index 6fa5615..d8c642c 100644
--- a/tests/Unit/Models/RestrictionTest.php
+++ b/tests/Unit/Models/RestrictionTest.php
@@ -1,3 +1,12 @@
+/**
+ * RestrictionTest.php
+ *
+ * @package    care-book-block-ultimate.tests.Unit
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Tests for Restriction Model
diff --git a/tests/Unit/Models/RestrictionTypeTest.php b/tests/Unit/Models/RestrictionTypeTest.php
index 970e2bd..19dc8c3 100644
--- a/tests/Unit/Models/RestrictionTypeTest.php
+++ b/tests/Unit/Models/RestrictionTypeTest.php
@@ -1,3 +1,12 @@
+/**
+ * RestrictionTypeTest.php
+ *
+ * @package    care-book-block-ultimate.tests.Unit
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Tests for RestrictionType Enum
diff --git a/tests/Unit/Security/SecurityValidatorTest.php b/tests/Unit/Security/SecurityValidatorTest.php
index cfe89a3..f800ca9 100644
--- a/tests/Unit/Security/SecurityValidatorTest.php
+++ b/tests/Unit/Security/SecurityValidatorTest.php
@@ -1,3 +1,12 @@
+/**
+ * SecurityValidatorTest.php
+ *
+ * @package    care-book-block-ultimate.tests.Unit
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Security Validator Tests - Comprehensive Security Testing
diff --git a/tests/Utils/TestHelper.php b/tests/Utils/TestHelper.php
index 2a5247c..5a08335 100644
--- a/tests/Utils/TestHelper.php
+++ b/tests/Utils/TestHelper.php
@@ -1,3 +1,12 @@
+/**
+ * TestHelper.php
+ *
+ * @package    care-book-block-ultimate.tests.Utils
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Test Helper Utilities
diff --git a/tests/bootstrap.php b/tests/bootstrap.php
index 952ef8a..01d1089 100644
--- a/tests/bootstrap.php
+++ b/tests/bootstrap.php
@@ -1,3 +1,12 @@
+/**
+ * bootstrap.php
+ *
+ * @package    care-book-block-ultimate.tests.bootstrap.php
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * PHPUnit Bootstrap File
diff --git a/tests/performance/PerformanceBenchmarkTest.php b/tests/performance/PerformanceBenchmarkTest.php
index 9199388..80d52a4 100644
--- a/tests/performance/PerformanceBenchmarkTest.php
+++ b/tests/performance/PerformanceBenchmarkTest.php
@@ -1,3 +1,12 @@
+/**
+ * PerformanceBenchmarkTest.php
+ *
+ * @package    care-book-block-ultimate.tests.performance
+ * @author     Descomplicar® Crescimento Digital
+ * @link       https://descomplicar.pt
+ * @copyright  2025 Descomplicar® - Todos os direitos reservados
+ */
+
 <?php
 /**
  * Performance Benchmark Test Suite