docs: update README.md and add MIT license

Author: vooradis

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Samrat Vooradi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,133 @@
+# ☁️ Cloud Storage Lens
+
+**Multi-cloud audit toolkit to scan AWS, Azure, and GCP storage services for public exposure and cost visibility.**  
+Supports secure scanning, mockfill lifecycle, containerized CLI, and cross-cloud infrastructure provisioning.
+
+![Multi-cloud badge](https://img.shields.io/badge/clouds-AWS%20%7C%20Azure%20%7C%20GCP-blue)
+![CI](https://github.com/vooradis/cloud-storage-lens/actions/workflows/audit-pipeline.yaml/badge.svg)
+
+---
+
+## 🔍 Overview
+
+Cloud Storage Lens analyzes cloud buckets, containers, and blobs for:
+
+- **Public access flags**
+- **Mock data visibility**
+- **Cost estimation based on volume**
+- **CI lifecycle automation**
+- **Secure infrastructure provisioning**
+
+---
+
+## 🚀 Quickstart
+
+```bash
+git clone https://github.com/vooradis/cloud-storage-lens.git
+cd cloud-storage-lens
+
+# Install dependencies
+pip install -r requirements.txt
+
+# Fill buckets with mock data
+make mockfill
+
+# Run audit
+make scan
+
+# Clean up objects
+make cleanup
+```
+
+---
+
+## 🧰 CLI Commands
+
+Powered by `click` for modular subcommands:
+
+```bash
+python main.py audit --config config/config.dev.yaml
+python main.py fill
+python main.py clean
+```
+
+Supports AWS profile and Azure connection override:
+
+```bash
+python main.py fill --profile auditor --connection_string UseDevelopmentStorage=true
+```
+
+---
+
+## 🐳 Container Support
+
+```bash
+# Local dev container
+docker-compose up --build
+
+# Full audit lifecycle
+docker-compose run lens bash audit-entrypoint.sh
+```
+
+Includes `Dockerfile.dev`, `audit-entrypoint.sh`, and mounted `report.csv`, `audit.log`.
+
+---
+
+## ☁️ Infrastructure Provisioning
+
+Audit-ready resources defined in multi-cloud IaC:
+
+| Cloud | Tool      | Folder              | Resources                    |
+| ----- | --------- | ------------------- | ---------------------------- |
+| AWS   | CDK       | infra/aws-cdk       | S3 bucket + audit IAM        |
+| Azure | Bicep     | infra/azure-bicep   | Blob container (public)      |
+| GCP   | Terraform | infra/gcp-terraform | GCS bucket + lifecycle rules |
+
+---
+
+## 🧪 Testing & CI
+
+```bash
+make test       # Run unit tests
+flake8 .        # Lint audit + tools
+```
+
+GitHub Actions runs:
+
+- `pytest tests`
+- `flake8 lint`
+- Docker builds
+- Full audit lifecycle
+- Uploads `report.csv` as artifact
+
+---
+
+## 📂 Project Structure
+
+```plaintext
+auditor/       → access check, cost, report logic
+clients/       → SDK wrappers for AWS, Azure, GCP
+tools/         → mockfill + cleanup scripts
+infra/         → CDK, Bicep, Terraform templates
+scripts/       → shell wrappers for scan lifecycle
+tests/         → pytest mocks for all providers
+config/        → YAML audit config presets
+```
+
+---
+
+## 📸 Screenshots
+
+| Cloud | Preview |
+| ----- | ------- |
+| AWS   |         |
+| Azure |         |
+| GCP   |         |
+
+(Insert screenshots in `docs/images/` or embed links)
+
+---
+
+## 📜 License
+
+MIT — built for learning, enterprise demos, and open-source contributions.