Update documentation and add architectural approach document

collab/audit/markwhen-installation-issue.md

@@ -0,0 +1,23 @@
+# Issue: Markwhen Installation Failure
+
+## Problem
+The Markwhen installation is failing during the Docker build process with the error:
+"failed to solve: process "/bin/sh -c npm install -g @markwhen/cli" did not complete successfully: exit code: 1"
+
+## Investigation Needed
+- Research the correct npm package name for Markwhen CLI
+- Determine if it should be installed from GitHub repository instead
+- Check if there are dependencies we're missing
+- Verify if the package exists under a different name
+
+## Possible Solutions
+1. Install from GitHub repository directly
+2. Use a different package name
+3. Build from source
+4. Check if Node.js version compatibility is an issue
+
+## Priority
+Medium - Markwhen is a useful tool for timeline generation but not critical for core functionality
+
+## Status
+Pending investigation