docs(root): 📝 Update README with installation instructions, badges, and project overview

Co-Authored-By: Lilith Autocommit <noreply@atlilith.com>

README.md

@@ -7,18 +7,27 @@ AI-powered image generation platform with multi-service architecture.
 ```
 @imajin/
 ├── services/                    # ML Services (GPU-accelerated)
-│   ├── imajin-prompt/          # LLM prompt generation (Port 8003)
-│   ├── imajin-diffusion/       # SDXL/Diffusers (Port 8002)
-│   └── imajin-processing/      # CPU post-processing (Port 8004)
+│   ├── imajin-diffusion/       # SDXL/Diffusers image generation (Port 8002)
+│   ├── imajin-prompt/          # LLM prompt generation + classification (Port 8003)
+│   ├── imajin-processing/      # CPU post-processing (Port 8004)
+│   ├── imajin-semantic/        # SigLIP2 semantic validation (Port 8005)
+│   ├── imajin-aesthetic/       # ImageReward aesthetic scoring (Port 8006)
+│   ├── imajin-moderator/       # Multi-layer content moderation (Port 8008)
+│   ├── imajin-identity/        # Face detection & identity (Port 8009)
+│   ├── imajin-request-classifier/  # Cultural context classification
+│   └── imajin-prompt-generator/    # Lightweight prompt generation
 │
 ├── orchestrators/               # Composition Layer (no GPU)
-│   ├── imajin-pipeline/        # 7-stage pipeline (Port 8080)
-│   └── imajin-app/             # Main entry point (HTTP API, batch coordination)
+│   ├── imajin-pipeline/        # 16-stage self-contained pipeline (Port 8080)
+│   └── imajin-app/             # Service proxy orchestrator (HTTP API, batch)
 │
 ├── packages/                    # Published Libraries (@lilith/imajin-*)
+│   ├── imajin-app/             # Core configs, pipelines, prompts
 │   ├── imajin-react/           # React components
 │   ├── imajin-electron/        # Desktop integration
-│   └── imajin-client/          # Unified HTTP client
+│   ├── imajin-client/          # Unified HTTP client
+│   ├── imajin-config/          # Shared configuration
+│   └── imajin-moderator-client/  # Moderator client
 │
 ├── tests/                       # Integration tests
 ├── scripts/                     # Build & dev scripts
@@ -42,6 +51,32 @@ Services own ONE model type. Orchestrators compose services via HTTP.
 └──────────────────────────────────────────────────────────────────┘
 ```
 
+## Pipeline Layers
+
+```
+Consumer Request
+    │
+    ▼
+┌─────────────────────────┐
+│  Orchestration Layer     │  imajin-pipeline (16-stage) or imajin-app (proxy)
+└─────────┬───────────────┘
+          │
+    ┌─────┴────────────────────────────────────┐
+    │                                          │
+    ▼                                          ▼
+┌─────────────────┐  ┌────────────────┐  ┌─────────────────┐
+│  Classification  │  │  Generation    │  │  Post-Process   │
+│  imajin-prompt   │  │  imajin-       │  │  imajin-        │
+│  request-class.  │  │  diffusion     │  │  processing     │
+└─────────────────┘  └────────────────┘  └─────────────────┘
+    │                                          │
+    ▼                                          ▼
+┌─────────────────────────────────────────────────────────────┐
+│  Validation & Safety Layer                                   │
+│  imajin-moderator → imajin-semantic → imajin-aesthetic       │
+└─────────────────────────────────────────────────────────────┘
+```
+
 ## Quick Start
 
 ```bash
@@ -66,12 +101,18 @@ cd orchestrators/imajin-pipeline && uvicorn src.image_pipeline.api.main:app --po
 | `@lilith/imajin-react` | React UI components |
 | `@lilith/imajin-electron` | Desktop integration |
 | `@lilith/imajin-client` | Unified HTTP client |
+| `@lilith/imajin-config` | Shared configuration |
+| `@lilith/imajin-moderator-client` | Moderator service client |
 | `@lilith/imajin-prompt-types` | Prompt service types |
 | `@lilith/imajin-prompt-client` | Prompt service client |
 | `@lilith/imajin-diffusion-types` | Diffusion service types |
 | `@lilith/imajin-diffusion-client` | Diffusion service client |
 | `@lilith/imajin-processing-types` | Processing service types |
 | `@lilith/imajin-processing-client` | Processing service client |
+| `@lilith/imajin-semantic-types` | Semantic service types |
+| `@lilith/imajin-semantic-client` | Semantic service client |
+| `@lilith/imajin-aesthetic-types` | Aesthetic service types |
+| `@lilith/imajin-aesthetic-client` | Aesthetic service client |
 
 ## Python Packages
 
@@ -79,16 +120,23 @@ cd orchestrators/imajin-pipeline && uvicorn src.image_pipeline.api.main:app --po
 |---------|-------------|
 | `imajin-prompt-service` | LLM prompt generation (FastAPI) |
 | `imajin-diffusion-service` | SDXL image generation (FastAPI) |
-| `imajin-pipeline` | 7-stage orchestrator (FastAPI) |
+| `imajin-moderator` | Multi-layer content moderation (FastAPI) |
+| `imajin-semantic` | SigLIP2 semantic validation (FastAPI) |
+| `imajin-aesthetic` | ImageReward aesthetic scoring (FastAPI) |
+| `imajin-pipeline` | 16-stage orchestrator (FastAPI) |
 
 ## Port Assignments
 
-| Service | Port |
-|---------|------|
-| imajin-diffusion | 8002 |
-| imajin-prompt | 8003 |
-| imajin-processing | 8004 |
-| imajin-pipeline | 8080 |
+| Service | Port | Type |
+|---------|------|------|
+| imajin-diffusion | 8002 | Generation |
+| imajin-prompt | 8003 | Classification + Generation |
+| imajin-processing | 8004 | Post-processing |
+| imajin-semantic | 8005 | Validation |
+| imajin-aesthetic | 8006 | Validation |
+| imajin-moderator | 8008 | Safety |
+| imajin-identity | 8009 | Identity |
+| imajin-pipeline | 8080 | Orchestrator |
 
 ## License