# store-suite 错误码

CLI 输出单行 JSON：`{"ok": false, "error": "<code>", ...}`。Agent 应据码向用户说明并给出下一步。

## 通用

| 错误码 | 含义 | 用户指引 |
|--------|------|----------|
| `need_confirm` | 写操作需二次确认 | 展示 `preview`，征得同意后原命令加 `--yes` 重试 |
| `not_found` | 资源不存在 | 核对 `detail` 中的 file / path，确认 starter 目录或 seed 文件 |

## 本 skill 特有

| 错误码 | 含义 | 用户指引 |
|--------|------|----------|
| `verify_failed` | seed 校验未通过 | 查看 `checks`；空库时首次 CLI 会自动 seed，也可手动 `seed` |
| `invalid_meta_key` | 元数据键不在白名单 | 仅允许 segment_preset / lexicon 等，见 `detail.allowed` |

## 示例

```json
{"ok": false, "error": "not_found", "detail": {"path": "..."}}
{"ok": false, "error": "verify_failed", "detail": {"checks": {"table:store_members": false}}}
```
