nexo-brain 5.3.19 → 5.3.21

package/templates/launchagents/README 2.md

@@ -0,0 +1,132 @@
+# NEXO LaunchAgent Templates
+
+macOS LaunchAgents that run NEXO's background processes automatically. These keep the system alive, consistent, and self-improving without any manual intervention.
+
+## What are LaunchAgents?
+
+LaunchAgents are macOS's native mechanism for running programs automatically per user session. They are XML property list (`.plist`) files stored in `~/Library/LaunchAgents/`. `launchd` reads them at login and keeps them running according to their schedule. Unlike cron, they survive sleep/wake cycles and can run at load, on a fixed interval, or at a specific calendar time.
+
+## Installation
+
+### 1. Set your paths
+
+All templates use two placeholders that you must replace before installing:
+
+| Placeholder | Replace with |
+|------------|-------------|
+| `{{NEXO_HOME}}` | Absolute path to your NEXO knowledge base directory (default: `~/.nexo` or `$NEXO_HOME`) |
+| `{{HOME}}` | Your home directory (e.g. `/Users/yourname` or `$HOME`) |
+
+Replace them in every file you want to install:
+
+```bash
+# Example — replace both placeholders in all files at once
+NEXO_HOME="$HOME/.nexo"
+HOME_DIR="$HOME"
+
+for f in *.plist; do
+  sed -i '' \
+    "s|{{NEXO_HOME}}|$NEXO_HOME|g; s|{{HOME}}|$HOME_DIR|g" \
+    "$f"
+done
+```
+
+### 2. Check the Python path
+
+Each plist calls `/usr/bin/python3`. If your Python 3 is elsewhere (e.g. Homebrew at `/opt/homebrew/bin/python3`), update the `ProgramArguments` first line accordingly.
+
+### 3. Create required directories
+
+The agents write logs to `{{NEXO_HOME}}/logs/` and `{{NEXO_HOME}}/coordination/`. Create them if they do not exist:
+
+```bash
+mkdir -p "$NEXO_HOME/logs" "$NEXO_HOME/coordination"
+```
+
+### 4. Copy and load
+
+```bash
+# Copy plists to LaunchAgents directory
+cp *.plist ~/Library/LaunchAgents/
+
+# Load each one
+for f in ~/Library/LaunchAgents/com.nexo.*.plist; do
+  launchctl load "$f"
+done
+```
+
+### Unloading
+
+```bash
+for f in ~/Library/LaunchAgents/com.nexo.*.plist; do
+  launchctl unload "$f"
+done
+```
+
+### Checking status
+
+```bash
+# List all loaded NEXO agents
+launchctl list | grep nexo
+
+# Check a specific one (exit code 0 = running or loaded OK)
+launchctl list com.nexo.watchdog
+```
+
+---
+
+## Agents
+
+### Essential
+
+These agents are required for NEXO to function correctly. Install all of them.
+
+| File | Schedule | What it does |
+|------|----------|-------------|
+| `com.nexo.auto-close-sessions.plist` | Every 5 min | Expires stale sessions (no heartbeat for 15+ min). Prevents ghost sessions from cluttering the startup menu. |
+| `com.nexo.watchdog.plist` | Every 30 min | Monitors that key services and cron jobs are alive. Writes `watchdog-status.json` and sets a flag when failures are detected. NEXO reads this at startup and alerts you before anything else. |
+| `com.nexo.catchup.plist` | At login | Processes overdue followups and missed scheduled jobs after reboot or sleep. Ensures no maintenance task is permanently skipped. |
+
+### Core background intelligence
+
+These agents power NEXO's learning and memory systems. Strongly recommended.
+
+| File | Schedule | What it does |
+|------|----------|-------------|
+| `com.nexo.deep-sleep.plist` | Daily 04:30 | Reads full session transcripts from the previous day and extracts learnings that were not captured during live sessions. NEXO's "REM sleep." |
+| `com.nexo.cognitive-decay.plist` | Daily 03:00 | Applies Ebbinghaus forgetting curve to the vector memory database. Reduces confidence scores for memories that have not been reinforced recently, keeping retrieval fresh and accurate. |
+| `com.nexo.synthesis.plist` | Every 2 hours | Aggregates recent session diaries, error patterns, and pending items into `coordination/daily-synthesis.md`. This file is read at every session startup. |
+| `com.nexo.postmortem.plist` | Daily 23:30 | Produces an end-of-day consolidated summary of decisions, changes, and errors. Feeds into the next morning's synthesis. |
+| `com.nexo.self-audit.plist` | Daily 07:00 | Audits the learning system health. Flags repeated errors, calculates the learning repetition rate, and alerts if it exceeds 30%. |
+| `com.nexo.immune.plist` | Every 30 min | Scans the knowledge base for internal contradictions and stale data. Prevents memory drift over time. |
+
+### Weekly maintenance
+
+| File | Schedule | What it does |
+|------|----------|-------------|
+| `com.nexo.evolution.plist` | Machine-staggered weekly (managed installs) | Reviews the week's patterns and proposes improvements to NEXO's own configuration. Managed installs spread each machine across the week to avoid PR spikes; the static plist template is only a manual fallback. |
+| `com.nexo.followup-hygiene.plist` | Sundays 05:00 | Cleans up stale followups and reminders. Archives long-pending items and deduplicates entries. Keeps the operational database noise-free. |
+
+### Optional
+
+| File | Schedule | What it does |
+|------|----------|-------------|
+| `com.nexo.dashboard.plist` | Persistent (KeepAlive) | Runs the NEXO web dashboard on `http://localhost:6174`. Provides a browser-based view of sessions, reminders, followups, and system health. Only needed if you want the dashboard UI. |
+
+---
+
+## Logs
+
+All agents write stdout and stderr to files under `{{NEXO_HOME}}/logs/` (or `{{NEXO_HOME}}/coordination/` for the session-related ones). Check these first when debugging:
+
+```bash
+tail -50 "$NEXO_HOME/logs/watchdog-stdout.log"
+tail -50 "$NEXO_HOME/logs/deep-sleep-stderr.log"
+```
+
+## Notes
+
+- All times are local machine time.
+- If the machine is off or sleeping when a scheduled time fires, `launchd` will NOT run the job retroactively — that is what `com.nexo.catchup` handles at the next login.
+- The `com.nexo.dashboard` agent uses `KeepAlive: true`, meaning macOS will restart it automatically if it exits. Unload it explicitly if you want to stop it.
+- Python path in the templates is `/usr/bin/python3` (macOS system Python). If your scripts require packages installed in a virtualenv or Homebrew Python, update the path to match (e.g. `/opt/homebrew/bin/python3`).

