feat: add recursive namespace routing and standalone runner polish

- introduce namespace-aware routing with RootParseResult, RouteResult, and InvocationContext
- register submenus as FalyxNamespace entries and resolve them through _entry_map
- refactor FalyxParser to parse only root options and leave recursive routing to Falyx
- add prepare_route, resolve_route, and route dispatch flow to Falyx
- update validator and completer to understand namespace entries and route results
- unify help/TLDR rendering APIs and add custom_tldr support on Command
- tighten Command.resolve_args error handling and parser type validation
- improve CommandRunner dependency validation and argv handling
- add BottomBar.has_items and improve wrapped executor error messages
- add tests for execution options, resolve_args, command runner, and route-aware validation

tests/test_validators/test_command_validator.py

@@ -1,42 +1,49 @@
+from types import SimpleNamespace
 from unittest.mock import AsyncMock
 
 import pytest
 from prompt_toolkit.document import Document
 from prompt_toolkit.validation import ValidationError
 
+from falyx.routing import RouteKind
 from falyx.validators import CommandValidator
 
 
 @pytest.mark.asyncio
 async def test_command_validator_validates_command():
     fake_falyx = AsyncMock()
-    fake_falyx.get_command.return_value = (False, object(), (), {}, {})
+    fake_route = SimpleNamespace()
+    fake_route.is_preview = False
+    fake_route.kind = RouteKind.NAMESPACE_HELP
+    fake_falyx.prepare_route.return_value = (fake_route, (), {}, {})
     validator = CommandValidator(fake_falyx, "Invalid!")
 
     await validator.validate_async(Document("valid"))
-    fake_falyx.get_command.assert_awaited_once()
+    fake_falyx.prepare_route.assert_awaited_once()
 
 
 @pytest.mark.asyncio
 async def test_command_validator_rejects_invalid_command():
     fake_falyx = AsyncMock()
-    fake_falyx.get_command.return_value = (False, None, (), {}, {})
+    fake_falyx.prepare_route.return_value = (None, (), {}, {})
     validator = CommandValidator(fake_falyx, "Invalid!")
 
     with pytest.raises(ValidationError):
-        await validator.validate_async(Document("not_a_command"))
+        await validator.validate_async(Document(""))
 
     with pytest.raises(ValidationError):
-        await validator.validate_async(Document(""))
+        await validator.validate_async(Document("not_a_command"))
 
 
 @pytest.mark.asyncio
 async def test_command_validator_is_preview():
     fake_falyx = AsyncMock()
-    fake_falyx.get_command.return_value = (True, None, (), {}, {})
+    fake_route = SimpleNamespace()
+    fake_route.is_preview = True
+    fake_falyx.prepare_route.return_value = (fake_route, (), {}, {})
     validator = CommandValidator(fake_falyx, "Invalid!")
 
     await validator.validate_async(Document("?preview_command"))
-    fake_falyx.get_command.assert_awaited_once_with(
+    fake_falyx.prepare_route.assert_awaited_once_with(
         "?preview_command", from_validate=True
     )