pi-goals contributor notes

Tests

Run npm test before a commit. It includes unit and flow tests plus the RPC review test.

test/*.test.ts unit and flow tests use a small Pi API mock. They check plan state, tool gates, and plan-file updates.
npm run test:rpc runs test/rpc-review.test.ts. It starts the installed Pi executable in RPC mode, uses Pi's real select and editor protocol, and uses a local deterministic HTTP model. It does not need a credential or spend API credits. This is the closest automated session test.
Use tmux for visual TUI debugging when the RPC test fails or a terminal-only problem is reported:
```
tmux new-session -s pi-goals-debug 'cd /path/to/pi-goals && pi -e ./src/index.ts'
```
Run /goals <objective> in that pane. Tmux checks the rendered menu, editor focus, widget, and keyboard handling. RPC does not render the terminal UI.
pi -p has no UI, so it cannot test Ready, Refine, Edit, or Cancel.