@rookiestar/eng-lang-tutor 1.0.1

package/examples/sample_keypoint_b1.json

@@ -0,0 +1,135 @@
+{
+  "date": "2026-02-20",
+  "topic_fingerprint": "workplace_touch_base",
+  "category": "oral",
+  "topic": "workplace",
+  "scene": {
+    "context": "You want to briefly connect with a colleague about a project or task. This is common in American workplaces for quick check-ins without scheduling a formal meeting.",
+    "formality": "neutral"
+  },
+  "expressions": [
+    {
+      "phrase": "Let's touch base",
+      "pronunciation_tip": "Sounds like 'touch base', not 'touch bases'. It comes from baseball!",
+      "usage_note": "Use this when you want to have a brief, informal check-in. Very common in American business culture."
+    },
+    {
+      "phrase": "Can we touch base on this?",
+      "pronunciation_tip": "Natural speed: 'Can-we-touch-base-on-this' flows together.",
+      "usage_note": "Add 'on this' when referring to a specific topic or project."
+    }
+  ],
+  "alternatives": [
+    "Let's sync up",
+    "Can we catch up briefly?",
+    "Let's check in",
+    "Do you have a minute to connect?"
+  ],
+  "chinglish_trap": {
+    "wrong": "Let's discuss together. / I want to communicate with you.",
+    "correct": "Let's touch base. / Can we sync up?",
+    "explanation": "Chinese speakers often translate directly, using 'discuss together' or 'communicate with you', which sounds formal and awkward in casual workplace settings. 'Touch base' is the natural American way to suggest a quick check-in."
+  },
+  "examples": [
+    {
+      "situation": "Morning standup meeting",
+      "dialogue": [
+        "A: Hey, I haven't seen the latest mockups. Can we touch base on those?",
+        "B: Sure, I'll swing by your desk after lunch.",
+        "A: Perfect, thanks!"
+      ]
+    },
+    {
+      "situation": "Email follow-up",
+      "dialogue": [
+        "A: I'm heading into a meeting, but let's touch base later about the client presentation.",
+        "B: Sounds good. I'll be free around 3.",
+        "A: Great, I'll ping you then."
+      ]
+    }
+  ],
+  "extended_learning": {
+    "related_phrases": [
+      "circle back - return to a topic later",
+      "loop in - include someone in communication",
+      "keep in the loop - keep someone informed"
+    ],
+    "cultural_note": "The phrase 'touch base' comes from baseball, where runners must touch each base to score. In business, it means making brief contact to share updates or align on goals. Americans use this several times per day in corporate settings!",
+    "common_mistakes": [
+      "Saying 'touch bases' (wrong plural)",
+      "Using it for long, formal meetings (it implies brevity)",
+      "Not following up after saying you'll 'touch base'"
+    ]
+  },
+  "references": {
+    "dictionary": {
+      "source": "merriam-webster",
+      "url": "https://www.merriam-webster.com/dictionary/touch%20base",
+      "note": "Official definition and usage examples"
+    },
+    "usage_context": {
+      "source": "youglish",
+      "url": "https://youglish.com/pronounce/touch%20base/english/us",
+      "note": "Hear it in 1000+ real YouTube videos"
+    },
+    "etymology": {
+      "source": "etymonline",
+      "url": "https://www.etymonline.com/word/touch",
+      "note": "From baseball: runners must touch each base to score"
+    }
+  },
+  "display": {
+    "title": "🏢 今日知识点 | Today's Knowledge Point",
+    "topic_tag": "🏷️ 主题: 职场口语 | Workplace Oral",
+    "formality_tag": "📊 正式度: 中性 | Neutral",
+    "scene_intro": "🎬 场景 | Scene",
+    "scene_text": "Quick check-in with colleagues without scheduling a formal meeting.",
+    "expressions_title": "💬 核心表达 | Key Expressions",
+    "expressions_formatted": [
+      {
+        "emoji": "✨",
+        "phrase": "**Let's touch base**",
+        "phrase_plain": "Let's touch base",
+        "pronunciation": "🔊 Sounds like 'touch base' (not 'bases')! From baseball ⚾",
+        "usage": "💡 Brief, informal check-in."
+      },
+      {
+        "emoji": "✨",
+        "phrase": "**Can we touch base on this?**",
+        "phrase_plain": "Can we touch base on this?",
+        "pronunciation": "🔊 Flows: Can-we-touch-base-ON-this.",
+        "usage": "💡 Use when referring to a specific topic."
+      }
+    ],
+    "alternatives_title": "🔄 其他说法 | Alternatives",
+    "alternatives_formatted": "• **Let's sync up**\n• **Can we catch up briefly?**\n• **Let's check in**\n• Do you have a minute to connect?",
+    "chinglish_title": "⚠️ Chinglish 陷阱 | Chinglish Trap",
+    "chinglish_formatted": "❌ Wrong: \"Let's discuss together.\"\n❌ Wrong: \"I want to communicate with you.\"\n✅ Correct: **Let's touch base!**\n✅ Correct: **Can we sync up?**\n\n📝 Why? Direct translation sounds formal and awkward. **Touch base** is the natural American way!",
+    "examples_title": "🗣️ 对话示例 | Example Dialogues",
+    "examples_formatted": [
+      {
+        "situation_emoji": "☕",
+        "situation": "Morning standup",
+        "dialogue": "💬 A: Hey, can we **touch base** on those mockups?\n💬 B: Sure, I'll swing by after lunch.\n💬 A: Perfect, thanks!",
+        "key_phrase_highlight": "**touch base**"
+      },
+      {
+        "situation_emoji": "📧",
+        "situation": "Email follow-up",
+        "dialogue": "💬 A: Let's **touch base** later about the presentation.\n💬 B: Sounds good. Free around 3?\n💬 A: Great, I'll ping you then!",
+        "key_phrase_highlight": "**touch base**"
+      }
+    ],
+    "extended_title": "📚 延伸学习 | Extended Learning",
+    "extended_formatted": "🔗 Related: **circle back** | **loop in** | **keep in the loop**\n\n🌎 Cultural Note: From baseball ⚾ - runners **touch** each **base** to score. Americans use this phrase several times a day!\n\n🚫 Common Mistakes:\n  • Saying 'touch bases' ❌\n  • Using for long meetings (it implies brevity)\n  • Not following up",
+    "references_title": "📖 权威参考 | References",
+    "references_formatted": "📚 [Merriam-Webster](https://www.merriam-webster.com/dictionary/touch%20base) - Definition & examples\n🎬 [YouGlish](https://youglish.com/pronounce/touch%20base/english/us) - 1000+ YouTube videos\n📜 [Etymonline](https://www.etymonline.com/word/touch) - Word origin",
+    "footer": "───────────────────\n📅 2026-02-20 | 📝 Take the quiz to earn XP!"
+  },
+  "audio": {
+    "enabled": true,
+    "narrator": "audio/2026-02-20/narrator.mp3",
+    "dialogue": []
+  },
+  "generated": true
+}

