chore: remove broken visual assets, fix mypy typing errors, and update README

Author: styxabhor

README.md

@@ -1,3 +1,4 @@
+
 # Project Lethe
 
 Project Lethe is a lightweight, dependency-free CLI for authorized WAF
@@ -44,6 +45,7 @@ python -m venv .venv
 source .venv/bin/activate
 pip install -e .
 ```
+*(On Windows natively, use `.\.venv\Scripts\activate` instead)*
 
 Confirm:
 
@@ -357,6 +359,10 @@ Bad places to use Lethe:
 
 See [SECURITY.md](SECURITY.md) for the full policy.
 
+## Kali Linux Usage
+
+For detailed instructions on using Lethe within Kali Linux, see [KALI_USAGE.md](KALI_USAGE.md).
+
 ## License
 
 MIT. See [LICENSE](LICENSE).

assets/lethe-cli-preview.svg

@@ -0,0 +1,40 @@
+Output assets/lethe-demo.gif
+
+Set FontSize 14
+Set FontFamily "Fira Code"
+Set Width 1200
+Set Height 750
+Set TypingSpeed 45ms
+Set Margin 20
+Set BorderRadius 10
+Set Theme "TokyoNight"
+
+# We hide the setup so the video starts directly at the Kali prompt
+Hide
+Type "zsh"
+Enter
+Sleep 1s
+Type "source .venv/bin/activate"
+Enter
+Type "clear"
+Enter
+Show
+
+Sleep 1s
+# Explicitly using --banner to trigger the cinematic Lethe animation!
+Type "lethe generate --payload '<waf-test>' --profile xss --limit 5 --banner"
+Sleep 500ms
+Enter
+
+# Give the animation time to fully cascade and render
+Sleep 8s
+
+Type "clear"
+Enter
+Sleep 500ms
+
+Type "lethe explain --payload '<waf-test>' --technique html_hex_entities"
+Sleep 500ms
+Enter
+
+Sleep 6s

assets/lethe-goddess.png

@@ -742,7 +742,7 @@ def handle_plan(args: argparse.Namespace, config: dict[str, object]) -> int:
 
 
 def handle_profile(args: argparse.Namespace, config: dict[str, object]) -> int:
-    output_format = args.format or _config_value(config, "profile_format", "format", default="table")
+    output_format = str(args.format or _config_value(config, "profile_format", "format", default="table"))
     timeout = args.timeout if args.timeout is not None else _config_float(
         config,
         "profile_timeout",
@@ -1147,7 +1147,7 @@ def _config_value(
 
 def _config_int(config: dict[str, object], name: str, *, default: int) -> int:
     value = config.get(name)
-    if value is None:
+    if not isinstance(value, (int, float, str)):
         return default
     try:
         return int(value)
@@ -1162,7 +1162,7 @@ def _config_bool(config: dict[str, object], name: str, *, default: bool) -> bool
 
 def _config_float(config: dict[str, object], name: str, *, default: float) -> float:
     value = config.get(name)
-    if value is None:
+    if not isinstance(value, (int, float, str)):
         return default
     try:
         return float(value)

demo.tape

@@ -117,7 +117,8 @@ def _strip_inline_comment(value: str) -> str:
 
 
 def _normalize_config(data: dict[str, Any]) -> dict[str, Any]:
-    source = data.get("lethe") if isinstance(data.get("lethe"), dict) else data
+    lethe_data = data.get("lethe")
+    source: dict[str, Any] = lethe_data if isinstance(lethe_data, dict) else data
     result = {
         key: value
         for key, value in source.items()