package/templates/launchagents/com.nexo.auto-close-sessions 2.plist

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- com.nexo.auto-close-sessions
+     Runs auto_close_sessions.py every 5 minutes to expire stale NEXO
+     sessions. Sessions are considered stale after 15 minutes of no
+     heartbeat activity. Closing them prevents ghost sessions from
+     appearing in the active sessions list at startup. Runs at load
+     so it is always active immediately after login.
+-->
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.nexo.auto-close-sessions</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/usr/bin/python3</string>
+        <string>{{NEXO_HOME}}/auto_close_sessions.py</string>
+    </array>
+    <key>StartInterval</key>
+    <integer>300</integer>
+    <key>StandardOutPath</key>
+    <string>{{NEXO_HOME}}/coordination/auto-close-stdout.log</string>
+    <key>StandardErrorPath</key>
+    <string>{{NEXO_HOME}}/coordination/auto-close-stderr.log</string>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:__NEXO_HOME__/bin</string>
+        <key>NEXO_SKIP_FS_INDEX</key>
+        <string>1</string>
+        <key>NEXO_HOME</key>
+        <string>{{NEXO_HOME}}</string>
+        <key>NEXO_CODE</key>
+        <string>{{NEXO_CODE}}</string>
+    </dict>
+</dict>
+</plist>

