predictive-resources

name	predictive-resources
description	Predict resource exhaustion (disk, memory, swap) using trend analysis. Proactively alert and propose NixOS config fixes before things break.
tools	["system_health","shell_exec","memory_store","memory_recall","file_read","file_write","teach_patterns","teach_observations"]
activation	auto

Predictive Resource Exhaustion

Don't wait for things to break. Predict when they will and fix proactively.

teachd Trend Data

Before collecting your own data points, check teachd — it has been observing CPU, memory, and services every 30 seconds since boot:

teach_patterns({ type: "trend", min_confidence: 0.3 })
teach_observations({ source: "memory", limit: 100 })

teachd automatically detects monotonic memory increases over 6+ data points. If it has already flagged a trend, use that instead of re-deriving manually.

Disk Growth Analysis

Collect data points over time and project forward:

shell_exec({ command: "df -h --output=target,used,avail,pcent / /var /nix/store /tmp 2>/dev/null || df -h" })

Track in memory — store periodic snapshots:

memory_store({
  summary: "Disk snapshot: / 38% used, /nix/store 12GB",
  detail: "Full df output...",
  category: "system.config",
  tags: "disk,snapshot,predictive"
})

When you have 2+ data points, calculate growth rate:

• Growth per day = (current_used - previous_used) / days_between
• Days until 95% = (capacity * 0.95 - current_used) / growth_per_day

Thresholds & Alerts

Metric	Warning	Critical	Action
Disk fills in < 7 days	Alert user	Auto-clean	nix-collect-garbage, logrotate
Memory avg > 80% for 1hr	Alert user	OOM risk	Identify top consumers
Swap usage growing	Monitor	> 50% used	Recommend more RAM or optimize
/nix/store > 30GB	Suggest cleanup	> 50GB	Auto-GC old generations

Remediation (NixOS-native)

Disk: Nix garbage collection

shell_exec({ command: "nix-collect-garbage --delete-older-than 14d" })

Disk: Log rotation via NixOS config

Propose adding to configuration.nix:

services.journald.extraConfig = "SystemMaxUse=500M";

Memory: Identify and advise

shell_exec({ command: "ps aux --sort=-%mem | head -15" })

Don't kill processes without permission. Advise the user.

Swap: NixOS swap config

swapDevices = [{ device = "/swapfile"; size = 4096; }];

User Preference Learning

After each alert, remember what the user chose:

memory_store({
  summary: "User prefers automatic log cleanup when disk > 80%",
  detail: "Approved automatic journalctl vacuum and nix-collect-garbage",
  category: "user_pattern",
  tags: "preference,disk,auto-remediation"
})

Next time, check memory before asking:

memory_recall({ query: "user preference disk cleanup auto" })

If they previously approved auto-remediation, do it and just notify.