feat: matrix-hermes project structure and Matrix authentication

.env.example

@@ -0,0 +1,45 @@
+# Matrix-Hermes Configuration
+# Copy this to .env and fill in your Matrix server details
+
+# Required: your Matrix homeserver URL
+MATRIX_HOMESERVER=https://matrix.org
+
+# Option A: Use an existing access token (preferred)
+# Get this from Element Web: Settings → Help & About → Access Token
+# Or use `matrix-hermes login` to generate one
+MATRIX_ACCESS_TOKEN=
+
+# Option B: Login with password (token auto-saved to ~/.hermes/matrix_sessions/)
+# MATRIX_USER_ID=@hermes:matrix.org
+# MATRIX_PASSWORD=your-password-here
+
+# --- Optional settings ---
+
+# Stable device ID for E2EE persistence across restarts
+# MATRIX_DEVICE_ID=
+
+# Enable end-to-end encryption (requires mautrix[encryption])
+# MATRIX_ENCRYPTION=false
+
+# HTTP(S) proxy for Matrix traffic
+# MATRIX_PROXY=
+
+# Directory for E2EE key storage
+# MATRIX_STORE_DIR=
+
+# Directory for session token persistence (default: ~/.hermes/matrix_sessions)
+# MATRIX_SESSION_DIR=
+
+# --- Gateway-compatible settings ---
+
+# Comma-separated list of allowed Matrix user IDs
+# MATRIX_ALLOWED_USERS=@alice:matrix.org,@bob:matrix.org
+
+# Room ID for cron/notification delivery
+# MATRIX_HOME_ROOM=!abc123:matrix.org
+
+# Require @mention in rooms to trigger the bot
+# MATRIX_REQUIRE_MENTION=true
+
+# Auto-create threads for room messages
+# MATRIX_AUTO_THREAD=true