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

src/Framework/Discovery/Analysis/DependencyAnalysisResult.php

@@ -0,0 +1,80 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Discovery\Analysis;
+
+use App\Framework\Discovery\ValueObjects\DependencyGraph;
+
+final readonly class DependencyAnalysisResult
+{
+    /**
+     * @param array<array<string>> $circularDependencies
+     * @param array<string, mixed> $statistics
+     */
+    public function __construct(
+        private DependencyGraph $graph,
+        private array $circularDependencies,
+        private array $statistics
+    ) {}
+
+    /**
+     * Get the dependency graph
+     */
+    public function getGraph(): DependencyGraph
+    {
+        return $this->graph;
+    }
+
+    /**
+     * Get circular dependencies
+     *
+     * @return array<array<string>>
+     */
+    public function getCircularDependencies(): array
+    {
+        return $this->circularDependencies;
+    }
+
+    /**
+     * Get analysis statistics
+     *
+     * @return array<string, mixed>
+     */
+    public function getStatistics(): array
+    {
+        return $this->statistics;
+    }
+
+    /**
+     * Check if there are any circular dependencies
+     */
+    public function hasCircularDependencies(): bool
+    {
+        return !empty($this->circularDependencies);
+    }
+
+    /**
+     * Get the number of circular dependency cycles
+     */
+    public function getCircularDependencyCount(): int
+    {
+        return count($this->circularDependencies);
+    }
+
+    /**
+     * Convert to array for serialization
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return [
+            'statistics' => $this->statistics,
+            'circular_dependencies' => $this->circularDependencies,
+            'has_circular_dependencies' => $this->hasCircularDependencies(),
+            'circular_dependency_count' => $this->getCircularDependencyCount(),
+            'graph' => $this->graph->toArray(),
+        ];
+    }
+}