AI generated first iteration

app/agent/modes/scribe.py

@@ -0,0 +1,73 @@
+"""Scribe Mode - Generates the post-stream markdown ledger."""
+
+import logging
+from datetime import datetime
+from app.llm.client import LLMClient
+
+logger = logging.getLogger(__name__)
+
+
+class ScribeMode:
+    """
+    Scribe - The chronicler of the stream's story.
+    
+    Purpose:
+    - Compiles session data into a markdown ledger
+    - Generates blog post seeds
+    - Identifies clip candidates
+    - Exports final summary document
+    
+    Policy:
+    - Activates at end of stream
+    - Reads data from Librarian, Warden, and repository
+    - Creates structured markdown output
+    - Organizes clips and blog topics
+    - Ready for post-processing or publishing
+    """
+
+    def __init__(self, llm_client: LLMClient):
+        """Initialize Scribe mode."""
+        self.llm_client = llm_client
+        self.ledger_entries: list[str] = []
+
+    async def add_entry(self, section: str, content: str) -> None:
+        """Add an entry to the ledger."""
+        self.ledger_entries.append(f"## {section}\n{content}")
+        logger.debug(f"Scribe recorded ledger entry: {section}")
+
+    async def compile_ledger(
+        self,
+        theme: str,
+        discussion_points: list[str],
+        agent_actions: list[str],
+        clip_candidates: list[str],
+        blog_seeds: list[str],
+    ) -> str:
+        """Compile all data into a markdown ledger."""
+        date = datetime.utcnow().strftime("%Y-%m-%d")
+        
+        ledger = f"# Sanctum Ledger — {date}\n\n"
+        ledger += f"## Stream Theme\n{theme}\n\n"
+        ledger += f"## Notable Discussion\n"
+        for point in discussion_points:
+            ledger += f"- {point}\n"
+        ledger += "\n"
+        ledger += f"## Agent Actions\n"
+        for action in agent_actions:
+            ledger += f"- {action}\n"
+        ledger += "\n"
+        ledger += f"## Clip Candidates\n"
+        for clip in clip_candidates:
+            ledger += f"- {clip}\n"
+        ledger += "\n"
+        ledger += f"## Blog Seeds\n"
+        for seed in blog_seeds:
+            ledger += f"- {seed}\n"
+        
+        logger.info("Scribe compiled stream ledger")
+        return ledger
+
+    async def export_ledger(self, filename: str, content: str) -> None:
+        """Export ledger to file."""
+        # Actual export handled by MarkdownExporter
+        logger.info(f"Scribe prepared ledger for export: {filename}")