# Command Reference

## Core Runtime Commands

```bash
# run (paper)
python -m src.main --mode=paper

# run with dashboard thread
python -m src.main --mode=paper --dashboard

# tests
pytest -v --cov=src

# lint
ruff check src/ tests/

# type-check
mypy src/ --strict
```

## Dashboard Runtime Controls

`Issue 4-3` 기준 반영:

- CLI: `--dashboard`
- ENV: `DASHBOARD_ENABLED=true`
- Host/Port:
- `DASHBOARD_HOST` (default `127.0.0.1`)
- `DASHBOARD_PORT` (default `8080`)

## Telegram Commands (현재 구현)

`main.py` 등록 기준:

- `/help`
- `/status`
- `/positions`
- `/stop`
- `/resume`

## Telegram Commands (미구현 상태)

V2 플랜 `Issue 4-1` 항목은 아직 미구현:

- `/report [KR|US]`
- `/scenarios [KR|US]`
- `/review [KR|US]`
- `/dashboard`

## Gitea / tea Workflow Commands

이슈 선등록 후 작업 시작:

```bash
YES="" ~/bin/tea issues create \
  --repo jihoson/The-Ouroboros \
  --title "..." \
  --description "..."
```

작업은 `worktree` 기준 권장:

```bash
git worktree add ../The-Ouroboros-issue-<N> feature/issue-<N>-<slug>
```

PR 생성:

```bash
YES="" ~/bin/tea pulls create \
  --repo jihoson/The-Ouroboros \
  --head feature/issue-<N>-<slug> \
  --base main \
  --title "..." \
  --description "..."
```

## Known tea CLI Gotcha

TTY 없는 환경에서는 `tea` 확인 프롬프트가 실패할 수 있습니다.
항상 `YES=""`를 붙여 비대화식으로 실행하세요.