用途：检测 gbrain 当前使用的引擎（PGLite 或 Postgres），在 agent-harness 安装时优先选择 Postgres，并在用户同意后把 PGLite 数据安全迁移到 Postgres。
主要能力：
- 检测：gbrain engine status --json，只读且不依赖引擎，可在数据库宕机时运行。根据 effective_engine、config_file_engine、db_url_source、thin_client 等字段分支处理。
- 全新安装：gbrain init --prefer-postgres，按顺序尝试环境变量 URL、Supabase Management-API 发现、本地 Postgres、docker、PGLite，每级不可用会打印一行说明。
- 迁移：先规划 gbrain migrate --to postgres --url-env GBRAIN_TARGET_URL --json（退出码 3，输出确认文档），用户确认后运行 gbrain migrate --to postgres --url-env GBRAIN_TARGET_URL --yes --expect <plan_hash>。
- 恢复：gbrain migrate --status --json 只读，可 --resume 或 --rollback-to-source。
使用方式与限制：
- 目标 URL 只放在 GBRAIN_TARGET_URL 环境变量中，命令使用 --url-env GBRAIN_TARGET_URL，不写入命令行或输出。
- 引擎切换绝不通过编辑配置完成，gbrain config set engine 会被拒绝。
- docker 级需 --allow-docker，本地建库需 --allow-create-db，均需用户明确同意。
- 迁移前必须让用户看到计划，--yes 需配合 --expect <plan_hash>；--force 仅在计划列出清除内容且用户同意时使用。
- 旧数据目录保留为 <path>.graduated-<run_id>，删除由用户决定。
- Postgres 适合并发、多机访问和 1000+ 页面；PGLite 保留每轮 bootstrap hook 通道，否则 PGLite 也足够。
- 若 Postgres 探测失败属于访问问题，应转向 db-repair。
适用场景：需要并发 agent、多台机器或大规模页面的 gbrain 部署，以及从 PGLite 升级到 Postgres 的迁移。
暂未提供：具体收费、价格、平台支持范围等资料未在给定内容中说明。