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/Console/Analytics/Migrations/CreateCommandUsageAnalyticsTable.php

@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Framework\Console\Analytics\Migrations;
+
+use App\Framework\Database\ConnectionInterface;
+use App\Framework\Database\Migration\Migration;
+use App\Framework\Database\Migration\MigrationVersion;
+
+final readonly class CreateCommandUsageAnalyticsTable implements Migration
+{
+    public function up(ConnectionInterface $connection): void
+    {
+        $sql = "CREATE TABLE IF NOT EXISTS command_usage_analytics (
+            id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
+            command_name VARCHAR(255) NOT NULL,
+            executed_at DATETIME NOT NULL,
+            execution_time_ms DECIMAL(10, 3) NOT NULL,
+            exit_code TINYINT NOT NULL DEFAULT 0,
+            argument_count INT NOT NULL DEFAULT 0,
+            user_id VARCHAR(255) NULL,
+            metadata JSON NULL,
+            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+            updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+            INDEX idx_command_name (command_name),
+            INDEX idx_executed_at (executed_at),
+            INDEX idx_user_id (user_id),
+            INDEX idx_command_executed (command_name, executed_at),
+            INDEX idx_command_exit (command_name, exit_code),
+            INDEX idx_executed_exit (executed_at, exit_code)
+        ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci";
+
+        $connection->execute($sql);
+    }
+
+    public function down(ConnectionInterface $connection): void
+    {
+        $connection->execute("DROP TABLE IF EXISTS command_usage_analytics");
+    }
+
+    public function getVersion(): MigrationVersion
+    {
+        return MigrationVersion::fromTimestamp('2024_01_01_000001');
+    }
+
+    public function getDescription(): string
+    {
+        return 'Create command_usage_analytics table for console command metrics';
+    }
+}