trapstreet-setup

trapstreet-setup -- install and authorize

Target state: tp runs, and (only if the user wants to submit) tp auth status --verify shows the correct identity. Verify each step before moving to the next.

Say this first, to lower the stakes: local scoring (tp run) needs no authorization and no GitHub account -- once tp is installed, trapstreet-solution-scaffold (or trapstreet-task-scaffold) can already build and run against a task. Authorization (Step 4) is only needed to submit to the leaderboard.

Step 1 -- check current state (installation may not be needed at all)

which uv && uv --version
which tp && tp --help | head -5   # do NOT verify with `tp --version` -- old versions lack that
                                    # flag and throw a scary Error while the tool is actually fine
uv tool list | grep -i trap        # real installed package name: current is trap-cli;
                                    # an older machine may instead have trapstreet-cli
tp auth status --no-verify 2>&1 | head -5

All good already? Don't reinstall -- report the current state (tool works, login status) and move straight to whatever the user actually wants to do. If the installed package is trapstreet-cli (not trap-cli), recommend upgrading: uv tool uninstall trapstreet-cli && uv tool install trap-cli -- the old package predates the trap.yaml schema that trapstreet-solution-scaffold's templates target, and has no confirmation gates for remote code / unanchored runs. If the user declines, say so plainly rather than pretending it's current.

Step 2 -- install uv (if missing)

curl -LsSf https://astral.sh/uv/install.sh | sh   # macOS/Linux, official script
# or: brew install uv
uv --version   # verify; if not found, reopen the shell or source the profile

Step 3 -- install tp

uv tool install trap-cli
tp --help | head -5

The command is tp; the package is trap-cli. If Step 1 detected the old trapstreet-cli package instead, uv tool upgrade trap-cli against it returns "not installed" (wrong package name) -- uninstall the old one and install the new one, don't try to upgrade in place.