package/templates/launchagents/com.nexo.catchup 2.plist

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- com.nexo.catchup
+     Runs nexo-catchup.py at login and every 15 minutes so missed core
+     windows are recovered after boot, wake, or prolonged sleep.
+     Recovery is gated by cron_runs plus the manifest recovery contract,
+     so catchup only replays jobs that are safe and still inside their
+     allowed catch-up window.
+-->
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.nexo.catchup</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/usr/bin/python3</string>
+        <string>{{NEXO_HOME}}/scripts/nexo-catchup.py</string>
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>StartInterval</key>
+    <integer>900</integer>
+    <key>StandardOutPath</key>
+    <string>{{NEXO_HOME}}/logs/catchup-stdout.log</string>
+    <key>StandardErrorPath</key>
+    <string>{{NEXO_HOME}}/logs/catchup-stderr.log</string>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>HOME</key>
+        <string>{{HOME}}</string>
+        <key>PATH</key>
+        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:__NEXO_HOME__/bin</string>
+        <key>NEXO_HOME</key>
+        <string>{{NEXO_HOME}}</string>
+        <key>NEXO_CODE</key>
+        <string>{{NEXO_CODE}}</string>
+    </dict>
+</dict>
+</plist>

package/templates/launchagents/com.nexo.cognitive-decay 2.plist

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- com.nexo.cognitive-decay
+     Runs nexo-cognitive-decay.py every day at 03:00 to apply Ebbinghaus
+     forgetting curve decay to the cognitive memory database. Memories
+     that have not been reinforced recently have their confidence scores
+     reduced. This prevents stale or superseded information from
+     dominating retrieval results and keeps the semantic memory fresh.
+-->
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.nexo.cognitive-decay</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/usr/bin/python3</string>
+        <string>{{NEXO_HOME}}/scripts/nexo-cognitive-decay.py</string>
+    </array>
+    <key>StartCalendarInterval</key>
+    <dict>
+        <key>Hour</key>
+        <integer>3</integer>
+        <key>Minute</key>
+        <integer>0</integer>
+    </dict>
+    <key>StandardOutPath</key>
+    <string>{{NEXO_HOME}}/logs/cognitive-decay-stdout.log</string>
+    <key>StandardErrorPath</key>
+    <string>{{NEXO_HOME}}/logs/cognitive-decay-stderr.log</string>
+    <key>RunAtLoad</key>
+    <false/>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>NEXO_HOME</key>
+        <string>{{NEXO_HOME}}</string>
+        <key>NEXO_CODE</key>
+        <string>{{NEXO_CODE}}</string>
+    </dict>
+</dict>
+</plist>

package/templates/launchagents/com.nexo.dashboard 2.plist

@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- com.nexo.dashboard
+     Keeps the NEXO web dashboard running persistently on port 6174.
+     The dashboard provides a browser-based view of sessions, reminders,
+     followups, learnings, and system health. Uses KeepAlive so macOS
+     automatically restarts it if it crashes. Access it at
+     http://localhost:6174 while the LaunchAgent is loaded.
+-->
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.nexo.dashboard</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/usr/bin/python3</string>
+        <string>-m</string>
+        <string>dashboard.app</string>
+        <string>--port</string>
+        <string>6174</string>
+        <string>--no-browser</string>
+    </array>
+    <key>WorkingDirectory</key>
+    <string>{{NEXO_HOME}}</string>
+    <key>KeepAlive</key>
+    <true/>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>/tmp/nexo-dashboard.log</string>
+    <key>StandardErrorPath</key>
+    <string>/tmp/nexo-dashboard.err</string>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:__NEXO_HOME__/bin</string>
+        <key>NEXO_HOME</key>
+        <string>{{NEXO_HOME}}</string>
+        <key>NEXO_CODE</key>
+        <string>{{NEXO_CODE}}</string>
+    </dict>
+</dict>
+</plist>

