docs: update for new fuzzer types

Author: dogancanbakir

README.md

@@ -50,12 +50,12 @@ pip install pirebok[guided]
 ```
 
 ## Features
-- Random generic fuzzer w/ multiple transformers
-- Random sql fuzzer w/ multiple transformers
-- Guided random sql fuzzer w/ iterative evolutionary search and [metamaska](https://github.com/HappyHackingSpace/metamaska)
+- **4 attack types**: SQL injection, XSS, command injection, path traversal
+- Random and guided (evolutionary) fuzzers for each attack type
+- Guided fuzzers use [metamaska](https://github.com/HappyHackingSpace/metamaska) classifier to iteratively mutate payloads until they evade detection
   - Priority-queue-based payload pool ranked by confidence
   - Configurable `max_rounds`, `round_size`, and `timeout`
-- Random comment injection transformer (`/**/` at token boundaries)
+- 17 type-specific transformers + 6 generic transformers
 
 ## Credits
 - [Cookiecutter](https://github.com/audreyr/cookiecutter)

docs/usage.md

@@ -25,21 +25,49 @@ fuzzer = (
 fuzzer.fuzz("admin' OR 1=1#")
 ```
 
+### XSS fuzzing
+
+```python
+from pirebok.fuzzers import FuzzerBuilder
+fuzzer = FuzzerBuilder().choice("RandomXssFuzzer").build()
+fuzzer.fuzz("<script>alert(1)</script>")
+```
+
+### Command injection fuzzing
+
+```python
+from pirebok.fuzzers import FuzzerBuilder
+fuzzer = FuzzerBuilder().choice("RandomCmdiFuzzer").build()
+fuzzer.fuzz("; cat /etc/passwd")
+```
+
+### Path traversal fuzzing
+
+```python
+from pirebok.fuzzers import FuzzerBuilder
+fuzzer = FuzzerBuilder().choice("RandomPathTraversalFuzzer").build()
+fuzzer.fuzz("../../etc/passwd")
+```
+
 To use from CLI
 
 ```
 pirebok --help
 Usage: pirebok [OPTIONS]
 
 Options:
-  -f, --fuzzer [randomgenericfuzzer|guidedrandomsqlfuzzer|randomsqlfuzzer]
+  -f, --fuzzer [guidedrandomcmdifuzzer|randomcmdifuzzer|randomgenericfuzzer|
+                guidedrandompathtraversalfuzzer|randompathtraversalfuzzer|
+                guidedrandomsqlfuzzer|randomsqlfuzzer|
+                guidedrandomxssfuzzer|randomxssfuzzer]
                                   choose fuzzer  [required]
   -s, --steps INTEGER             Number of iteration  [default: 10]
   -t, --threshold FLOAT           Threshold for the guided fuzzers  [default: 0.5]
   --max-rounds INTEGER            Maximum mutation rounds for guided fuzzers  [default: 100]
   --round-size INTEGER            Mutations per round for guided fuzzers  [default: 20]
   --timeout INTEGER               Timeout in seconds, 0=unlimited  [default: 0]
   -p, --payload TEXT              Payload to fuzz  [required]
+  -q, --silent                    Suppress banner
   --help                          Show this message and exit.
 ```