updated docs

Author: RkSinghDeo

README.md

@@ -17,7 +17,7 @@
 
 | Command                | Description                                |
 |------------------------|--------------------------------------------|
-| `devolv validate file` | Validate AWS IAM policies (✅ live)        |
+| `devolv validate`      | Validate AWS IAM policies (✅ live)        |
 | `devolv scan`          | 🔜 Scan AWS accounts (coming soon)         |
 | `devolv generate`      | 🧠 Generate safe IAM policies (coming soon)|
 | `devolv etl`           | ⚙️ CI/CD IAM transformation (planned)      |

docs/index.md

@@ -6,9 +6,9 @@
 
 ## 🚀 Why Devolv?
 
-- Prevent security risks in IAM policies
-- Automate least-privilege generation
-- Enable continuous IAM validation in CI/CD
+- Prevent security risks in IAM policies  
+- Automate least-privilege generation  
+- Enable continuous IAM validation in CI/CD  
 - All via one CLI interface: `devolv`
 
 ---
@@ -23,12 +23,13 @@ pip install devolv
 
 ## 🔍 What Can It Do?
 
-| Command                | Description                                  |
-|------------------------|----------------------------------------------|
-| `devolv validate file` | Validate AWS IAM JSON/YAML files             |
-| `devolv scan`          | 🔜 Scan AWS accounts and misconfigurations   |
-| `devolv generate`      | 🧠 AI/Rule-based IAM policy generation        |
-| `devolv etl`           | 🔄 Transform/clean policies in pipelines     |
+| Command                  | Status   | Description                                        |
+|--------------------------|----------|----------------------------------------------------|
+| `devolv validate file`   | ✅ Ready | Validate a single AWS IAM JSON/YAML policy file    |
+| `devolv validate folder` | ✅ Ready | Validate all policies inside a folder              |
+| `devolv scan`            | 🔜 WIP   | Scan AWS accounts for live misconfigurations       |
+| `devolv generate`        | 🔜 WIP   | AI/Rule-based IAM policy generation                |
+| `devolv etl`             | 🔜 WIP   | Transform/clean policies for IAM pipelines         |
 
 ---
 
@@ -37,4 +38,3 @@ pip install devolv
 - [Validator CLI](./validator.md)
 - [Roadmap](./roadmap.md)
 - [GitHub Repo](https://github.com/devolvdev/devolv)
-

docs/validator.md

@@ -1,20 +1,20 @@
-# `devolv validate file`
+# `devolv validate`
 
-This is the first released module of Devolv.
+This is the **first released module** of **Devolv** — the Modular DevOps CLI Toolkit.
 
 ---
 
 ## 🛡 Purpose
 
-Statically validate AWS IAM policy files for:
+Statically validate AWS IAM policy files to detect:
 
-- ✅ Wildcards in Action or Resource
-- 🔐 `iam:PassRole` misuse
-- 🚨 Common escalation risks
+- ✅ Wildcards in Action (`*`, `s3:*`)  
+- 🔐 `iam:PassRole` with wildcard resources  
+- 🚨 Common privilege escalation risks
 
 ---
 
-## 📂 Supported Input
+## 📂 Supported Input Formats
 
 - `.json`
 - `.yaml` / `.yml`
@@ -23,14 +23,26 @@ Statically validate AWS IAM policy files for:
 
 ## 🔧 Usage
 
+### 🔹 Validate a Single File
+
 ```bash
 devolv validate file path/to/policy.json
 ```
 
+### 🔹 Validate a Folder
+
+```bash
+devolv validate folder path/to/folder/
+```
+
+> Scans all `.json`, `.yaml`, and `.yml` files in the folder recursively.
+
 ---
 
 ## 📋 Example
 
+### Input File: `policy.json`
+
 ```json
 {
   "Version": "2012-10-17",
@@ -44,17 +56,19 @@ devolv validate file path/to/policy.json
 }
 ```
 
-Output:
+### Output
 
 ```
 ❌ HIGH: Policy uses wildcard in Action, which is overly permissive.
+❌ HIGH: iam:PassRole with wildcard resource can lead to privilege escalation.
 ```
 
 ---
 
 ## ✅ Exit Codes
 
-- `0`: All checks passed
-- `1`: Risk found in policy
-- `2`: File or format error
-
+| Code | Meaning                     |
+|------|-----------------------------|
+| `0`  | All checks passed           |
+| `1`  | Risk found in policy        |
+| `2`  | File/folder not found or invalid format |