feat(ralph): interactive UX layer pe Discord și Telegram (W1)

Adaugă straturile interactive peste slash commands flat:

**Discord (`src/adapters/discord_views.py`):**
- `RalphRootView` — listă proiecte workspace cu emoji status + Refresh + Close
- `RalphProjectView` — Propose / Vezi PRD / Aprobă tonight / Status / Stop / Înapoi
- `RalphProposeModal` — TextInput pentru descriere feature
- Critical pattern: `await interaction.response.defer(ephemeral=True)` în orice button
  callback cu I/O (eng review concern #2 — "Discord 3s timeout")
- `/p slug` autocomplete din `~/workspace/`
- `/l` afișează `RalphRootView` ephemeral

**Telegram (`src/adapters/telegram_bot.py`):**
- `cmd_ralph_l` (fără arg) trimite `InlineKeyboardMarkup` cu workspace + active
- `callback_ralph` cu pattern `^ralph:` rutează: project, menu, refresh, close,
  propose, prd, status, approve, stop
- Pentru "Propose feature" → set ralph_flow state cu step=input_description
  + `ForceReply()`; `handle_message` detectează state și rutează la `_ralph_propose`
- Pasează `adapter_name="telegram"` la `route_message`

**State management (`src/ralph_flow.py`):**
- Atomic JSON peste `sessions/ralph_flow.json` (pattern reusat din claude_session)
- Schema per (adapter, chat, user): `{step, project?, expires_at, ...}`
- TTL 10 min default; `cleanup_expired()` și auto-drop la `get_state` pe expirate

**Router (`src/router.py`):**
- `route_message` primește `adapter_name` keyword arg
- `_maybe_whatsapp_redirect` adaugă "💡 Pentru meniu interactiv folosește
  Discord sau Telegram" la mesajele de usage când adapter_name="whatsapp"
- WhatsApp `_handle_chat` pasează `adapter_name="whatsapp"`

**Tests:**
- `test_ralph_flow.py` — 10 teste (round-trip, isolation, expiry, atomic write)
- `test_router.py::TestRalphDispatch` — 3 teste (whatsapp redirect, discord
  no-redirect, usage message)

Foundation pentru W2 (planning agent — STEP_IN_PLANNING reservat).

Spike Step 0 PASS: skill subprocess + AskUserQuestion→text serialization
confirmat empiric (vezi tasks/spike-planning-findings.md).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-26 18:14:24 +00:00
parent 094c6be5a9
commit 86384b38e3
8 changed files with 821 additions and 11 deletions

View File

@@ -134,6 +134,31 @@ class TestStatusCommand:
assert is_cmd is True
# --- Ralph command dispatch ---
class TestRalphDispatch:
def test_p_without_args_returns_usage(self):
response, is_cmd = route_message("ch-1", "user-1", "/p")
assert "Folosire: /p" in response
assert is_cmd is True
def test_whatsapp_appends_redirect_hint_on_usage(self):
"""WhatsApp users see a redirect line pointing them to Discord/TG."""
response, is_cmd = route_message(
"ch-1", "user-1", "/p", adapter_name="whatsapp"
)
assert "Folosire: /p" in response
assert "Discord sau Telegram" in response
def test_discord_does_not_get_whatsapp_redirect(self):
response, is_cmd = route_message(
"ch-1", "user-1", "/p", adapter_name="discord"
)
assert "Folosire: /p" in response
assert "Discord sau Telegram" not in response
# --- Unknown command ---