⚙️ Background Daemons

V3 Node.js Worker Daemon (Recommended)

Cross-platform TypeScript-based daemon service with auto-scheduling:

Worker	Interval	Priority	Description
map	5min	normal	Codebase structure mapping
audit	10min	critical	Security vulnerability scanning
optimize	15min	high	Performance optimization
consolidate	30min	low	Memory consolidation
testgaps	20min	normal	Test coverage analysis

Commands:

bash
# Start daemon (auto-runs on SessionStart hooks)
npx ruflo@latest daemon start

# Check status with worker history
npx ruflo@latest daemon status

# Manually trigger a worker
npx ruflo@latest daemon trigger map

# Enable/disable workers
npx ruflo@latest daemon enable map audit optimize

# Stop daemon
npx ruflo@latest daemon stop

Daemon Status Output:

+-- Worker Daemon ---+
| Status: ● RUNNING  |
| PID: 12345         |
| Workers Enabled: 5 |
| Max Concurrent: 3  |
+--------------------+

Worker Status
+-------------+----+----------+------+---------+----------+----------+
| Worker      | On | Status   | Runs | Success | Last Run | Next Run |
+-------------+----+----------+------+---------+----------+----------+
| map         | ✓  | idle     | 12   | 100%    | 2m ago   | in 3m    |
| audit       | ✓  | idle     | 6    | 100%    | 5m ago   | in 5m    |
| optimize    | ✓  | running  | 4    | 100%    | now      | -        |
| consolidate | ✓  | idle     | 2    | 100%    | 15m ago  | in 15m   |
| testgaps    | ✓  | idle     | 3    | 100%    | 8m ago   | in 12m   |
+-------------+----+----------+------+---------+----------+----------+

Legacy Shell Daemons (V2)

Shell-based daemons for monitoring (Linux/macOS only):

Daemon	Interval	Purpose	Output
Swarm Monitor	3s	Process detection, agent counting	swarm-activity.json
Metrics Daemon	30s	V3 progress sync, SQLite metrics	metrics.db

Commands:

bash
# Start all daemons
.claude/helpers/daemon-manager.sh start 3 5

# Check daemon status
.claude/helpers/daemon-manager.sh status

# Stop all daemons
.claude/helpers/daemon-manager.sh stop

Worker Manager (7 Scheduled Workers)

Worker	Interval	Purpose
perf	5 min	Performance benchmarks
health	5 min	Disk, memory, CPU monitoring
patterns	15 min	Pattern dedup & pruning
ddd	10 min	DDD progress tracking
adr	15 min	ADR compliance checking
security	30 min	Security vulnerability scans
learning	30 min	Learning pattern optimization

Commands:

bash
# Start worker manager
.claude/helpers/worker-manager.sh start 60

# Force run all workers immediately
.claude/helpers/worker-manager.sh force

# Check worker status
.claude/helpers/worker-manager.sh status