用途:在新增或修改 ClawHub Convex 数据表、TTL 字段、清理 cron、保留策略、认证/会话清理、指标去重清理或废弃逻辑时使用。其核心原则是保留策略由代码拥有:每张现有 Convex 表都必须在 convex/lib/retentionPolicy.ts 中分类,临时表需要带索引的有界清理路径,除非其生命周期由使用期校验或已记录组件处理。
主要能力与要求:先使用 clawhub-convex 并阅读 convex/_generated/ai/guidelines.md。所有新 schema 表都要加入 RETENTION_POLICIES,Record<TableNames, RetentionPolicy> 类型是强制门槛。临时表优先使用显式过期字段加索引,然后用 .withIndex() 与 .take(...) 剪枝。新的通用 TTL 表优先用 expirationTime 以匹配 Convex Auth;现有 expiresAt、dayStart、processedAt 字段保持不变,除非该表已确需真正迁移。普通保留任务使用 RETENTION_STANDARD_BATCH_SIZE,特殊情况如 skillStatEvents 保持其文档化上限。Cron 只调度有界清理入口点;大型一次性生产迁移或破坏性回填仍从 convex-migration-helper 开始。不要批量清除活跃认证状态,过期 authSessions 与 authRefreshTokens 由 convex/retention.ts 清理。
验证方式:为策略分类与清理行为新增或更新聚焦测试;运行涉及清理模块的聚焦 Vitest 切片;schema/API 变更后运行 bunx convex codegen;运行真实 Convex 运行时检查,如 bunx convex dev --once --typecheck=disable。
限制:资料未提供具体命令的完整参数、支持平台范围、收费方式与性能数据,暂未提供。