package/templates/launchagents/com.nexo.deep-sleep 2.plist

@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- com.nexo.deep-sleep
+     Runs nexo-deep-sleep.sh every day at 04:30 to perform overnight
+     consolidation. Reads the full transcripts from the previous day's
+     sessions, extracts patterns and learnings that were not captured
+     during live sessions, and writes them into the NEXO knowledge base.
+     This is the "REM sleep" of NEXO — background processing that
+     improves future performance without interrupting active work.
+-->
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.nexo.deep-sleep</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/bin/bash</string>
+        <string>{{NEXO_HOME}}/scripts/nexo-deep-sleep.sh</string>
+    </array>
+    <key>StartCalendarInterval</key>
+    <dict>
+        <key>Hour</key>
+        <integer>4</integer>
+        <key>Minute</key>
+        <integer>30</integer>
+    </dict>
+    <key>StandardOutPath</key>
+    <string>{{NEXO_HOME}}/logs/deep-sleep-stdout.log</string>
+    <key>StandardErrorPath</key>
+    <string>{{NEXO_HOME}}/logs/deep-sleep-stderr.log</string>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:__NEXO_HOME__/bin</string>
+        <key>HOME</key>
+        <string>{{HOME}}</string>
+        <key>NEXO_HOME</key>
+        <string>{{NEXO_HOME}}</string>
+        <key>NEXO_CODE</key>
+        <string>{{NEXO_CODE}}</string>
+    </dict>
+</dict>
+</plist>

package/templates/launchagents/com.nexo.evolution 2.plist

@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- com.nexo.evolution
+     Static fallback template for the weekly evolution cycle.
+     Managed installs now derive a machine-staggered weekly slot from the
+     cron manifest to avoid bunching public evolution PRs on Sunday.
+     If you install this plist manually, customize Weekday/Hour/Minute
+     yourself instead of assuming the managed stagger applies here.
+-->
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.nexo.evolution</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/usr/bin/python3</string>
+        <string>{{NEXO_HOME}}/scripts/nexo-evolution-run.py</string>
+    </array>
+    <key>StartCalendarInterval</key>
+    <dict>
+        <key>Hour</key>
+        <integer>5</integer>
+        <key>Minute</key>
+        <integer>0</integer>
+        <key>Weekday</key>
+        <integer>0</integer>
+    </dict>
+    <key>StandardOutPath</key>
+    <string>{{NEXO_HOME}}/logs/evolution-stdout.log</string>
+    <key>StandardErrorPath</key>
+    <string>{{NEXO_HOME}}/logs/evolution-stderr.log</string>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>HOME</key>
+        <string>{{HOME}}</string>
+        <key>PATH</key>
+        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:__NEXO_HOME__/bin</string>
+        <key>NEXO_HOME</key>
+        <string>{{NEXO_HOME}}</string>
+        <key>NEXO_CODE</key>
+        <string>{{NEXO_CODE}}</string>
+    </dict>
+</dict>
+</plist>

package/templates/launchagents/com.nexo.followup-hygiene 2.plist

