Get a hint for the current challenge in Learn Docker & K8s. Provides progressive hints (1=direction, 2=specific, 3=near-answer). Use when the user is stuck, asks for help, says "hint", "help me", "I'm stuck", or "I don't know what to do".
Read .player/progress.yaml to find the current chapter and challenge. Then read the corresponding challenge file from curriculum/chXX-*/challenges/XX-*.md.
Check what hint level was last given. If $ARGUMENTS specifies a level (1, 2, or 3), use that. Otherwise:
General direction without specifics. Points them toward the right concept. Example: "Think about how Docker containers find each other on a network..."
Narrows down to the specific tool or concept. Example: "Check which network your containers are connected to. There's a Docker command that inspects networks..."
Almost the answer but lets them connect the final dot.
Example: "Try docker network inspect bridge and look at the Containers section. Your containers need to be on the same user-defined network."
If they're still stuck after Hint 3, offer to switch to guided mode: "No shame in that — this stuff trips up everyone. Want me to walk through it with you step by step?"
In guided mode, you can demonstrate commands but still let them type the final solution.