SuperAPI AI 工具集

harness-drift-from-history

部署与运维

查看项目

更新于 10-15 22:32

技能介绍

用途:用于在周期性运行 oia-audit 后快速回答“是否发生了漂移”。它把原先需要三步(先 audit-list 选基线 key、再跑 oia-audit 生成当前结果、最后用 audit-trend 比对)的流程合成为一个命令。

主要能力:通过 audit-list.mjs 列出 metaharness-audit 命名空间中的记录,按 startedAt 选取最近一条作为基线(可用 --baseline-since 7d 跳过 7 天内更新的记录);对当前路径执行一次新的 oia-audit;再用 audit-trend 对二者做差异比较,并施加 --alert-on-distance-below ${threshold} 判断是否触发告警;最终输出结构化漂移报告。

使用方式:npx ruflo metaharness drift-from-history --threshold 0.95。示例输出会显示基线记录、当前时间戳、结构相似度、距离以及是否满足阈值。

退出码:0 表示相似度达到或未越过阈值;1 表示检测到漂移(相似度低于阈值并触发告警);2 表示配置错误(无历史记录或 audit-list 失败);3 表示上游 metaharness 缺失(返回 degraded 载荷)。

限制与约束(ADR-150):属于可移除设计,仅对现有脚本做纯子进程组合,不新增 @metaharness/* 导入;若 oia-audit 报告 degraded:true,则以退出码 3 返回降级载荷;审计历史为空时以退出码 2 给出需要先填充历史的提示,不会崩溃;CI 门禁由 smoke 步骤 17z16 锚定调度器入口与子命令列表。实现位于 scripts/drift-from-history.mjs。