Fix game command coherence - accept both game ID and launch target

[Copilot]

Fixes an issue where AI agents would get confused by games.list output and fail when trying to start games using Steam App IDs or other launch targets.

Problem

When AI agents call games.list, they see output like:

• **rimworld** (RimWorld) - stopped
  Launch: SteamAppId via 294100

The AI would then try games.start {"gameId": "294100"} using the prominent Steam App ID, which would fail with "Game '294100' not found". This created a poor user experience where the commands appeared incoherent - what you see in games.list doesn't work in games.start.

Solution

Made the game management commands more forgiving and the output clearer:

1. Forgiving Input Resolution

Added resolveGameId() helper that accepts both:

• Game ID: "rimworld" (configured ID)
• Launch target: "294100" (Steam App ID), "/path/to/game" (direct path), etc.

All game commands now use this resolution: games.start, games.stop, games.kill, games.status

2. Clearer Output Format

games.list now shows:

• **rimworld** - RimWorld (stopped)
  Use gameId: 'rimworld' (or target: '294100')
  Launch: SteamAppId

This makes it clear which identifiers can be used in commands.

3. Better Error Messages

Instead of "Game '294100' not found", now shows:
"Game '294100' not found. Use games.list to see available games."

Results

Before:

• games.start {"gameId": "294100"} → ❌ "Game '294100' not found"
• AI confusion due to inconsistent interface

After:

• games.start {"gameId": "294100"} → ✅ "Game 'rimworld' (RimWorld) started successfully"
• games.start {"gameId": "rimworld"} → ✅ Still works as before
• Clear, coherent interface that works as AI agents expect

Testing

Added comprehensive tests covering:

• Direct game ID resolution ("rimworld")
• Steam App ID resolution ("294100")
• Direct path resolution ("/opt/minecraft/start.sh")
• Invalid ID handling with helpful errors
• Backward compatibility verification

All existing functionality is preserved while fixing the coherence issue.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.