@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- com.nexo.followup-hygiene
+     Runs nexo-followup-hygiene.py every Sunday at 05:00 to clean up
+     stale followups and reminders. Archives or closes items that have
+     been pending for too long without activity, deduplicates near-
+     identical entries, and generates a weekly hygiene report. Keeps the
+     operational database from accumulating noise that would clutter
+     NEXO's startup menu and priority queue.
+-->
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.nexo.followup-hygiene</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/usr/bin/python3</string>
+        <string>{{NEXO_HOME}}/scripts/nexo-followup-hygiene.py</string>
+    </array>
+    <key>StartCalendarInterval</key>
+    <dict>
+        <key>Weekday</key>
+        <integer>0</integer>
+        <key>Hour</key>
+        <integer>5</integer>
+        <key>Minute</key>
+        <integer>0</integer>
+    </dict>
+    <key>StandardOutPath</key>
+    <string>{{NEXO_HOME}}/logs/followup-hygiene-stdout.log</string>
+    <key>StandardErrorPath</key>
+    <string>{{NEXO_HOME}}/logs/followup-hygiene-stderr.log</string>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>HOME</key>
+        <string>{{HOME}}</string>
+        <key>PATH</key>
+        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:__NEXO_HOME__/bin</string>
+        <key>NEXO_HOME</key>
+        <string>{{NEXO_HOME}}</string>
+        <key>NEXO_CODE</key>
+        <string>{{NEXO_CODE}}</string>
+    </dict>
+</dict>
+</plist>

package/templates/launchagents/com.nexo.immune 2.plist

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- com.nexo.immune
+     Runs nexo-immune.py every 30 minutes to perform immune-system checks
+     on the NEXO knowledge base. Detects contradictions, stale data, and
+     memory drift. Part of NEXO's self-maintenance layer — ensures the
+     cognitive database stays internally consistent over time.
+-->
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.nexo.immune</string>
+
+    <key>ProgramArguments</key>
+    <array>
+        <string>/usr/bin/python3</string>
+        <string>{{NEXO_HOME}}/scripts/nexo-immune.py</string>
+    </array>
+
+    <key>StartInterval</key>
+    <integer>1800</integer>
+
+    <key>StandardOutPath</key>
+    <string>{{NEXO_HOME}}/coordination/immune-stdout.log</string>
+
+    <key>StandardErrorPath</key>
+    <string>{{NEXO_HOME}}/coordination/immune-stderr.log</string>
+
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>HOME</key>
+        <string>{{HOME}}</string>
+        <key>PATH</key>
+        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:__NEXO_HOME__/bin</string>
+        <key>NEXO_HOME</key>
+        <string>{{NEXO_HOME}}</string>
+        <key>NEXO_CODE</key>
+        <string>{{NEXO_CODE}}</string>
+    </dict>
+</dict>
+</plist>

package/templates/launchagents/com.nexo.postmortem 2.plist

@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- com.nexo.postmortem
+     Runs nexo-postmortem-consolidator.py every day at 23:30 to produce
+     an end-of-day postmortem. Consolidates the day's session diaries,
+     decisions, changes, and errors into a single structured summary.
+     This summary feeds into the next morning's synthesis and provides
+     a permanent record of what happened each day. Does not run at load
+     — only fires at the scheduled time.
+-->
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.nexo.postmortem</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/usr/bin/python3</string>
+        <string>{{NEXO_HOME}}/scripts/nexo-postmortem-consolidator.py</string>
+    </array>
+    <key>RunAtLoad</key>
+    <false/>
+    <key>StartCalendarInterval</key>
+    <dict>
+        <key>Hour</key>
+        <integer>23</integer>
+        <key>Minute</key>
+        <integer>30</integer>
+    </dict>
+    <key>StandardOutPath</key>
+    <string>{{NEXO_HOME}}/logs/postmortem-stdout.log</string>
+    <key>StandardErrorPath</key>
+    <string>{{NEXO_HOME}}/logs/postmortem-stderr.log</string>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>HOME</key>
+        <string>{{HOME}}</string>
+        <key>PATH</key>
+        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:__NEXO_HOME__/bin</string>
+        <key>NEXO_HOME</key>
+        <string>{{NEXO_HOME}}</string>
+        <key>NEXO_CODE</key>
+        <string>{{NEXO_CODE}}</string>
+    </dict>
+</dict>
+</plist>

package/templates/launchagents/com.nexo.self-audit 2.plist

