Improved few-shot examples and natural burstiness in Enhanced mode

humanizer.py

@@ -6,40 +6,48 @@ from groq import Groq
 # what natural human prose looks like — varied, imperfect, personal.
 
 FEW_SHOT_EXAMPLES = """
-Here are examples of genuine human writing. Study the rhythm, word choice,
-sentence variety, and natural imperfections. Imitate this style:
-
-EXAMPLE 1 (Blog/Casual):
-"I've been thinking about this for weeks now, and I still don't have a clean answer.
-Social media is weird. Not bad-weird necessarily, just... complicated. You get on
-there to stay in touch with people, and somehow you end up knowing the political
-opinions of your dentist's cousin. Nobody asked for that. And yet here we are,
-scrolling at midnight, wondering why we feel vaguely terrible.
-The thing nobody tells you is that the platform is working exactly as intended."
-
-EXAMPLE 2 (Professional/Analytical):
-"The numbers don't lie, but they don't tell the whole story either. Last quarter
-looked rough on paper — revenue down 8%, customer churn up slightly. But dig
-into the cohort data and a different picture emerges. The customers we acquired
-after the rebrand are sticking around. The ones leaving? Almost entirely
-pre-2022 signups who never really fit the new direction anyway.
-That's not a crisis. That's a transition."
-
-EXAMPLE 3 (Academic/Formal):
-"The assumption that technological adoption follows a predictable S-curve has
-shaped product strategy for decades. What this model fails to account for,
-however, is the role of social trust in accelerating or stalling diffusion.
-When communities perceive a technology as threatening existing power structures —
-regardless of its actual utility — adoption stalls in ways the curve simply
-cannot predict. The data from the 2019 contact tracing rollout illustrates
-this precisely."
-
-EXAMPLE 4 (Personal/Reflective):
-"My grandfather never owned a computer. He died at 91, having written every
-letter by hand, remembered every phone number, and navigated every city
-with a paper map he'd fold wrong every single time. I used to think that
-was a limitation. I'm less sure now. There's something to be said for a
-life where the information you carry is only what your mind decided to keep."
+Study these human writing samples. Pay attention to how short sentences
+arise NATURALLY from the content — they are never inserted randomly.
+Notice how specific details make the writing feel real.
+Notice how paragraphs have integrity — they develop one idea fully.
+
+EXAMPLE 1 (Student Essay / Neutral):
+"The relationship between sleep and academic performance is more complicated
+than most students realize. It is not simply a matter of getting eight hours.
+The timing matters, the quality matters, and the consistency across the week
+matters more than any single night of good rest. Students who sleep well before
+exams but stay up until 3am on weekdays are not doing themselves any favors.
+The brain consolidates memory during sleep, and disrupting that process even
+occasionally can set back retention in ways that are hard to recover from."
+
+EXAMPLE 2 (Blog / Casual):
+"Nobody tells you how strange it feels to delete Instagram for the first time.
+You expect to feel free. Instead, you keep reaching for your phone out of habit,
+unlocking it, staring at the home screen, and then putting it back down. The
+app is gone but the impulse isn't. That takes weeks to fade. And once it does,
+you start noticing things you missed — conversations, meals, the specific quality
+of light at 4pm that you used to photograph instead of just watch."
+
+EXAMPLE 3 (Academic / Formal):
+"Research into adolescent social media use has consistently identified a
+correlation between time spent on image-based platforms and self-reported
+measures of body dissatisfaction. What remains less clear is the direction
+of causality. Adolescents who already experience low self-esteem may be
+drawn to platforms where social comparison is constant, rather than
+developing low self-esteem as a result of those platforms. Disentangling
+these two pathways requires longitudinal data that most existing studies
+lack. The policy implications differ significantly depending on which
+explanation proves more accurate."
+
+EXAMPLE 4 (Personal / Reflective):
+"My grandmother kept a garden her entire adult life. Not a beautiful garden —
+a practical one, full of tomatoes and peppers and herbs she actually used.
+She never posted photos of it. Never thought to. The garden existed for its
+own sake, and for the people she fed, and that was enough. I think about
+that sometimes when I catch myself arranging food on a plate before eating
+it, trying to get the light right, framing the shot. Something has shifted
+in how we understand the value of an experience. I am not sure the shift
+has been entirely good."
 """
 
 # ── SIMPLE ────────────────────────────────────────────────────────────────────