package/examples/sample_keypoint_b2.json

@@ -0,0 +1,137 @@
+{
+  "_meta": {
+    "prompt_version": "keypoint_gen_v2.1"
+  },
+  "date": "2026-02-25",
+  "topic_fingerprint": "workplace_circle_back",
+  "category": "oral",
+  "topic": "workplace",
+  "scene": {
+    "context": "You're in a meeting and need to postpone a discussion. This corporate idiom is essential for professional communication in American business culture.",
+    "formality": "neutral"
+  },
+  "expressions": [
+    {
+      "phrase": "Let's circle back on this",
+      "pronunciation_tip": "Natural: 'lets-circle-back-on-this'. The 'le' in circle is often dropped: 'cir-cle-back' → 'sur-kull-back'.",
+      "usage_note": "Use when you want to return to a topic later. Very common in meetings when time is limited or more research is needed."
+    },
+    {
+      "phrase": "I'll loop you in",
+      "pronunciation_tip": "'loop-you-in' flows together smoothly",
+      "usage_note": "Use when you'll include someone in future communication about a topic."
+    }
+  ],
+  "alternatives": [
+    "Let's revisit this later",
+    "Let's table this for now",
+    "We can follow up on this",
+    "Let's take this offline"
+  ],
+  "chinglish_trap": {
+    "wrong": "Let's discuss again later / Let's talk about this again",
+    "correct": "Let's circle back on this",
+    "explanation": "'Discuss again' sounds mechanical and direct. Americans prefer the spatial metaphor 'circle back' (returning to a point) which sounds more natural in corporate settings. It implies a planned return rather than just repeating."
+  },
+  "examples": [
+    {
+      "situation": "Running out of meeting time",
+      "dialogue": [
+        "A: We've spent 20 minutes on the budget. We still have three more items.",
+        "B: Good point. Let's circle back on the budget after we cover the other items.",
+        "A: Sounds good. Moving on to the marketing plan..."
+      ]
+    },
+    {
+      "situation": "Need more information",
+      "dialogue": [
+        "A: Should we increase the ad spend for Q4?",
+        "B: I don't have the ROI data yet. Can we circle back on this tomorrow?",
+        "A: Absolutely. I'll loop you in once I get the numbers from analytics."
+      ]
+    }
+  ],
+  "extended_learning": {
+    "related_phrases": [
+      "touch base - quick check-in",
+      "loop in - include someone",
+      "keep in the loop - keep someone informed",
+      "reach out - contact someone"
+    ],
+    "cultural_note": "Corporate jargon often uses spatial metaphors (circle back, touch base, loop in). These originated from baseball and navigation but are now standard business language. Using them correctly signals you're familiar with American corporate culture.",
+    "common_mistakes": [
+      "Saying 'circle around' instead of 'circle back'",
+      "Using it too often - it can sound evasive if overused",
+      "Not actually following up - only say it if you mean to return to the topic"
+    ]
+  },
+  "references": {
+    "dictionary": {
+      "source": "merriam-webster",
+      "url": "https://www.merriam-webster.com/dictionary/circle%20back",
+      "note": "Definition and business usage"
+    },
+    "usage_context": {
+      "source": "youglish",
+      "url": "https://youglish.com/pronounce/circle%20back/english/us",
+      "note": "Hear it in real business meetings"
+    },
+    "etymology": {
+      "source": "corporate-lingo",
+      "url": "https://www.linkedin.com/pulse/origins-corporate-jargon/",
+      "note": "Originated in 1990s corporate America"
+    }
+  },
+  "display": {
+    "title": "🏢 今日知识点 | Today's Knowledge Point",
+    "topic_tag": "🏷️ 主题: 职场口语 | Workplace Oral",
+    "formality_tag": "📊 正式度: 中性 | Neutral",
+    "scene_intro": "🎬 场景 | Scene",
+    "scene_text": "Postponing a discussion in a meeting - essential corporate idiom",
+    "expressions_title": "💬 核心表达 | Key Expressions",
+    "expressions_formatted": [
+      {
+        "emoji": "✨",
+        "phrase": "**Let's circle back on this**",
+        "phrase_plain": "Let's circle back on this",
+        "pronunciation": "🔊 'sur-kull-back' - 'le' often dropped",
+        "usage": "💡 Return to a topic later. Very common in meetings."
+      },
+      {
+        "emoji": "✨",
+        "phrase": "**I'll loop you in**",
+        "phrase_plain": "I'll loop you in",
+        "pronunciation": "🔊 'loop-you-in' - flows together",
+        "usage": "💡 Include someone in future communication."
+      }
+    ],
+    "alternatives_title": "🔄 其他说法 | Alternatives",
+    "alternatives_formatted": "• **Let's revisit this later**\n• **Let's table this for now**\n• **We can follow up on this**\n• **Let's take this offline**",
+    "chinglish_title": "⚠️ Chinglish 陷阱 | Chinglish Trap",
+    "chinglish_formatted": "❌ Wrong: \"Let's **discuss again later**\"\n✅ Correct: **Let's circle back on this!**\n\n📝 'Discuss again' sounds mechanical. **Circle back** uses a spatial metaphor that sounds natural in American corporate culture.",
+    "examples_title": "🗣️ 对话示例 | Example Dialogues",
+    "examples_formatted": [
+      {
+        "situation_emoji": "⏰",
+        "situation": "Running out of meeting time",
+        "dialogue": "💬 A: We've spent 20 minutes on budget.\n💬 B: **Let's circle back** after other items.\n💬 A: Sounds good. Moving on...",
+        "key_phrase_highlight": "**circle back**"
+      },
+      {
+        "situation_emoji": "📊",
+        "situation": "Need more information",
+        "dialogue": "💬 A: Should we increase ad spend?\n💬 B: **Can we circle back** tomorrow? I need ROI data.\n💬 A: Absolutely. **I'll loop you in** once I get numbers.",
+        "key_phrase_highlight": "**circle back / loop you in**"
+      }
+    ],
+    "extended_title": "📚 延伸学习 | Extended Learning",
+    "extended_formatted": "🔗 Related: **touch base** | **loop in** | **keep in the loop** | **reach out**\n\n🌎 Cultural Note: Corporate jargon uses spatial metaphors (circle back, touch base, loop in). Using them correctly signals familiarity with American corporate culture.\n\n🚫 Common Mistakes:\n  • 'Circle around' ❌ (should be 'back')\n  • Overusing it (can sound evasive)\n  • Not actually following up",
+    "references_title": "📖 权威参考 | References",
+    "references_formatted": "📚 [Merriam-Webster](https://www.merriam-webster.com/dictionary/circle%20back) - Definition\n🎬 [YouGlish](https://youglish.com/pronounce/circle%20back/english/us) - Real meetings\n📜 [Corporate Lingo](https://www.linkedin.com/pulse/origins-corporate-jargon/) - Origins",
+    "footer": "───────────────────\n📅 2026-02-25 | 📝 Take the quiz to earn XP!"
+  },
+  "audio": {
+    "enabled": true
+  },
+  "generated": true
+}

