Function detectFailurePatterns

src/skills/learning/failures.ts:72–88

(events: FailureEvent[], opts: DetectOpts = DEFAULT_DETECT)

/** Cluster events by signature and return only the patterns that RECUR enough to learn. */
export function detectFailurePatterns(events: FailureEvent[], opts: DetectOpts = DEFAULT_DETECT): FailurePattern[] {
  const by = new Map<string, { tool: string; count: number; tasks: Set<string>; sample: string }>();
  for (const e of events) {
    let g = by.get(e.signature);
    if (!g) { g = { tool: e.tool, count: 0, tasks: new Set(), sample: e.sample }; by.set(e.signature, g); }
    g.count++;
    g.tasks.add(e.task);
  }
  const out: FailurePattern[] = [];
  for (const [signature, g] of by) {
    if (g.count >= opts.minOccurrences && g.tasks.size >= opts.minDistinctTasks) {
      out.push({ signature, tool: g.tool, count: g.count, distinctTasks: g.tasks.size, sample: g.sample });
    }
  }
  // Most-repeated first.
  return out.sort((a, b) => b.count - a.count);
}

/** Templated, DETERMINISTIC caution for a recurring failure. Never LLM-phrased. */
export function buildLesson(p: FailurePattern): string {