仓库约定

这些规则是对 Luna-Flow 文档标准针对 mooncake_impact_factor 的补充。本仓库包含三个 MoonBit 包（score、cli 和 static_search）、一个 Python 索引构建器和一个 Next.js 应用，因此其文档必须让所有这些部分保持一致。

范围

• 描述当前分支上的 0.1.2 基线。
• 不要记录尚未发布的命令、路由、字段或 MoonBit 导出。
• 行为只在本地生效时要直接说明，不要暗示存在全局服务契约。

一致性

• README.md、CONTRIBUTING.md 和手册必须讲同一个版本故事。
• API 文档必须匹配真实的 MoonBit 包名、函数签名和 Next.js 路由契约。
• 如果 Python 脚本暴露了稳定 CLI 参数、数据库行为或搜索语义，要明确写出来。
• 要区分“本地注册表事实”和“mooncakes 权威事实”。
• 分数公式、等级阈值和势头规则归 src/score 所有。设计页面根据代码推导它们的性质；两者要在同一个提交中修改。
• 在 MoonBit 之外实现的行为（信号统计、查询求值）记录在使用它的指南或设计页面中，并链接到实现它的文件。