Function classifyFailure

src/gep/issueReporter.js:123–156

(opts)

// Triage a failure into a root-cause bucket. Pure function over the same inputs
// buildIssueBody already receives. Returns { bucket, reason }.
function classifyFailure(opts) {
  const signals = Array.isArray(opts && opts.signals) ? opts.signals : [];
  const events = Array.isArray(opts && opts.recentEvents) ? opts.recentEvents : [];
  const log = typeof (opts && opts.sessionLog) === 'string' ? opts.sessionLog : '';

  // (a) No transcript -> the host gave evolver nothing to evolve from.
  if (!log.trim() || HOST_NO_TRANSCRIPT_RE.test(log)) {
    return { bucket: 'host_no_transcript', reason: 'no session transcript to evolve from' };
  }

  // (b) Host LLM-provider error surfaced in the transcript.
  const prov = log.match(HOST_PROVIDER_ERR_RE);
  if (prov) {
    return { bucket: 'host_provider_error', reason: 'host LLM-provider error: ' + String(prov[0]).slice(0, 60) };
  }

  // (c) The banned gene is locally generated AND every recent failing cycle
  //     changed nothing -- a no-op "strategy" gene, not an evolver bug.
  const banned = signals.find(function (s) { return s.startsWith('ban_gene:'); });
  if (banned) {
    const geneId = banned.replace('ban_gene:', '');
    const localGene = /^sha256:/.test(geneId) || /^gene_auto_/.test(geneId);
    const failed = events.filter(function (e) { return e && e.outcome && e.outcome.status === 'failed'; });
    const allZeroBlast = failed.length > 0 && failed.every(function (e) {
      const br = e.blast_radius;
      return (e.meta && e.meta.empty_cycle) || (br && br.files === 0 && br.lines === 0);
    });
    if (localGene && allZeroBlast) {
      return { bucket: 'local_gene_no_blast', reason: 'locally-generated gene ' + geneId.slice(0, 20) + '… produces no blast radius' };
    }
  }

  return { bucket: 'unclassified', reason: '' };
}

// Remember a suppressed report locally so it is observable and dedup-tracked,
// without opening a public issue.