chore(release): 4.0.2 - README restructure for clarity

Improvements:
- Engaging value proposition leading the page
- Clear individual → planet scale progression
- Prominent technical documentation links
- Fixed API examples
- Better organization and discoverability

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "4.0.1",
+  "version": "4.0.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@soulcraft/brainy",
-      "version": "4.0.1",
+      "version": "4.0.2",
       "license": "MIT",
       "dependencies": {
         "@aws-sdk/client-s3": "^3.540.0",