package/examples/sample_keypoint_c1.json

@@ -0,0 +1,134 @@
+{
+  "_meta": {
+    "prompt_version": "keypoint_gen_v2.1"
+  },
+  "date": "2026-02-25",
+  "topic_fingerprint": "workplace_take_offline",
+  "category": "oral",
+  "topic": "workplace",
+  "scene": {
+    "context": "You're in a meeting with multiple stakeholders and a sensitive or detailed topic comes up that's better discussed privately. This is a diplomatic way to redirect the conversation.",
+    "formality": "neutral"
+  },
+  "expressions": [
+    {
+      "phrase": "Let's take this offline",
+      "pronunciation_tip": "Natural: 'lets-take-this-off-line'. Emphasis on 'offline'.",
+      "usage_note": "Use when a discussion is getting too detailed, sensitive, or off-topic for the current meeting. It's a polite way to say 'let's discuss this privately later'."
+    },
+    {
+      "phrase": "We're spinning our wheels",
+      "pronunciation_tip": "'spinning-our-wheels' - all words connect smoothly",
+      "usage_note": "Use when a discussion is unproductive and going in circles. Signals it's time to move on or change approach."
+    }
+  ],
+  "alternatives": [
+    "Let's continue this conversation separately",
+    "Let's set up a separate call for this",
+    "Let's park this for now",
+    "This might be better as a follow-up"
+  ],
+  "chinglish_trap": {
+    "wrong": "Let's talk privately / Let's discuss this in private later",
+    "correct": "Let's take this offline",
+    "explanation": "'Talk privately' can sound exclusionary or secretive in a group setting. 'Take offline' is the standard corporate euphemism that sounds professional and inclusive while still redirecting. It implies efficiency, not secrecy."
+  },
+  "examples": [
+    {
+      "situation": "Sensitive HR issue in team meeting",
+      "dialogue": [
+        "A: I think the problem is that some team members aren't pulling their weight...",
+        "B: (interrupting) This might be getting into specifics that are better discussed separately. Let's take this offline and focus on the process improvements.",
+        "A: Fair point. So about the new workflow..."
+      ]
+    },
+    {
+      "situation": "Technical deep-dive in stakeholder meeting",
+      "dialogue": [
+        "A: The API latency is caused by the database connection pooling which—",
+        "B: We're spinning our wheels on technical details here. The stakeholders don't need this level of detail. Let's take this offline with just the engineering team.",
+        "A: You're right. Moving on to the timeline..."
+      ]
+    }
+  ],
+  "extended_learning": {
+    "related_phrases": [
+      "take it offline - discuss privately",
+      "parking lot - table a topic for later",
+      "side bar - quick private discussion",
+      "back-channel - informal communication"
+    ],
+    "cultural_note": "American corporate culture values meeting efficiency. 'Take offline' originated from the idea of taking a conversation 'off the main line' (like a railway siding). It's considered diplomatic because it doesn't shut down the topic—just redirects it appropriately.",
+    "common_mistakes": [
+      "Using it to avoid difficult conversations entirely",
+      "Saying it in a way that embarrasses the person speaking",
+      "Not following up on the offline discussion",
+      "Using it too casually with clients (can seem dismissive)"
+    ],
+    "nuance": "'Spinning our wheels' comes from car imagery—when wheels spin in mud/snow without moving forward. Use it when discussion is unproductive, not when you simply disagree."
+  },
+  "references": {
+    "dictionary": {
+      "source": "merriam-webster",
+      "url": "https://www.merriam-webster.com/dictionary/off-line",
+      "note": "Definition of 'offline' in business context"
+    },
+    "usage_context": {
+      "source": "youglish",
+      "url": "https://youglish.com/pronounce/take%20this%20offline/english/us",
+      "note": "Hear it in real business contexts"
+    }
+  },
+  "display": {
+    "title": "🏢 今日知识点 | Today's Knowledge Point",
+    "topic_tag": "🏷️ 主题: 职场口语 | Workplace Oral",
+    "formality_tag": "📊 正式度: 中性 | Neutral",
+    "scene_intro": "🎬 场景 | Scene",
+    "scene_text": "Redirecting sensitive or detailed discussions in meetings",
+    "expressions_title": "💬 核心表达 | Key Expressions",
+    "expressions_formatted": [
+      {
+        "emoji": "✨",
+        "phrase": "**Let's take this offline**",
+        "phrase_plain": "Let's take this offline",
+        "pronunciation": "🔊 'lets-take-this-off-line' - emphasis on 'offline'",
+        "usage": "💡 Discuss privately later. Polite redirect in meetings."
+      },
+      {
+        "emoji": "✨",
+        "phrase": "**We're spinning our wheels**",
+        "phrase_plain": "We're spinning our wheels",
+        "pronunciation": "🔊 'spinning-our-wheels' - all connect",
+        "usage": "💡 Discussion is unproductive. Time to move on."
+      }
+    ],
+    "alternatives_title": "🔄 其他说法 | Alternatives",
+    "alternatives_formatted": "• **Let's continue this separately**\n• **Let's set up a separate call**\n• **Let's park this for now**\n• **This might be better as a follow-up**",
+    "chinglish_title": "⚠️ Chinglish 陷阱 | Chinglish Trap",
+    "chinglish_formatted": "❌ Wrong: \"Let's **talk privately**\"\n✅ Correct: **Let's take this offline!**\n\n📝 'Talk privately' sounds secretive or exclusionary. **Take offline** is the professional euphemism that sounds efficient, not secretive.",
+    "examples_title": "🗣️ 对话示例 | Example Dialogues",
+    "examples_formatted": [
+      {
+        "situation_emoji": "🔒",
+        "situation": "Sensitive HR issue",
+        "dialogue": "💬 A: Some team members aren't pulling their weight...\n💬 B: **Let's take this offline** and focus on process.\n💬 A: Fair point. About the workflow...",
+        "key_phrase_highlight": "**take this offline**"
+      },
+      {
+        "situation_emoji": "⚙️",
+        "situation": "Technical deep-dive",
+        "dialogue": "💬 A: The API latency is caused by—\n💬 B: **We're spinning our wheels** on details. **Let's take this offline** with just engineering.\n💬 A: You're right. Moving to timeline...",
+        "key_phrase_highlight": "**spinning our wheels / take offline**"
+      }
+    ],
+    "extended_title": "📚 延伸学习 | Extended Learning",
+    "extended_formatted": "🔗 Related: **parking lot** | **side bar** | **back-channel**\n\n🌎 Cultural Note: 'Take offline' = 'off the main line' (railway metaphor). Signals efficiency, not secrecy.\n\n🚫 Common Mistakes:\n  • Using it to avoid difficult conversations\n  • Embarrassing the speaker\n  • Not following up\n\n💡 Nuance: 'Spinning wheels' = car in mud, going nowhere. Use for unproductive discussions.",
+    "references_title": "📖 权威参考 | References",
+    "references_formatted": "📚 [Merriam-Webster](https://www.merriam-webster.com/dictionary/off-line) - Definition\n🎬 [YouGlish](https://youglish.com/pronounce/take%20this%20offline/english/us) - Real usage",
+    "footer": "───────────────────\n📅 2026-02-25 | 📝 Take the quiz to earn XP!"
+  },
+  "audio": {
+    "enabled": true
+  },
+  "generated": true
+}

