feat(memory): add daily journal support

Add journal write support across memory storage and manager layers,
including a tool wrapper for agent use.

Create or append to date-based journal files with timestamped entries
and frontmatter metadata for new files.

Also add helpers to load CORE memory and recent journal entries, and
expose the journal tool in the agent loop imports.

agent/agent_loop.py

@@ -12,7 +12,7 @@ from tools.bash_tool import run_bash
 from tools.file_tools import run_read, run_write, run_edit
 from tools.code_executor import run_create_plugin
 from tools.browser_tool import run_browser
-from tools.memory_tools import run_remember, run_recall
+from tools.memory_tools import run_remember, run_recall, run_journal
 
 
 # Tool definitions sent to the API

memory/manager.py

@@ -59,3 +59,30 @@ class MemoryManager:
     async def list_memories(self, category: str | None = None) -> list[dict]:
         """List all stored memories with their metadata."""
         return await self.storage.list_memories(category)
+
+    async def journal(self, content: str) -> str:
+        """Write a journal entry to today's daily journal file.
+
+        Args:
+            content: The journal entry content.
+
+        Returns:
+            Confirmation message with the file path.
+        """
+        path = await self.storage.journal(content)
+        return f"Journal entry added to {path}"
+
+    async def load_critical(self) -> str:
+        """Load critical memories (CORE.md)."""
+        return await self.storage.load_core()
+
+    async def load_recent_journal(self, days: int = 3) -> str:
+        """Load recent journal entries.
+
+        Args:
+            days: Number of days to look back.
+
+        Returns:
+            Combined journal entries.
+        """
+        return await self.storage.load_recent_journal(days)

memory/storage.py

@@ -155,3 +155,61 @@ class MemoryStorage:
             fm = {}
         body = parts[2].strip()
         return fm, body
+
+    async def journal(self, content: str) -> Path:
+        """Write a journal entry to today's daily journal file.
+
+        Args:
+            content: The journal entry content.
+
+        Returns:
+            The path to the journal file.
+        """
+        journal_dir = self.base_path / "journal"
+        journal_dir.mkdir(parents=True, exist_ok=True)
+
+        today = datetime.now().strftime("%Y-%m-%d")
+        journal_path = journal_dir / f"{today}.md"
+
+        # Append to existing journal or create new one
+        timestamp = datetime.now().strftime("%H:%M:%S")
+        entry = f"\n\n## {timestamp}\n\n{content}\n"
+
+        if journal_path.exists():
+            async with aiofiles.open(journal_path, "a", encoding="utf-8") as f:
+                await f.write(entry)
+        else:
+            frontmatter = {
+                "date": today,
+                "type": "journal",
+            }
+            text = self._format_with_frontmatter(frontmatter, f"# Journal - {today}\n{entry}")
+            async with aiofiles.open(journal_path, "w", encoding="utf-8") as f:
+                await f.write(text)
+
+        return journal_path
+
+    async def load_recent_journal(self, days: int = 3) -> str:
+        """Load recent journal entries.
+
+        Args:
+            days: Number of days to look back.
+
+        Returns:
+            Combined journal entries.
+        """
+        journal_dir = self.base_path / "journal"
+        if not journal_dir.exists():
+            return ""
+
+        from datetime import timedelta
+
+        parts = []
+        for i in range(days):
+            date = datetime.now() - timedelta(days=i)
+            journal_path = journal_dir / f"{date.strftime('%Y-%m-%d')}.md"
+            if journal_path.exists():
+                async with aiofiles.open(journal_path, "r", encoding="utf-8") as f:
+                    parts.append(await f.read())
+
+        return "\n\n---\n\n".join(parts)

tools/memory_tools.py

@@ -44,3 +44,16 @@ async def run_recall(query: str) -> str:
     """
     manager = _get_manager()
     return await manager.recall(query)
+
+
+async def run_journal(content: str) -> str:
+    """Write a journal entry to today's daily journal.
+
+    Args:
+        content: The journal entry content.
+
+    Returns:
+        Confirmation message.
+    """
+    manager = _get_manager()
+    return await manager.journal(content)