Function checkCompletionClaims

src/agent/completion-gate.ts:110–136

(
  claims: CompletionClaims,
  evidence: SessionEvidence,
)

 * Conservative by design — only flags CLEAR contradictions to avoid nagging.
 */
export function checkCompletionClaims(
  claims: CompletionClaims,
  evidence: SessionEvidence,
): string | null {
  const problems: string[] = [];

  if (claims.claimsTestsPass && !evidence.didRunTests) {
    problems.push(
      'You stated the tests pass, but no test command ran this session. Either run the ' +
      'test suite now and show the actual output, or remove the claim that tests pass.',
    );
  }
  if (claims.claimsFixOrChange && !evidence.didSuccessfulEdit) {
    problems.push(
      'You stated you fixed/changed/created something, but no file edit succeeded this ' +
      'session. Either make the actual edit now, or correct your summary to say what you ' +
      'really did (e.g. only analyzed, or were blocked).',
    );
  }

  if (problems.length === 0) return null;
  return (
    '[COMPLETION_GATE] Before finishing, your claims must match what actually happened:\n' +
    problems.map(p => '  • ' + p).join('\n') +
    '\nDo the work or revise the claim — do not report success you cannot demonstrate.'
  );
}

/** Convenience: one call from text + messages → corrective message or null. */
export function evaluateCompletion(finalText: string, messages: MsgLike[]): string | null {