ai-workflow-skill/docs/tests/inbox/init/README.md

Inbox init Test Plan

Scope

This document covers the externally visible behavior of inbox init.

Shared conventions live in ../_shared/README.md.

case: init-creates-schema-on-empty-db

用例意义

验证在空数据库路径上执行 init 会创建可用的 inbox schema，并返回稳定的初始化响应。

前置条件

• 选择一个尚不存在的数据库路径 TMPDIR/coord.db

输入

inbox --db TMPDIR/coord.db --json init

预期输出

• 命令退出码为 0
• 返回 ok=true
• command 为 init
• data.db_path 等于传入路径
• data.status 为 initialized

断言结论

• init 在空路径上可以直接完成 schema 初始化
• 初始化结果足以让后续 send、fetch 等命令继续使用同一数据库

case: init-is-idempotent-on-existing-db

用例意义

验证 init 可以对已初始化过的数据库重复执行，而不会报错或破坏已有 schema。

前置条件

• TMPDIR/coord.db 已经执行过一次 inbox --db TMPDIR/coord.db --json init

输入

inbox --db TMPDIR/coord.db --json init
inbox --db TMPDIR/coord.db --json init

预期输出

• 两次命令都退出码为 0
• 两次响应都返回 data.status == "initialized"
• 两次响应都返回相同的 data.db_path

断言结论

• init 是幂等操作
• 对已存在 schema 的重复初始化不应引入额外迁移失败或状态漂移