用途:find-peers 是 rat-stack 中用于发现和维护公开 peer 仓库的脚本与配套流程。peer 指使用其依赖族或相关集成的公开仓库,默认需共享两个依赖族;相关 XState 运行时或集成可单独入选。目标是尽早发现破坏性变更和有价值的模式。
主要能力:运行 pnpm find-peers 会从各 workspace 的 package.json 读取精确预发布版本和稳定的 Effect 4 主版本,按依赖族各查询一次 Sourcegraph,并按共享族数量排序仓库结果;父包携带的 scoped 包(如 @effect/vitest 与 effect)只计一次。不在 .brain/data/peers.json 中的仓库标记为 new,搜索约需二十秒,可用 --min 1 查看仅共享一个依赖族的仓库。
使用方式:刷新结构化行建议每一到两周一次,并在每次共享依赖(Effect、Alchemy、XState、@xstate/effect)更新后进行。rat-stack 自身固定版本在内容构建时从根、infra 和 core 清单读取,无需手改基线。每个 peer 需将其默认分支解析为提交,读取该提交处的实际清单或锁文件,记录四个依赖族、检查日期和来源链接,保留精确固定版本,如实标注范围、workspace/catalog 引用和缺失依赖,并展示与 rat-stack 固定版本的差异。所有 peer 记录保存在 .brain/data/peers.json,内容构建读取该数据集并渲染 .brain/resources/peers.svx:S、A、B 显示在主表,C 至 F 折叠于 Also seen 列表。不要手改渲染后的表格行,也不要删除落后的 peer。
适用场景与限制:除 Sourcegraph 外,XState 定向发现可补充 GitHub 代码搜索(如搜索 @xstate/effect,或 xstate alpha filename:package.json 以及 xstate "6.0.0-alpha" filename:pnpm-lock.yaml),但 GitHub token 搜索可能产生误报,需读取实际文件确认;认证账号下需过滤 repository.isPrivate 与 repository.isFork,排除 rat-stack 自身、vendored .repos/.agent_sources 和历史归档。层级排序按对 rat-stack 的有用性,而非星数或版本对齐程度。空、截断或失败的搜索不能断言不存在公开固定版本;证据缺失时应说明未知,不得编造。对至多三个新 peer,可用 DeepWiki MCP 提一个与当前工作相关的窄问题,再在对应提交处阅读文件;仅在模式更简单或修复问题时才采纳,并在 .brain/resources/same-version-repos.svx 记录采纳与拒绝原因及其链接。资料未提供具体收费、平台范围或价格信息。