Function buddy_command_call

src/command_system/buddy_command.py:87–167

``/buddy`` command body. Parsing precedence (matches TS ``buddy.tsx:104-184``): 1. ``help`` / ``-h`` / ``--help`` → help text 2. ``status`` or any ``COMMON_INFO_ARGS`` entry (incl. ``?``) → status 3. ``mute`` / ``unmute`` → toggle + confirmation 4. any other non-empty arg → hel

(args: str, context: CommandContext)

def buddy_command_call(args: str, context: CommandContext) -> LocalCommandResult:
    """``/buddy`` command body.

    Parsing precedence (matches TS ``buddy.tsx:104-184``):

    1. ``help`` / ``-h`` / ``--help`` → help text
    2. ``status`` or any ``COMMON_INFO_ARGS`` entry (incl. ``?``) → status
    3. ``mute`` / ``unmute`` → toggle + confirmation
    4. any other non-empty arg → help text
    5. empty arg + no companion → hatch
    6. empty arg + companion exists → pet
    """
    arg = (args or '').strip().lower()

    # Note: TS routes '?' to INFO (status), NOT HELP — preserve that mapping.
    if arg in COMMON_HELP_ARGS:
        return LocalCommandResult(type='text', value=_HELP_TEXT)

    if arg in COMMON_INFO_ARGS:
        companion = get_companion()
        if companion is None:
            return LocalCommandResult(
                type='text',
                value='No buddy hatched yet. Run /buddy to hatch one.',
            )
        return LocalCommandResult(
            type='text',
            value=(
                f"{companion.name} is your {_title_case(companion.rarity)} "
                f"{companion.species}. {companion.personality}"
            ),
        )

    if arg in ('mute', 'unmute'):
        muted = arg == 'mute'
        _set_companion_muted(muted)
        return LocalCommandResult(
            type='text',
            value=f"Buddy {'muted' if muted else 'unmuted'}.",
        )

    if arg != '':
        return LocalCommandResult(type='text', value=_HELP_TEXT)

    # Empty arg: hatch (first time) or pet (subsequent).
    companion = get_companion()
    if companion is None:
        user_id = companion_user_id()
        stored = create_stored_companion(user_id)
        _save_companion(stored)
        # Re-read with fresh bones merged for the species-name line.
        companion = get_companion()
        if companion is None:
            # Defensive: should never happen — _save_companion succeeded.
            return LocalCommandResult(
                type='text', value='Failed to hatch companion (state error).',
            )
        return LocalCommandResult(