Add content-goal radio and a dedicated generated-images section

- New single-select "Content goal" radio (Informational, Persuasive,
Authoritative, Thought Leadership) threaded through generate() ->
orchestrator.run() -> writer.write_post(); each goal injects a distinct
stance/tone directive into the writing prompt. Included in the cache key.
- UI: move the image gallery into its own full-width "Generated images"
section (3 columns, larger, click-to-preview) so all generated images are
shown prominently in the Space.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

app.py

@@ -11,7 +11,7 @@ import traceback
 
 import gradio as gr
 
-from pipeline import config, orchestrator
+from pipeline import config, orchestrator, writer
 
 INTRO = """
 # 📝 Blog Post Generator
@@ -40,7 +40,8 @@ def _preview(markdown: str, images: list) -> str:
     return re.sub(r"\[IMAGE:\s*.+?\]", repl, markdown, flags=re.DOTALL)
 
 
-def generate(topic, primary, secondary, brief, target_wordcount, hf_token, progress=gr.Progress()):
+def generate(topic, primary, secondary, brief, target_wordcount, content_goal, hf_token,
+             progress=gr.Progress()):
     log_lines = []
     gallery, docx_file, preview = [], None, ""
 
@@ -49,7 +50,7 @@ def generate(topic, primary, secondary, brief, target_wordcount, hf_token, progr
 
     try:
         for frac, message, result in orchestrator.run(
-            hf_token, topic, primary, secondary, brief, target_wordcount
+            hf_token, topic, primary, secondary, brief, target_wordcount, content_goal
         ):
             progress(frac, desc=message)
             log_lines.append(message)
@@ -93,6 +94,12 @@ def build_ui() -> gr.Blocks:
                     step=100,
                     precision=0,
                 )
+                content_goal = gr.Radio(
+                    label="Content goal",
+                    choices=list(writer.GOAL_GUIDANCE.keys()),
+                    value=writer.DEFAULT_GOAL,
+                    info="Shapes the article's stance and tone.",
+                )
                 hf_token = gr.Textbox(
                     label="Hugging Face token (billed to you)",
                     type="password",
@@ -102,12 +109,23 @@ def build_ui() -> gr.Blocks:
             with gr.Column(scale=2):
                 status_box = gr.Markdown(label="Progress")
                 docx_out = gr.File(label="Download .docx")
-                gallery = gr.Gallery(label="Generated images", columns=2, height=320)
                 preview = gr.Markdown(label="Preview")
 
+        # Dedicated full-width section showing every generated image with its caption.
+        gr.Markdown("## 🖼️ Generated images")
+        gallery = gr.Gallery(
+            label="Generated images",
+            show_label=False,
+            columns=3,
+            height=560,
+            object_fit="contain",
+            preview=False,
+            allow_preview=True,
+        )
+
         run_btn.click(
             fn=generate,
-            inputs=[topic, primary, secondary, brief, target_wc, hf_token],
+            inputs=[topic, primary, secondary, brief, target_wc, content_goal, hf_token],
             outputs=[status_box, preview, gallery, docx_out],
         )
         gr.Markdown(

pipeline/orchestrator.py

@@ -30,6 +30,7 @@ def run(
     secondary_keyword: str,
     brief: str,
     target_wordcount: int = config.DEFAULT_WORD_COUNT,
+    content_goal: str = writer.DEFAULT_GOAL,
 ) -> Iterator[Tuple[float, str, dict]]:
     if not topic.strip():
         raise ValueError("Please enter a topic.")
@@ -40,8 +41,12 @@ def run(
     except (TypeError, ValueError):
         target_wordcount = config.DEFAULT_WORD_COUNT
     target_wordcount = max(300, min(target_wordcount, 5000))
+    if content_goal not in writer.GOAL_GUIDANCE:
+        content_goal = writer.DEFAULT_GOAL
 
-    key = cache.run_key(topic, primary_keyword, secondary_keyword, brief, str(target_wordcount))
+    key = cache.run_key(
+        topic, primary_keyword, secondary_keyword, brief, str(target_wordcount), content_goal
+    )
     run_dir = config.OUT_DIR / key
     run_dir.mkdir(parents=True, exist_ok=True)
     result: dict = {"key": key}
@@ -79,10 +84,10 @@ def run(
     result["sources"] = [{k: v for k, v in s.items() if k != "text"} for s in sources]
 
     # 5) write the post
-    yield 0.55, f"Writing the ~{target_wordcount}-word blog post…", result
+    yield 0.55, f"Writing the ~{target_wordcount}-word {content_goal} blog post…", result
     markdown = writer.write_post(
         client, topic, primary_keyword, secondary_keyword, brief, sources,
-        target_wordcount=target_wordcount,
+        target_wordcount=target_wordcount, content_goal=content_goal,
     )
     (run_dir / "post.md").write_text(markdown, encoding="utf-8")
     result["markdown"] = markdown

pipeline/writer.py

@@ -14,12 +14,45 @@ from huggingface_hub import InferenceClient
 from . import config, llm
 from .aeo_guidelines import AEO_GUIDELINES
 
-
-def _build_system(target_wordcount: int) -> str:
+# Content-goal directives shape the post's stance and tone. One is selected in the UI.
+GOAL_GUIDANCE = {
+    "Informational": (
+        "Content goal: INFORMATIONAL. Prioritize clear, objective, comprehensive "
+        "explanation. Teach the reader, define terms, stay neutral and factual, and favor "
+        "accuracy and completeness over opinion or salesmanship."
+    ),
+    "Persuasive": (
+        "Content goal: PERSUASIVE. Build a convincing case for a clear position or action. "
+        "Lead with benefits, address likely objections and counterpoints, support claims "
+        "with concrete evidence and examples, and close with a motivating call to action — "
+        "without overstating or making unsupported claims."
+    ),
+    "Authoritative": (
+        "Content goal: AUTHORITATIVE. Write as the definitive reference on the topic. Be "
+        "precise and thorough, back every key claim with specific evidence, data or primary "
+        "sources, cover edge cases and limitations, and use a confident expert tone that "
+        "earns citation and trust."
+    ),
+    "Thought Leadership": (
+        "Content goal: THOUGHT LEADERSHIP. Offer an original, forward-looking perspective. "
+        "Frame the topic within broader industry trends, share a distinctive point of view "
+        "or informed prediction, challenge conventional assumptions where warranted, and "
+        "support opinions with clear reasoning and evidence."
+    ),
+}
+DEFAULT_GOAL = "Informational"
+
+
+def _goal_directive(content_goal: str) -> str:
+    return GOAL_GUIDANCE.get(content_goal, GOAL_GUIDANCE[DEFAULT_GOAL])
+
+
+def _build_system(target_wordcount: int, content_goal: str) -> str:
     return (
         "You are an expert blog writer and SEO/AEO editor. Using ONLY the supplied source "
         "material as factual grounding, write an original, engaging, well-structured blog "
         "post. Do not copy sentences verbatim from the sources; synthesize in your own voice.\n\n"
+        f"{_goal_directive(content_goal)}\n\n"
         "Structural requirements:\n"
         "- Start with a single '# ' H1 title that includes the primary keyword.\n"
         "- Use the primary keyword naturally in the first 100 words and in at least one '## ' heading.\n"
@@ -46,25 +79,28 @@ def write_post(
     brief: str,
     sources: List[dict],
     target_wordcount: int = config.DEFAULT_WORD_COUNT,
+    content_goal: str = DEFAULT_GOAL,
 ) -> str:
     source_block = _format_sources(sources)
     user = (
         f"Topic: {topic}\n"
         f"Primary keyword: {primary_keyword}\n"
         f"Secondary keyword: {secondary_keyword}\n"
+        f"Content goal: {content_goal}\n"
         f"Target word count: {target_wordcount}\n"
         f"Brief: {brief}\n\n"
         f"SOURCE MATERIAL (ranked by domain authority):\n{source_block}\n\n"
-        f"Write the full ~{target_wordcount}-word blog post in Markdown now, following the "
-        "AI-citation guidelines (direct answer up top, question-style headings, a comparison/"
-        "feature table, an FAQ, cited sources, stated limitations)."
+        f"Write the full ~{target_wordcount}-word blog post in Markdown now, matching the "
+        f"'{content_goal}' content goal and following the AI-citation guidelines (direct "
+        "answer up top, question-style headings, a comparison/feature table, an FAQ, cited "
+        "sources, stated limitations)."
     )
     # Allow enough output tokens for the requested length (~1.6 tokens/word + overhead).
     max_tokens = max(1500, min(int(target_wordcount * 2) + 600, 8000))
     md = llm.chat(
         client,
         config.MODEL_WRITER,
-        _build_system(target_wordcount),
+        _build_system(target_wordcount, content_goal),
         user,
         max_tokens=max_tokens,
         temperature=0.7,