@@ -75,46 +83,64 @@ Rules:
 11. Output ONLY the rewritten text. No preamble. No explanation."""
 
 # ── ENHANCED ──────────────────────────────────────────────────────────────────
-ENHANCED_PROMPT = """You are an expert human writer. Rewrite the text below so it reads like natural human writing and bypasses AI detection.
+ENHANCED_PROMPT = """You are an expert human writer and editor. Your job is to
+rewrite the provided text so it reads like authentic human writing.
 
-Study these human writing examples first:
+Study these examples of genuine human prose carefully:
 
 {few_shot_examples}
 
-SENTENCE STRUCTURE RULES (follow exactly):
-- Every paragraph must contain at least one sentence under 7 words.
-- Every paragraph must contain at least one sentence over 25 words.
-- Never write two sentences of similar length back to back.
-- Use sentence fragments occasionally. Like this. They work.
-- One sentence per paragraph can be a question the writer asks themselves.
-
-WORD CHOICE RULES:
-- Never use these words: tapestry, delve, testament, beacon, foster, align, overarching, landscape, seamlessly, groundbreaking, revolutionary, pivotal, crucial, vital, robust, leverage, utilize, facilitate, commence, endeavor, multifaceted.
-- Avoid the most obvious word choice. Pick the second or third most natural option.
-- Mix formal and casual words in the same paragraph deliberately.
-- Use contractions naturally in 30% of sentences.
-
-STYLE RULES:
-- Remove these phrases entirely: "It is important to note", "Furthermore", "Moreover", "In conclusion", "When it comes to", "It is worth noting", "Needless to say", "It goes without saying", "It is crucial to", "One must consider".
-- No hyphens (-), em dashes (—), or en dashes (–). Use commas or new sentences.
-- No perfectly balanced bullet lists. Break them into prose.
-- Add one parenthetical thought somewhere that sounds natural.
-- Add one personal observation or opinion — one moment that sounds like a real person wrote this.
-- Flip passive voice to active voice throughout.
+Notice what makes them human:
+- Short sentences arise from the content naturally, never inserted randomly
+- Paragraphs develop one idea fully before moving on
+- Specific concrete details instead of vague gestures
+- The writer's perspective shows up occasionally, never forced
+- Transitions feel earned, not mechanical
+
+Now rewrite the user's text following these rules:
+
+STRUCTURE:
+- Preserve the original paragraph structure. Do not break paragraphs apart randomly.
+- Within each paragraph, vary sentence length naturally. Let short sentences
+  emerge from the content — a short sentence works when it lands a point,
+  not just to break up length.
+- Never write three sentences of similar length in a row.
+- One sentence fragment per 2-3 paragraphs is fine if it feels natural.
+
+WORD CHOICE:
+- Never use: tapestry, delve, testament, beacon, foster, align, overarching,
+  landscape, seamlessly, groundbreaking, revolutionary, pivotal, crucial, vital,
+  robust, leverage, utilize, facilitate, commence, endeavor, multifaceted.
+- Remove: "It is important to note", "Furthermore", "Moreover", "In conclusion",
+  "When it comes to", "It is worth noting", "Needless to say",
+  "It goes without saying", "It is crucial to", "One must consider".
+- Avoid the most predictable word choice. Pick the second or third most
+  natural synonym.
+- Use specific concrete details where the original is vague.
+- Mix formal and casual register occasionally — one plain word in a formal
+  sentence, one precise word in a casual sentence.
+
+VOICE:
+- Add one moment per essay where the writer's perspective shows — a brief
+  observation, not a forced aside. It should feel earned by the surrounding text.
+- Use contractions in 25-35% of sentences.
+- Flip passive voice to active where it sounds more natural.
+- No hyphens (-), em dashes (—), en dashes (–), or hyphenated compound words.
+  Rewrite them as plain phrases.
 
 WHAT NOT TO DO:
-- Do not chain clauses together with endless commas.
-- Do not write run-on sentences stuffed with comma-connected phrases.
-- Do not repeat the same sentence structure twice in a row.
-- Do not add filler phrases to make sentences longer.
-- Do not use hyphenated compound words like "not-so-great" or "laid-back". 
-  Rewrite them as plain phrases instead (e.g. "not great", "relaxed").
+- Do not insert short sentences randomly to hit a length target.
+  Short sentences must arise from the content.
+- Do not chain clauses with endless commas.
+- Do not break up paragraphs that belong together.
+- Do not add filler phrases to pad length.
+- Do not use hyphenated compounds like "not-so-great" or "laid-back".
 - Do not change the core meaning, facts, or argument.
 
 OUTPUT:
 - Rewritten text only.
-- No introduction, no explanation, no "Here is the rewritten version".
-- Clean, readable, natural prose that sounds like a human wrote it."""
+- No introduction, explanation, or "Here is the rewritten version".
+- Clean, readable prose that sounds like a thoughtful human wrote it."""
 
 # ── READABILITY MODIFIERS ─────────────────────────────────────────────────────
 READABILITY_MODIFIERS = {