From e2cbb390f632e748337ae306e83a03d8ebd5c0ed Mon Sep 17 00:00:00 2001
From: Sebastian Krupinski <krupinski01@gmail.com>
Date: Tue, 3 Mar 2026 21:54:09 -0500
Subject: [PATCH] fix: comments

Signed-off-by: Sebastian Krupinski <krupinski01@gmail.com>
---
 lib/Controllers/DefaultController.php | 14 --------------
 lib/Manager.php                       | 14 +++++++-------
 2 files changed, 7 insertions(+), 21 deletions(-)

diff --git a/lib/Controllers/DefaultController.php b/lib/Controllers/DefaultController.php
index 9dcfda9..08d93dc 100644
--- a/lib/Controllers/DefaultController.php
+++ b/lib/Controllers/DefaultController.php
@@ -45,19 +45,6 @@ class DefaultController extends ControllerAbstract {
 		private readonly LoggerInterface $logger,
 	) {}
 
-	/**
-     * Main API endpoint for mail operations
-     * 
-     * Single operation:
-     *   {
-     *     "version": 1,
-     *     "transaction": "tx-1",
-     *     "operation": "entity.create",
-     *     "data": {...}
-     *   }
-     * 
-     * @return JsonResponse
-     */
 	#[AuthenticatedRoute('/v1', name: 'chrono.manager.v1', methods: ['POST'])]
     public function index(
         int $version,
@@ -184,7 +171,6 @@ class DefaultController extends ControllerAbstract {
 
     }
 
-
     // ==================== Service Operations =====================
 
     private function serviceList(string $tenantId, string $userId, array $data): mixed {
diff --git a/lib/Manager.php b/lib/Manager.php
index 82e8a82..e5ae138 100644
--- a/lib/Manager.php
+++ b/lib/Manager.php
@@ -587,21 +587,21 @@ class Manager {
         return $service->collectionDelete($collectionId, $force, $recursive);
     }
 
-    // ==================== Message Operations ====================
+    // ==================== Entity Operations ====================
 
     /**
-     * List messages in a collection
+     * List entities in a collection
      *
      * @since 2025.05.01
      *
      * @param string $tenantId Tenant identifier
      * @param string $userId User identifier
-     * @param SourceSelector $sources Message sources with collection identifiers
-     * @param array|null $filter Message filter
-     * @param array|null $sort Message sort
-     * @param array|null $range Message range/pagination
+     * @param SourceSelector $sources Entity sources with collection identifiers
+     * @param array|null $filter Entity filter
+     * @param array|null $sort Entity sort
+     * @param array|null $range Entity range/pagination
      *
-     * @return array<string, array<string|int, array<string|int, array<string|int, IMessageBase>>>> Messages grouped by provider/service/collection
+     * @return array<string, array<string|int, array<string|int, array<string|int, IEntityBase>>>> Entities grouped by provider/service/collection
      */
     public function entityList(string $tenantId, string $userId, SourceSelector $sources, array|null $filter = null, array|null $sort = null, array|null $range = null): array {
         // retrieve providers