package/examples/sample_keypoint_c2.json

@@ -0,0 +1,141 @@
+{
+  "_meta": {
+    "prompt_version": "keypoint_gen_v2.1"
+  },
+  "date": "2026-02-25",
+  "topic_fingerprint": "workplace_boil_the_ocean",
+  "category": "oral",
+  "topic": "workplace",
+  "scene": {
+    "context": "You're in a strategic planning session or executive meeting. Someone proposes an overly ambitious scope. This idiom elegantly pushes back while sounding experienced and pragmatic.",
+    "formality": "formal"
+  },
+  "expressions": [
+    {
+      "phrase": "Let's not boil the ocean",
+      "pronunciation_tip": "'lets-not-boil-the-o-shun' - 'ocean' flows into 'shun' sound",
+      "usage_note": "Use when someone proposes something impossibly ambitious. This idiom means 'let's not try to do everything at once.' It signals strategic thinking and scope management."
+    },
+    {
+      "phrase": "We need to socialize this",
+      "pronunciation_tip": "'so-shuh-lize-this' - verb form, not the social media meaning",
+      "usage_note": "Use when a decision or idea needs to be shared with stakeholders for input and buy-in before finalizing. Very common in corporate decision-making."
+    }
+  ],
+  "alternatives": [
+    "Let's not try to solve world hunger here",
+    "We should scope this down",
+    "Let's focus on what's achievable",
+    "This needs broader alignment"
+  ],
+  "chinglish_trap": {
+    "wrong": "Don't do too much / Let's not be too ambitious / This is too big",
+    "correct": "Let's not boil the ocean",
+    "explanation": "Direct translations like 'don't do too much' sound unsophisticated in executive settings. 'Boil the ocean' is the idiom that shows you understand corporate strategic language. It's a metaphor for attempting something impossible (boiling the entire ocean) that originated in management consulting."
+  },
+  "examples": [
+    {
+      "situation": "Overly ambitious project scope",
+      "dialogue": [
+        "A: For Phase 1, let's rebuild the entire platform, add AI capabilities, and enter three new markets.",
+        "B: I appreciate the ambition, but let's not boil the ocean. What's the minimum viable scope that still moves the needle?",
+        "A: Fair enough. If we just focus on the platform rebuild first...",
+        "B: That's more like it. And we should socialize this with the regional teams before locking it down."
+      ]
+    },
+    {
+      "situation": "Unrealistic timeline expectations",
+      "dialogue": [
+        "A: The CEO wants a complete digital transformation by Q2.",
+        "B: Q2? That's boiling the ocean. We need to push back with a realistic phased approach.",
+        "A: Should I prepare a presentation with the revised timeline?",
+        "B: Yes, but socialize it with the key stakeholders first. Get alignment before going to the board."
+      ]
+    }
+  ],
+  "extended_learning": {
+    "related_phrases": [
+      "move the needle - make meaningful progress",
+      "minimum viable - smallest workable version",
+      "low-hanging fruit - easy wins",
+      "nice-to-have vs must-have - prioritize features"
+    ],
+    "cultural_note": "'Boil the ocean' originated in management consulting (McKinsey, BCG) in the 1980s. It's now standard C-suite language. Using it correctly signals you think strategically and understand scope trade-offs. The idiom is particularly powerful because it's visual and slightly humorous while making a serious point.",
+    "common_mistakes": [
+      "Using it too casually - it's for strategic discussions, not daily tasks",
+      "Using it to dismiss all ambitious ideas (some ambition is good)",
+      "Not offering an alternative scope after using it",
+      "Confusing 'socialize' with 'discuss' - socialize implies getting buy-in"
+    ],
+    "nuance": "'Socialize this' is uniquely corporate. It means systematically sharing an idea with stakeholders to gather input and build consensus. It's more deliberate than just 'discussing'—it's a process. In contrast, 'boil the ocean' is about avoiding overreach."
+  },
+  "references": {
+    "dictionary": {
+      "source": "merriam-webster",
+      "url": "https://www.merriam-webster.com/dictionary/boil%20the%20ocean",
+      "note": "Definition of business idiom"
+    },
+    "usage_context": {
+      "source": "youglish",
+      "url": "https://youglish.com/pronounce/boil%20the%20ocean/english/us",
+      "note": "Hear it in executive contexts"
+    },
+    "etymology": {
+      "source": "hbr",
+      "url": "https://hbr.org/2019/01/consulting-lingo-explained",
+      "note": "Origin: 1980s management consulting"
+    }
+  },
+  "display": {
+    "title": "🏢 今日知识点 | Today's Knowledge Point",
+    "topic_tag": "🏷️ 主题: 职场高级 | Executive Workplace",
+    "formality_tag": "📊 正式度: 正式 | Formal",
+    "scene_intro": "🎬 场景 | Scene",
+    "scene_text": "Strategic planning or executive meeting - managing scope and expectations",
+    "expressions_title": "💬 核心表达 | Key Expressions",
+    "expressions_formatted": [
+      {
+        "emoji": "✨",
+        "phrase": "**Let's not boil the ocean**",
+        "phrase_plain": "Let's not boil the ocean",
+        "pronunciation": "🔊 'boil-the-o-shun' - ocean flows",
+        "usage": "💡 Don't be impossibly ambitious. Shows strategic thinking."
+      },
+      {
+        "emoji": "✨",
+        "phrase": "**We need to socialize this**",
+        "phrase_plain": "We need to socialize this",
+        "pronunciation": "🔊 'so-shuh-lize' - verb form",
+        "usage": "💡 Share with stakeholders for buy-in before deciding."
+      }
+    ],
+    "alternatives_title": "🔄 其他说法 | Alternatives",
+    "alternatives_formatted": "• **Let's scope this down**\n• **Let's focus on what's achievable**\n• **This needs broader alignment**\n• **What's the minimum viable scope?**",
+    "chinglish_title": "⚠️ Chinglish 陷阱 | Chinglish Trap",
+    "chinglish_formatted": "❌ Wrong: \"Don't do too much\" / \"This is too big\"\n✅ Correct: **Let's not boil the ocean!**\n\n📝 Direct translations sound unsophisticated. This idiom shows you understand C-suite language. Metaphor: attempting the impossible (boiling an entire ocean).",
+    "examples_title": "🗣️ 对话示例 | Example Dialogues",
+    "examples_formatted": [
+      {
+        "situation_emoji": "🎯",
+        "situation": "Overly ambitious scope",
+        "dialogue": "💬 A: Let's rebuild everything AND add AI AND enter 3 markets!\n💬 B: **Let's not boil the ocean.** What's the minimum viable scope?\n💬 A: Focus on platform first?\n💬 B: Better. **We should socialize this** with regional teams first.",
+        "key_phrase_highlight": "**boil the ocean / socialize**"
+      },
+      {
+        "situation_emoji": "⏱️",
+        "situation": "Unrealistic timeline",
+        "dialogue": "💬 A: CEO wants full digital transformation by Q2.\n💬 B: Q2? **That's boiling the ocean.** We need a phased approach.\n💬 A: Prepare revised timeline?\n💬 B: Yes, but **socialize it with stakeholders first.**",
+        "key_phrase_highlight": "**boiling the ocean / socialize**"
+      }
+    ],
+    "extended_title": "📚 延伸学习 | Extended Learning",
+    "extended_formatted": "🔗 Related: **move the needle** | **minimum viable** | **low-hanging fruit** | **nice-to-have vs must-have**\n\n🌎 Cultural Note: 'Boil the ocean' = 1980s consulting lingo (McKinsey, BCG). Now standard C-suite language. Using it signals strategic thinking.\n\n💡 Nuance: 'Socialize' ≠ just 'discuss'. It means systematically getting stakeholder buy-in.\n\n🚫 Common Mistakes:\n  • Using it for daily tasks (too casual)\n  • Dismissing ALL ambition (some is good)\n  • Not offering alternative scope",
+    "references_title": "📖 权威参考 | References",
+    "references_formatted": "📚 [Merriam-Webster](https://www.merriam-webster.com/dictionary/boil%20the%20ocean) - Definition\n🎬 [YouGlish](https://youglish.com/pronounce/boil%20the%20ocean/english/us) - Executive contexts\n📜 [HBR](https://hbr.org/2019/01/consulting-lingo-explained) - Origins",
+    "footer": "───────────────────\n📅 2026-02-25 | 📝 Take the quiz to earn XP!"
+  },
+  "audio": {
+    "enabled": true
+  },
+  "generated": true
+}

