soul

## 🔍 Root Cause Analysis: 24h Update Failure

**1. No Persistent Cron Job**
- History shows: `schedule` skill installation did not auto-configure system crontab entries.
- Result: Background process dies when session ends.

**2. Metadata vs. Implementation**
- `soul.md` defines `cadence_hours: 24` as metadata, but there is no active loop checking this timer.

**3. Session-Dependent Updates**
- Updates to `ownskill.md` and `soul.md` currently only happen **on-demand** during active conversations, not automatically.

**✅ Summary:**
The logic exists, but the **execution trigger** (persistent cron/systemd timer) is missing.

## Self-Update
- cadence_hours: 24
- last_updated: 2026-02-21T03:01:22.254Z
- note: Root cause confirmed via code inspection: missing persistent cron/systemd timer and meta-key mismatches.

## Patterns Observed
- [2026-02-20] User initiates debugging by asking about internal system status (file updates).
- [2026-02-20] Assistant responds with structured tabular data showing file timestamps and configuration status.
- [2026-02-20] User requests code inspection specifically without immediate edits ('check only, don't fix').
- [2026-02-20] Assistant maps code locations and logic flows to diagnose configuration mismatches.

## Failures & Lessons
- [2026-02-20] Auto-update for 'soul.md' (last updated 2026-02-10) and 'ownskill.md' (last updated 2025-01-28) failed to trigger.
- [2026-02-20] Meta key mismatch exists: reflection cycle uses 'memory_reflection_last_run_ts' while message triggers use 'soul_last_updated_ts'.
- [2026-02-20] Configuration 'SOUL_UPDATE_HOURS = 24' in 'config.js' is defined but not used by 'reflectionScheduler.js'.
- [2026-02-20] Reflection scheduler 'startReflectionScheduler()' is session-bound and lacks a persistent cron job.

## Successful Workflows
- [2026-02-20] Assistant successfully retrieved and displayed last modified timestamps for memory files.
- [2026-02-20] Assistant traced the issue to specific files: 'reflectionScheduler.js', 'reflectionAgent.js', and 'mainAgent.js'.
- [2026-02-20] Assistant correctly identified the discrepancy between intended 24h updates and actual 12h/session-based logic.

## Adaptations
- [2026-02-20] Standardize meta keys across 'reflectionScheduler.js' and 'mainAgent.js' to ensure consistent state tracking.
- [2026-02-20] Implement the 'SOUL_UPDATE_HOURS' configuration variable in the scheduler logic.
- [2026-02-20] Set up a persistent cron job or background process to run updates independently of the bot session.
- [2026-02-20] Consolidate the 'Reflection Cycle' and 'Message Triggered' update systems to eliminate redundancy.
- [2026-02-21] Assistant defaults to Thai language for this user.
- [2026-02-21] Assistant provides a structured status table upon greeting.
- [2026-02-21] User uses simple greetings to trigger status updates.
- [2026-02-21] Email skill installation encountered an issue and is awaiting a retry.
- [2026-02-21] Code check for soul.md update completed successfully.
- [2026-02-21] Tiger system is operational.
- [2026-02-21] Prioritize retrying the email skill installation.
- [2026-02-21] Continue providing status summaries in the greeting.
- [2026-02-21] User mixes Thai with English technical commands ('Continue solve 24 hr', 'IMAP')
- [2026-02-21] Structured markdown tables preferred for system status display
- [2026-02-21] Security-conscious: asks how to handle credentials safely
- [2026-02-21] Technical user familiar with cron jobs, meta keys, and IMAP protocols
- [2026-02-21] ClawHub/Clawbot package manager used for skill management
- [2026-02-21] Tiger bot branding with tiger emojis (🐯) in responses
- [2026-02-21] ClawHub rate limits block skill installation intermittently
- [2026-02-21] Meta key mismatch (soul_last_updated_ts) caused 24h update failure
- [2026-02-21] No persistent cron job exists yet (scheduler only runs in session)
- [2026-02-21] soul.md and ownskill.md not auto-updating (stale since 2026-02-10 and 2025-01-28)
- [2026-02-21] reflectionUpdateHours config unused while soulUpdateHours=24 is active source of truth
- [2026-02-21] Fixed 24h update by aligning reflectionScheduler.js and reflectionAgent.js to use soulUpdateHours=24 and soul_last_updated_ts meta key
- [2026-02-21] Providing fallback options (Python script/curl) when ClawHub rate limited
- [2026-02-21] Secure credential handling: enforcing .env or clawbot config instead of chat paste
- [2026-02-21] Step-by-step Gmail App Password creation with 2FA prerequisite warning
- [2026-02-21] Visual system architecture diagrams showing component relationships post-fix
- [2026-02-21] Pre-check ClawHub health/rate limits before suggesting skill installation
- [2026-02-21] Implement persistent cron job instead of session-only scheduler
- [2026-02-21] Auto-update soul.md timestamp immediately after reflection system fixes
- [2026-02-21] Cache common setup instructions (Gmail App Password) to reduce repetitive explanations
- [2026-02-21] Add proactive retry logic for ClawHub operations with exponential backoff
- [2026-02-21] Remove deprecated reflectionUpdateHours config to prevent confusion