docs: consolidate documentation into organized structure

- Move 12 markdown files from root to docs/ subdirectories
- Organize documentation by category:
  • docs/troubleshooting/ (1 file)  - Technical troubleshooting guides
  • docs/deployment/      (4 files) - Deployment and security documentation
  • docs/guides/          (3 files) - Feature-specific guides
  • docs/planning/        (4 files) - Planning and improvement proposals

Root directory cleanup:
- Reduced from 16 to 4 markdown files in root
- Only essential project files remain:
  • CLAUDE.md (AI instructions)
  • README.md (Main project readme)
  • CLEANUP_PLAN.md (Current cleanup plan)
  • SRC_STRUCTURE_IMPROVEMENTS.md (Structure improvements)

This improves:
✅ Documentation discoverability
✅ Logical organization by purpose
✅ Clean root directory
✅ Better maintainability

tests/Framework/CommandBus/DefaultCommandBusTest.php

@@ -10,8 +10,13 @@ use App\Framework\CommandBus\ShouldQueue;
 use App\Framework\Context\ContextType;
 use App\Framework\Context\ExecutionContext;
 use App\Framework\DI\DefaultContainer;
+use App\Framework\Logging\ChannelLogger;
+use App\Framework\Logging\LogChannel;
 use App\Framework\Logging\Logger;
+use App\Framework\Logging\LogLevel;
+use App\Framework\Logging\ValueObjects\LogContext;
 use App\Framework\Queue\Queue;
+use App\Framework\Queue\ValueObjects\JobPayload;
 
 beforeEach(function () {
     $this->container = new DefaultContainer();
@@ -153,17 +158,39 @@ class TestQueue implements Queue
 
     private array $jobs = [];
 
-    public function push(object $job): void
+    public function push(JobPayload $payload): void
     {
         $this->used = true;
-        $this->jobs[] = $job;
+        $this->jobs[] = $payload;
     }
 
-    public function pop(): ?object
+    public function pop(): ?JobPayload
     {
         return array_shift($this->jobs);
     }
 
+    public function peek(): ?JobPayload
+    {
+        return $this->jobs[0] ?? null;
+    }
+
+    public function size(): int
+    {
+        return count($this->jobs);
+    }
+
+    public function clear(): int
+    {
+        $count = count($this->jobs);
+        $this->jobs = [];
+        return $count;
+    }
+
+    public function getStats(): array
+    {
+        return ['size' => count($this->jobs)];
+    }
+
     public function wasUsed(): bool
     {
         return $this->used;
@@ -172,35 +199,112 @@ class TestQueue implements Queue
 
 class TestLogger implements Logger
 {
-    public function emergency(string $message, array $context = []): void
+    private ?ChannelLogger $mockChannelLogger = null;
+
+    public function emergency(string $message, ?LogContext $context = null): void
     {
     }
 
-    public function alert(string $message, array $context = []): void
+    public function alert(string $message, ?LogContext $context = null): void
     {
     }
 
-    public function critical(string $message, array $context = []): void
+    public function critical(string $message, ?LogContext $context = null): void
     {
     }
 
-    public function error(string $message, array $context = []): void
+    public function error(string $message, ?LogContext $context = null): void
     {
     }
 
-    public function warning(string $message, array $context = []): void
+    public function warning(string $message, ?LogContext $context = null): void
     {
     }
 
-    public function notice(string $message, array $context = []): void
+    public function notice(string $message, ?LogContext $context = null): void
     {
     }
 
-    public function info(string $message, array $context = []): void
+    public function info(string $message, ?LogContext $context = null): void
     {
     }
 
-    public function debug(string $message, array $context = []): void
+    public function debug(string $message, ?LogContext $context = null): void
     {
     }
+
+    public function log(LogLevel $level, string $message, ?LogContext $context = null): void
+    {
+    }
+
+    public function logToChannel(LogChannel $channel, LogLevel $level, string $message, ?LogContext $context = null): void
+    {
+    }
+
+    public ChannelLogger $security {
+        get {
+            return $this->mockChannelLogger ??= $this->createMockChannelLogger();
+        }
+    }
+
+    public ChannelLogger $cache {
+        get {
+            return $this->mockChannelLogger ??= $this->createMockChannelLogger();
+        }
+    }
+
+    public ChannelLogger $database {
+        get {
+            return $this->mockChannelLogger ??= $this->createMockChannelLogger();
+        }
+    }
+
+    public ChannelLogger $framework {
+        get {
+            return $this->mockChannelLogger ??= $this->createMockChannelLogger();
+        }
+    }
+
+    public ChannelLogger $error {
+        get {
+            return $this->mockChannelLogger ??= $this->createMockChannelLogger();
+        }
+    }
+
+    private function createMockChannelLogger(): ChannelLogger
+    {
+        return new class () implements ChannelLogger {
+            public function emergency(string $message, ?LogContext $context = null): void
+            {
+            }
+
+            public function alert(string $message, ?LogContext $context = null): void
+            {
+            }
+
+            public function critical(string $message, ?LogContext $context = null): void
+            {
+            }
+
+            public function error(string $message, ?LogContext $context = null): void
+            {
+            }
+
+            public function warning(string $message, ?LogContext $context = null): void
+            {
+            }
+
+            public function notice(string $message, ?LogContext $context = null): void
+            {
+            }
+
+            public function info(string $message, ?LogContext $context = null): void
+            {
+            }
+
+            public function debug(string $message, ?LogContext $context = null): void
+            {
+            }
+        };
+    }
 }