/review-logs

Runs the Deus log review and rotation system at scripts/log_review.py.

Subcommands

Run the appropriate command based on what the user asks for:

User intent	Command
Full run / daily review / "what's wrong"	python3 scripts/log_review.py
See last report / summary	python3 scripts/log_review.py --summary
See pinned / flagged issues	python3 scripts/log_review.py --pinned
Clean up old logs / rotate	python3 scripts/log_review.py --rotate-only
Re-analyze without rotating	python3 scripts/log_review.py --review-only

If invoked with no further context, run the full review (python3 scripts/log_review.py).

What each mode does

Full run (default):

1. Deletes container logs older than LOG_CONTAINER_RETENTION_DAYS (default: 14 days)
2. Archives logs/deus.log / logs/deus.error.log to logs/archives/ if they exceed LOG_MAIN_MAX_MB (default: 20 MB) and truncates them
3. Reads new log entries since the last review (byte-offset tracked — never re-reads old entries)
4. Scans new container session logs for errors
5. Sends collected warnings/errors to a local Ollama model (LOG_REVIEW_MODEL, default: gemma4:e4b) for structured health analysis
6. Saves daily report to ~/.deus/reviews/YYYY-MM-DD.md
7. Pins DEGRADED/CRITICAL reports to ~/.deus/reviews/pinned.md and fires a macOS notification

Health levels returned by Ollama:

• OK — no actionable issues
• DEGRADED — issues present, not urgent
• CRITICAL — needs immediate attention, gets pinned

Output interpretation

After running, explain the health report to the user:

• Summarize the Issues Found section in plain language
• For each Action Required item, explain what it means and how to fix it
• If health is OK, confirm the system is running cleanly
• If issues are pinned, tell the user they can run deus logs pinned anytime to review them

Environment overrides

Variable	Default	Effect
LOG_REVIEW_MODEL	gemma4:e4b	Ollama model for analysis
OLLAMA_HOST	http://localhost:11434	Ollama server URL
LOG_CONTAINER_RETENTION_DAYS	14	Days before container logs are deleted
LOG_MAIN_MAX_MB	20	Main log size threshold for archiving
LOG_ARCHIVE_RETENTION_DAYS	30	Days before archived logs are deleted

Scheduling

The review runs automatically every day at 08:00 via a launchd job (com.deus.log-review). To check if it's registered: launchctl list | grep log-review To install it manually (macOS): launchctl load ~/Library/LaunchAgents/com.deus.log-review.plist