Improve audit pipeline and outreach review

tests/german-copy-guard.test.ts

@@ -9,12 +9,12 @@ import {
 
 const validPayload = {
   auditSummary:
-    "Ich habe euren Webauftritt geprüft. Mir ist aufgefallen, dass die Kontaktseite nicht klar erreichbar ist. Ich empfehle, den Kontaktbereich im Header sichtbar zu platzieren.",
+    "Ich habe Ihren Webauftritt geprüft. Mir ist aufgefallen, dass die Kontaktseite nicht klar erreichbar ist. Ich empfehle, den Kontaktbereich im Header sichtbar zu platzieren.",
   auditBody:
     "Mir ist aufgefallen, dass die Kontaktseite nur am Ende der Startseite eingebettet ist. Ich empfehle, sie im Kopfbereich direkt zu platzieren.",
-  emailSubject: "Kurzes Feedback zu eurem Webauftritt",
+  emailSubject: "Kurzer Website-Hinweis",
   emailBody:
-    "Hallo, ich habe eure Seite betrachtet und festgestellt, dass die Kontaktoptionen auf mobilen Geräten schwer zu finden sind. Ich empfehle, einen klar sichtbaren Button einzubauen.",
+    "Guten Tag, auf Ihrer Kontaktseite ist die Telefonnummer gut sichtbar, der mobile Kontaktbutton liegt aber erst weiter unten. Das kostet Besuchern unterwegs einen extra Schritt, gerade wenn sie schnell anrufen oder einen Termin anfragen wollen. Ich wollte Ihnen das kurz spiegeln, weil es mit wenig Aufwand klarer wirken kann. Mehr braucht es dafür wahrscheinlich nicht. Soll ich Ihnen die zwei Punkte kurz schicken?",
   callScript: {
     openingLine: "Hallo, ich bin Matthias von der Webberatung.",
     callScript: [
@@ -34,6 +34,18 @@ test("validateCustomerFacingCopy passes clean German outreach and audit copy", (
   assert.equal(result.issues.length, 0);
 });
 
+test("validateCustomerFacingCopy passes a natural short formal first-contact email", () => {
+  const result = validateCustomerFacingCopy({
+    ...validPayload,
+    emailSubject: "Kurz zur Kontaktseite",
+    emailBody:
+      "Guten Tag, Ihre Telefonnummer ist auf der Kontaktseite gut auffindbar. Auf dem Handy rutscht der direkte Kontaktweg aber recht weit nach unten, sodass Besucher erst suchen müssen, bevor sie anrufen oder schreiben können. Ich wollte Ihnen das kurz zurückmelden, weil es ein kleiner Hebel für mehr Anfragen sein kann. Es geht nicht um einen großen Umbau. Soll ich Ihnen die Stelle kurz als Screenshot schicken?",
+  });
+
+  assert.equal(result.passed, true);
+  assert.deepEqual(result.issues, []);
+});
+
 test("validateCustomerFacingCopy rejects likely non-German copy and reports language", () => {
   const result = validateCustomerFacingCopy({
     ...validPayload,
@@ -75,11 +87,13 @@ test("validateCustomerFacingCopy flags short English artifact-like snippets in c
   }
 });
 
-test("validateCustomerFacingCopy requires Ich-form in applicable customer-facing fields", () => {
+test("validateCustomerFacingCopy requires Ich-form in applicable public audit and follow-up fields", () => {
   const result = validateCustomerFacingCopy({
     ...validPayload,
     auditBody:
       "Ihre Seite hat eine gute Struktur. Der Kontaktbereich sollte klarer werden.",
+    emailBody:
+      "Guten Tag, Ihre Kontaktseite ist schon klar aufgebaut. Auf dem Handy liegt der direkte Kontaktweg aber recht weit unten, sodass Besucher erst suchen müssen, bevor sie anrufen oder schreiben können. Das ist vermutlich schnell zu beheben und würde den Einstieg einfacher machen. Soll ich Ihnen die konkrete Stelle kurz schicken?",
     followUp: "Die Website sollte verbessert werden. Setzt bitte einen Kontaktbutton.",
   });
 
@@ -187,10 +201,28 @@ test("validateCustomerFacingCopy strips technical artifacts like model ids and r
 });
 
 test("validateCustomerFacingCopy enforces observation + suggestion style", () => {
+  const result = validateCustomerFacingCopy({
+    ...validPayload,
+    auditBody:
+      "Ihre Website wirkt freundlich und klar.",
+  });
+
+  assert.equal(result.passed, false);
+  assert.equal(
+    result.issues.some(
+      (issue) =>
+        issue.field === "auditBody" &&
+        issue.rule === "missing_observation_or_suggestion",
+    ),
+    true,
+  );
+});
+
+test("validateCustomerFacingCopy blocks formulaic observed-and-suggested email copy", () => {
   const result = validateCustomerFacingCopy({
     ...validPayload,
     emailBody:
-      "Deine Website ist großartig, tolle Arbeit.",
+      "Guten Tag, ich habe beobachtet, dass Ihre Website klare Kontaktinformationen bietet. Ich schlage vor, diese Sichtbarkeit auf allen Seiten beizubehalten. Ich habe beobachtet, dass außerdem die Ladezeiten verbesserungswürdig sind. Ich schlage vor, technische Maßnahmen umzusetzen, damit die Nutzererfahrung nachhaltig verbessert wird. Soll ich Ihnen dazu mehr Informationen senden?",
   });
 
   assert.equal(result.passed, false);
@@ -198,13 +230,50 @@ test("validateCustomerFacingCopy enforces observation + suggestion style", () =>
     result.issues.some(
       (issue) =>
         issue.field === "emailBody" &&
-        issue.rule === "missing_observation_or_suggestion",
+        issue.rule === "formulaic_email_tone",
     ),
     true,
   );
 });
 
-test("validateCustomerFacingCopy accepts live audit copy with noun suggestion and collaborative close", () => {
+test("validateCustomerFacingCopy blocks long mini-audit outreach emails", () => {
+  const result = validateCustomerFacingCopy({
+    ...validPayload,
+    emailBody:
+      "Guten Tag, auf Ihrer Website sind Adresse und Telefonnummer gut sichtbar. Außerdem fehlt eine aussagekräftige Meta-Beschreibung. Zudem sind die Ladezeiten auf mobilen Geräten verbesserungswürdig. Ein weiterer Punkt ist die Nutzerführung mit Call-to-Action-Elementen. Schließlich könnten lokale Vertrauenssignale wie Bewertungen ergänzt werden. Ich empfehle, diese Maßnahmen umzusetzen, um die Conversion-Rate zu steigern, Absprungraten zu senken und Ihr Ranking positiv zu beeinflussen. Soll ich Ihnen eine ausführliche Analyse schicken?",
+  });
+
+  assert.equal(result.passed, false);
+  assert.equal(
+    result.issues.some(
+      (issue) =>
+        issue.field === "emailBody" &&
+        (issue.rule === "email_reads_like_mini_audit" ||
+          issue.rule === "brochure_email_language"),
+    ),
+    true,
+  );
+});
+
+test("validateCustomerFacingCopy blocks inflated outreach subject lines", () => {
+  const result = validateCustomerFacingCopy({
+    ...validPayload,
+    emailSubject:
+      "Optimierungspotenziale für Ihre Website: Mehr Sichtbarkeit und bessere Nutzererfahrung",
+  });
+
+  assert.equal(result.passed, false);
+  assert.equal(
+    result.issues.some(
+      (issue) =>
+        issue.field === "emailSubject" &&
+        issue.rule === "unnatural_email_subject",
+    ),
+    true,
+  );
+});
+
+test("validateCustomerFacingCopy blocks old live audit copy that reads like generated outreach", () => {
   const result = validateCustomerFacingCopy({
     auditSummary:
       "Ich habe beobachtet, dass die Website von Diehl & Pape Rechtsanwälte zwar durch ihre klare Spezialisierung und umfassenden Kontaktinformationen überzeugt, jedoch durch langsame Ladezeiten und sichtbare Inhaltsverschiebungen beim Laden an Nutzerkomfort verliert. Ich schlage vor, gezielt die Ladegeschwindigkeit zu optimieren und das Seitenlayout stabil zu gestalten, um das Vertrauen potenzieller Mandanten zu stärken und die Nutzerbindung nachhaltig zu erhöhen.",
@@ -228,8 +297,17 @@ test("validateCustomerFacingCopy accepts live audit copy with noun suggestion an
       "Ich habe beobachtet, dass die Website von Diehl & Pape Rechtsanwälte durch langsame Ladezeiten an Nutzerkomfort verliert. Mein konkreter Vorschlag ist, die Ladegeschwindigkeit gezielt zu optimieren und die Stabilität des Seitenlayouts sicherzustellen.",
   });
 
-  assert.equal(result.passed, true);
-  assert.deepEqual(result.issues, []);
+  assert.equal(result.passed, false);
+  assert.equal(
+    result.issues.some(
+      (issue) =>
+        (issue.field === "emailSubject" &&
+          issue.rule === "unnatural_email_subject") ||
+        (issue.field === "emailBody" &&
+          issue.rule === "formulaic_email_tone"),
+    ),
+    true,
+  );
 });
 
 test("validateCustomerFacingCopy is permissive for phone numbers and date values", () => {
@@ -238,9 +316,9 @@ test("validateCustomerFacingCopy is permissive for phone numbers and date values
       "Ich habe gesehen, dass eure Kontaktseite am 12.02.2026 aktualisiert wurde. Ich empfehle, den Kontaktbereich als Nächstes im Header zu verbessern.",
     auditBody:
       "Mir ist aufgefallen, dass die Telefonnummer 0201 123456 in der Fußzeile steht. Ich empfehle, sie zusätzlich im Header zu platzieren.",
-    emailSubject: "Kurzes Feedback zu eurem Terminplan",
+    emailSubject: "Kurz zum Terminplan",
     emailBody:
-      "Hallo, ich habe euren Webauftritt geprüft und habe gesehen, dass Termine auf der Seite mit dem Datum 12. Oktober erwähnt sind. Ich empfehle, diese Terminangabe im Header stärker hervorzuheben.",
+      "Guten Tag, auf Ihrer Seite ist der Termin am 12. Oktober schon erwähnt. Auf dem Handy steht diese Info aber recht weit unten, sodass Besucher sie leicht übersehen können, wenn sie nur schnell nach Öffnungszeiten oder Kontakt suchen. Ich wollte Ihnen das kurz zurückmelden, weil die Stelle ohne großen Umbau klarer werden kann. Mehr als eine kleine Umplatzierung braucht es vermutlich nicht. Soll ich Ihnen den Ausschnitt kurz schicken?",
     callScript: {
       openingLine:
         "Hallo, ich bin Matthias und ich habe eure Seite geprüft.",