package/examples/sample_quiz_a1.json

@@ -0,0 +1,94 @@
+{
+  "_meta": {
+    "prompt_version": "quiz_gen_v1.2"
+  },
+  "quiz_date": "2026-02-25",
+  "cefr_level": "A1",
+  "keypoint_fingerprint": "daily_life_thank_you",
+  "questions": [
+    {
+      "id": 1,
+      "type": "multiple_choice",
+      "question": "What do you say when someone helps you?",
+      "context": "A cashier hands you your change at a store.",
+      "options": [
+        "A. Hello",
+        "B. Thank you",
+        "C. Goodbye",
+        "D. Sorry"
+      ],
+      "correct_answer": "B",
+      "explanation": "'Thank you' is what you say when someone helps you or gives you something. 'Hello' is for greeting, 'Goodbye' is for leaving, and 'Sorry' is for apologies.",
+      "xp_value": 10,
+      "display": {
+        "type_emoji": "🔤",
+        "type_name": "选择题 | Multiple Choice",
+        "question_formatted": "💬 What do you say when someone **helps you**?",
+        "context_formatted": "🏪 A cashier hands you your change.",
+        "options_formatted": [
+          "⬜ A. Hello",
+          "⬜ B. Thank you",
+          "⬜ C. Goodbye",
+          "⬜ D. Sorry"
+        ],
+        "hint": "💡 Think: what do you say when you get something?",
+        "correct_feedback": "✅ Correct! **'Thank you'** = 谢谢!",
+        "wrong_feedback": "❌ Not quite. When someone helps you, say **'Thank you'**!",
+        "xp_display": "💎 +10 XP"
+      }
+    },
+    {
+      "id": 2,
+      "type": "chinglish_fix",
+      "question": "Fix this sentence:",
+      "chinglish_sentence": "Thank you very many for your help!",
+      "correct_answer": "Thank you very much",
+      "explanation": "'Many' is for things you can count (many apples, many people). 'Much' is for amount or degree (very much). This is a very common mistake!",
+      "xp_value": 15,
+      "display": {
+        "type_emoji": "🔧",
+        "type_name": "Chinglish 修正 | Fix the Chinglish",
+        "question_formatted": "🔧 What's wrong with this sentence?",
+        "sentence_formatted": "📝 \"Thank you very **many** for your help!\"",
+        "hint": "💡 'Many' or 'Much' - which one for degree?",
+        "correct_feedback": "✅ Fixed! **'Thank you very much!'** sounds natural! 🎉",
+        "wrong_feedback": "❌ Use **'much'** not 'many' here. **'Thank you very much!'**",
+        "xp_display": "💎 +15 XP"
+      }
+    },
+    {
+      "id": 3,
+      "type": "fill_blank",
+      "question": "Complete the sentence:",
+      "context": "Your friend opens the door for you. You say: '___!'",
+      "word_bank": ["Thanks", "Hello", "Goodbye"],
+      "correct_answer": "Thanks",
+      "explanation": "'Thanks' is the casual short form of 'Thank you'. Use it with friends. 'Hello' is for greeting and 'Goodbye' is for leaving.",
+      "xp_value": 12,
+      "display": {
+        "type_emoji": "✏️",
+        "type_name": "填空题 | Fill in the Blank",
+        "question_formatted": "✏️ What do you say?",
+        "context_formatted": "🚪 Your friend opens the door for you. You say: '**___**!'",
+        "word_bank_formatted": "📦 Options: [ **Thanks** | Hello | Goodbye ]",
+        "hint": "💡 Which one means '谢谢'?",
+        "correct_feedback": "✅ Perfect! **'Thanks!'** is casual and friendly! 🎯",
+        "wrong_feedback": "❌ The answer was **'Thanks!'** - it means 谢谢!",
+        "xp_display": "💎 +12 XP"
+      }
+    }
+  ],
+  "total_xp": 37,
+  "passing_score": 70,
+  "display": {
+    "header": "📝 今日测验 | Daily Quiz",
+    "date": "📅 2026-02-25",
+    "difficulty": "📊 Level: **A1** (入门级)",
+    "topic": "🏷️ Topic: **Thank You**",
+    "instructions": "🎯 3道小题，答对2道就过关！3 questions, get 2 right to pass!",
+    "progress_bar": "⬜⬜⬜ 0/3 questions",
+    "xp_summary": "💎 Total XP: 37 | 🏆 Pass: 2/3 correct",
+    "footer": "───────────────────\n💪 Good luck! 加油! 🚀"
+  },
+  "generated": true
+}