# Development

## Environment

This repo uses mise for tool versions, task execution, and local environment setup. Entering the directory with mise activated runs the bootstrap flow so Node and npm dependencies are ready; no further action should be needed to begin development.

## Commands

```sh
mise run lint
mise run format
mise run typecheck
mise run test
mise run check
```

`mise run check` is the full verification gate.

## Smoke test

Use a separate tmux window to run Pi with the local extension entrypoint loaded directly, pointing to a tmp user dir:

```sh
tmux new-window -n pi-permissions 'cd "$(pwd)" && PI_PERMISSIONS_USER_DIR=/tmp/pi-permissions-user pi -e ./extensions/index.ts'
```

## Code style

- Comments, outside those standardized in the language, should only ever be added to explain non-obvious decisions or surprising behavior
- Prefer top-down code organization:
  - exported entry points and primary behavior first
  - helpers after first use where practical
  - exported API types near the top