Rewriting Project Claw Code - Python port with Rust on the way

src/commands.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import json
+from dataclasses import dataclass
 from functools import lru_cache
 from pathlib import Path
 
@@ -9,6 +10,15 @@ from .models import PortingBacklog, PortingModule
 SNAPSHOT_PATH = Path(__file__).resolve().parent / 'reference_data' / 'commands_snapshot.json'
 
 
+@dataclass(frozen=True)
+class CommandExecution:
+    name: str
+    source_hint: str
+    prompt: str
+    handled: bool
+    message: str
+
+
 @lru_cache(maxsize=1)
 def load_command_snapshot() -> tuple[PortingModule, ...]:
     raw_entries = json.loads(SNAPSHOT_PATH.read_text())
@@ -26,6 +36,11 @@ def load_command_snapshot() -> tuple[PortingModule, ...]:
 PORTED_COMMANDS = load_command_snapshot()
 
 
+@lru_cache(maxsize=1)
+def built_in_command_names() -> frozenset[str]:
+    return frozenset(module.name for module in PORTED_COMMANDS)
+
+
 def build_command_backlog() -> PortingBacklog:
     return PortingBacklog(title='Command surface', modules=list(PORTED_COMMANDS))
 
@@ -42,12 +57,29 @@ def get_command(name: str) -> PortingModule | None:
     return None
 
 
+def get_commands(cwd: str | None = None, include_plugin_commands: bool = True, include_skill_commands: bool = True) -> tuple[PortingModule, ...]:
+    commands = list(PORTED_COMMANDS)
+    if not include_plugin_commands:
+        commands = [module for module in commands if 'plugin' not in module.source_hint.lower()]
+    if not include_skill_commands:
+        commands = [module for module in commands if 'skills' not in module.source_hint.lower()]
+    return tuple(commands)
+
+
 def find_commands(query: str, limit: int = 20) -> list[PortingModule]:
     needle = query.lower()
     matches = [module for module in PORTED_COMMANDS if needle in module.name.lower() or needle in module.source_hint.lower()]
     return matches[:limit]
 
 
+def execute_command(name: str, prompt: str = '') -> CommandExecution:
+    module = get_command(name)
+    if module is None:
+        return CommandExecution(name=name, source_hint='', prompt=prompt, handled=False, message=f'Unknown mirrored command: {name}')
+    action = f"Mirrored command '{module.name}' from {module.source_hint} would handle prompt {prompt!r}."
+    return CommandExecution(name=module.name, source_hint=module.source_hint, prompt=prompt, handled=True, message=action)
+
+
 def render_command_index(limit: int = 20, query: str | None = None) -> str:
     modules = find_commands(query, limit) if query else list(PORTED_COMMANDS[:limit])
     lines = [f'Command entries: {len(PORTED_COMMANDS)}', '']