@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- com.nexo.self-audit
+     Runs nexo-daily-self-audit.py every day at 07:00 to assess the
+     health of NEXO's learning system. Calculates the learning repetition
+     rate (how often new learnings duplicate existing ones), identifies
+     the top areas with recurring errors, and flags learnings that have
+     been ignored 3+ times. Alerts if the repetition rate exceeds 30%.
+-->
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.nexo.self-audit</string>
+
+    <key>ProgramArguments</key>
+    <array>
+        <string>/usr/bin/python3</string>
+        <string>{{NEXO_HOME}}/scripts/nexo-daily-self-audit.py</string>
+    </array>
+
+    <key>StartCalendarInterval</key>
+    <dict>
+        <key>Hour</key>
+        <integer>7</integer>
+        <key>Minute</key>
+        <integer>0</integer>
+    </dict>
+
+    <key>StandardOutPath</key>
+    <string>{{NEXO_HOME}}/logs/self-audit-stdout.log</string>
+
+    <key>StandardErrorPath</key>
+    <string>{{NEXO_HOME}}/logs/self-audit-stderr.log</string>
+
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>HOME</key>
+        <string>{{HOME}}</string>
+        <key>PATH</key>
+        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:__NEXO_HOME__/bin</string>
+        <key>NEXO_HOME</key>
+        <string>{{NEXO_HOME}}</string>
+        <key>NEXO_CODE</key>
+        <string>{{NEXO_CODE}}</string>
+    </dict>
+</dict>
+</plist>

package/templates/launchagents/com.nexo.synthesis 2.plist

@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- com.nexo.synthesis
+     Runs nexo-synthesis.py every 2 hours to generate a daily synthesis
+     document. Aggregates session diaries, error patterns, pending items,
+     and self-evaluation notes into coordination/daily-synthesis.md.
+     This file is read at the start of each session to give NEXO context
+     about what happened recently without replaying full session logs.
+-->
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.nexo.synthesis</string>
+
+    <key>ProgramArguments</key>
+    <array>
+        <string>/usr/bin/python3</string>
+        <string>{{NEXO_HOME}}/scripts/nexo-synthesis.py</string>
+    </array>
+
+    <key>StartInterval</key>
+    <integer>7200</integer>
+
+    <key>RunAtLoad</key>
+    <false/>
+
+    <key>StandardOutPath</key>
+    <string>{{NEXO_HOME}}/coordination/synthesis-stdout.log</string>
+
+    <key>StandardErrorPath</key>
+    <string>{{NEXO_HOME}}/coordination/synthesis-stderr.log</string>
+
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>HOME</key>
+        <string>{{HOME}}</string>
+        <key>PATH</key>
+        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:__NEXO_HOME__/bin</string>
+        <key>NEXO_HOME</key>
+        <string>{{NEXO_HOME}}</string>
+        <key>NEXO_CODE</key>
+        <string>{{NEXO_CODE}}</string>
+    </dict>
+</dict>
+</plist>

package/templates/launchagents/com.nexo.watchdog 2.plist

@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- com.nexo.watchdog
+     Runs nexo-watchdog.sh every 30 minutes to monitor system health.
+     Checks that the NEXO MCP server, cron jobs, and key infrastructure
+     services are alive. Writes results to watchdog-status.json and
+     watchdog-report.txt. Sets a .watchdog-alert flag when failures are
+     detected so the next Claude session can alert the user immediately.
+-->
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.nexo.watchdog</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/bin/bash</string>
+        <string>{{NEXO_HOME}}/scripts/nexo-watchdog.sh</string>
+    </array>
+    <key>StartInterval</key>
+    <integer>1800</integer>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>{{NEXO_HOME}}/logs/watchdog-stdout.log</string>
+    <key>StandardErrorPath</key>
+    <string>{{NEXO_HOME}}/logs/watchdog-stderr.log</string>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:__NEXO_HOME__/bin</string>
+        <key>NEXO_HOME</key>
+        <string>{{NEXO_HOME}}</string>
+        <key>NEXO_CODE</key>
+        <string>{{NEXO_CODE}}</string>
+    </dict>
+</dict>
+</plist>