# Inbox `list` Test Plan

## Scope

This document covers thread listing behavior via `inbox list`.

Shared conventions live in [../_shared/README.md](../_shared/README.md).

## case: list-filters-by-status

### 用例意义

验证 `list --status` 只返回指定状态集合内的线程。

### 前置条件

- 数据库中存在多个不同状态的线程

### 输入

```bash
inbox --db TMPDIR/coord.db --json list --status pending,blocked
```

### 预期输出

- 命令退出码为 `0`
- 返回的每条线程都满足 `status in ["pending","blocked"]`

### 断言结论

- `list` 是全局筛选视角，状态过滤不会被忽略

## case: list-filters-by-created-by

### 用例意义

验证 `list --created-by` 能按线程创建者筛选结果。

### 前置条件

- 至少有两位不同创建者产生的线程

### 输入

```bash
inbox --db TMPDIR/coord.db --json list --created-by leader
```

### 预期输出

- 命令退出码为 `0`
- 返回的每条线程都满足 `created_by == "leader"`

### 断言结论

- `created-by` 过滤条件直接作用在线程元数据上

## case: list-filters-by-assigned-to

### 用例意义

验证 `list --assigned-to` 能按当前指派执行者筛选线程。

### 前置条件

- 数据库中存在多个不同 `assigned_to` 的线程

### 输入

```bash
inbox --db TMPDIR/coord.db --json list --assigned-to worker-d --status pending
```

### 预期输出

- 命令退出码为 `0`
- 返回的每条线程都满足 `assigned_to == "worker-d"`

### 断言结论

- `list` 可用于管理侧查看某位执行者当前承担的线程集合

## case: list-respects-limit

### 用例意义

验证 `list --limit` 会约束返回条数，并按更新时间倒序返回最新线程。

### 前置条件

- 存在多个满足过滤条件的线程

### 输入

```bash
inbox --db TMPDIR/coord.db --json list --assigned-to worker-d --limit 1
```

### 预期输出

- 命令退出码为 `0`
- 返回线程数不超过 `1`

### 断言结论

- `list` 的 limit 是硬上限，不会返回超量结果