Fresh start - excluded large ROM JSON files

2026-04-11 09:45:12 -05:00
commit 5deb387aa6
395 changed files with 47744 additions and 0 deletions
--- a/docs/CRON_REPORT_TEMPLATE.md
+++ b/docs/CRON_REPORT_TEMPLATE.md
@@ -0,0 +1,171 @@
+# Cron Job Report Template — Bullet Style
+
+Use this format for all cron job reports that deliver to Discord.
+
+---
+
+## Standard Header
+
+```
+## 🤖 [Job Name] Report — [Day, Month Date, Year]
+
+**Check Time:** [Time] CT
+```
+
+---
+
+## For Each Item Being Reported
+
+### Success Format:
+```
+✅ **[Item Name]** — SUCCESS
+• [Detail 1]: [Value]
+• [Detail 2]: [Value]  
+• [Detail 3]: [Value]
+```
+
+### Failure Format:
+```
+❌ **[Item Name]** — FAILED
+• [Detail 1]: [Value]
+• Error: [Specific error message]
+• Action Needed: [What to do]
+```
+
+### Warning Format:
+```
+⚠️ **[Item Name]** — WARNING
+• [Detail 1]: [Value]
+• Issue: [Description]
+• Suggested: [Recommendation]
+```
+
+### Missed/Skipped Format:
+```
+⏸️ **[Item Name]** — MISSED
+• Scheduled: [Time]
+• Reason: [Why it didn't run]
+• Next: [Next scheduled time]
+```
+
+---
+
+## Summary Footer
+
+```
+---
+
+**Summary:** [One line overview]
+**Status:** [All clear / Attention required / X issues found]
+**Next Check:** [When this runs again]
+```
+
+---
+
+## Examples
+
+### Example 1: Job Verifier (Multiple Jobs)
+```
+## 🤖 Overnight Job Report — Wednesday, February 18, 2026
+
+**Check Time:** 9:00 AM CT
+
+✅ **Supermemory Backup** — SUCCESS
+• Ran: 2:00 AM CT • Duration: 19.5s
+• Document ID: sDny6ZVrdattvKjounQxRp
+• Next: Tonight at 2:00 AM
+
+✅ **Memory Worker Daily** — SUCCESS
+• Ran: 3:01 AM CT • Duration: 44s
+• Processed: 11KB daily notes
+• Next: Tomorrow at 3:00 AM
+
+✅ **Daily Cron Cleanup** — SUCCESS
+• Ran: 3:00 AM CT • Duration: 82s
+• Result: No cleanup needed (5 active jobs)
+• Next: Tomorrow at 3:00 AM
+
+✅ **Daily News Brief** — SUCCESS
+• Ran: 8:00 AM CT • Duration: 108s
+• Delivered: ~1,150 chars to #news-brief
+• Next: Tomorrow at 8:00 AM
+
+---
+
+**Summary:** All 4 overnight jobs completed successfully.
+**Status:** All systems green 🟢
+**Next Check:** Tomorrow 9:00 AM CT
+```
+
+### Example 2: Single Task Report (Backup)
+```
+## 🤖 Supermemory Backup Report — Wednesday, February 18, 2026
+
+✅ **Backup Job** — SUCCESS
+• Ran: 2:00 AM CT • Duration: 19.5s
+• Document ID: sDny6ZVrdattvKjounQxRp
+• Status: Queued for cloud processing
+• Last Backup: 24 hours ago
+
+---
+
+**Summary:** Backup completed and queued for Supermemory sync.
+**Status:** All clear ✅
+**Next Run:** Tonight at 2:00 AM CT
+```
+
+### Example 3: With Failures
+```
+## 🤖 System Check Report — Wednesday, February 18, 2026
+
+✅ **Home Assistant** — SUCCESS
+• Status: Online • Response: 45ms
+• Last seen: Just now
+
+❌ **Frigate NVR** — FAILED
+• Status: Offline • Last seen: 3 hours ago
+• Error: Connection timeout to port 5000
+• Action Needed: Check if Frigate container is running
+
+⚠️ **Nextcloud** — WARNING
+• Status: Online • Response: 8.2s (slow)
+• Issue: Response time degraded
+• Suggested: Check server load
+
+---
+
+**Summary:** 1 failure and 1 warning require attention.
+**Status:** Attention required ⚠️
+**Next Check:** In 6 hours
+```
+
+---
+
+## Key Rules
+
+1. **Use bullet: •** (not - or *)
+2. **One line per detail**
+3. **Always include timestamps**
+4. **Duration when applicable**
+5. **Next run time if relevant**
+6. **Summary line at end**
+7. **Keep under 2000 characters** (Discord limit)
+
+---
+
+## Status Icons Reference
+
+| Icon | Meaning | Use When |
+|------|---------|----------|
+| ✅ | Success | Job/task completed as expected |
+| ❌ | Failed | Error occurred, manual intervention needed |
+| ⚠️ | Warning | Succeeded but with issues or degraded performance |
+| ⏸️ | Missed/Skipped | Didn't run (not an error, just didn't trigger) |
+| 🔄 | In Progress | Currently running, check back later |
+| 📊 | Stats/Info | Purely informational, no action needed |
+
+---
+
+*Template Version: 1.0*
+*Created: 2026-02-18*
+*Applies to: All cron job reports to Discord*