docs: Update README, .env.example, and .gitignore for Living AI

- Add Living AI features overview to README
- Document all Living AI configuration options
- Add Living AI command toggles documentation
- Add new Living AI commands (!relationship, !mood, etc.)
- Update project structure to include new services
- Add Living AI settings to .env.example
- Add command toggles to .env.example
- Update commands reference with Living AI commands
- Add database files to .gitignore

README.md

@@ -12,6 +12,17 @@ A customizable Discord bot that responds to @mentions with AI-generated response
 - **Fully Customizable**: Configure bot name, personality, and behavior
 - **Easy Deployment**: Docker support with PostgreSQL included
 
+### Living AI Features
+
+- **Autonomous Learning**: Bot automatically extracts and remembers facts from conversations
+- **Mood System**: Bot has emotional states that affect its responses naturally
+- **Relationship Tracking**: Bot builds relationships from Stranger to Close Friend
+- **Communication Style Learning**: Bot adapts to each user's preferred style
+- **Opinion Formation**: Bot develops genuine preferences on topics
+- **Proactive Behavior**: Birthday wishes, follow-ups on mentioned events
+- **Self-Awareness**: Bot knows its age, statistics, and history with users
+- **Cross-User Connections**: Bot can identify shared interests between users
+
 ## Quick Start
 
 ### 1. Clone the repository
@@ -104,6 +115,38 @@ When `DATABASE_URL` is set, the bot uses PostgreSQL for persistent storage. With
 
 When configured, the bot automatically searches the web for queries that need current information (news, weather, etc.).
 
+### Living AI Settings
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `LIVING_AI_ENABLED` | `true` | Master switch for all Living AI features |
+| `MOOD_ENABLED` | `true` | Enable mood system |
+| `RELATIONSHIP_ENABLED` | `true` | Enable relationship tracking |
+| `FACT_EXTRACTION_ENABLED` | `true` | Enable autonomous fact extraction |
+| `FACT_EXTRACTION_RATE` | `0.3` | Probability of extracting facts (0.0-1.0) |
+| `PROACTIVE_ENABLED` | `true` | Enable proactive messages (birthdays, follow-ups) |
+| `CROSS_USER_ENABLED` | `false` | Enable cross-user associations (privacy-sensitive) |
+| `OPINION_FORMATION_ENABLED` | `true` | Enable bot opinion formation |
+| `STYLE_LEARNING_ENABLED` | `true` | Enable communication style learning |
+| `MOOD_DECAY_RATE` | `0.1` | How fast mood returns to neutral per hour |
+
+### Command Toggles
+
+All commands can be individually enabled/disabled. When disabled, the bot handles these functions naturally through conversation.
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `COMMANDS_ENABLED` | `true` | Master switch for all commands |
+| `CMD_RELATIONSHIP_ENABLED` | `true` | Enable `!relationship` command |
+| `CMD_MOOD_ENABLED` | `true` | Enable `!mood` command |
+| `CMD_BOTSTATS_ENABLED` | `true` | Enable `!botstats` command |
+| `CMD_OURHISTORY_ENABLED` | `true` | Enable `!ourhistory` command |
+| `CMD_BIRTHDAY_ENABLED` | `true` | Enable `!birthday` command |
+| `CMD_REMEMBER_ENABLED` | `true` | Enable `!remember` command |
+| `CMD_SETNAME_ENABLED` | `true` | Enable `!setname` command |
+| `CMD_WHATDOYOUKNOW_ENABLED` | `true` | Enable `!whatdoyouknow` command |
+| `CMD_FORGETME_ENABLED` | `true` | Enable `!forgetme` command |
+
 ### Example Configurations
 
 **Friendly Assistant:**
@@ -171,6 +214,22 @@ Admin commands:
 | `!setusername @user <name>` | Set name for another user |
 | `!teachbot @user <fact>` | Add a fact about a user |
 
+### Living AI Commands
+
+| Command | Description |
+|---------|-------------|
+| `!relationship` | See your relationship level with the bot |
+| `!mood` | See the bot's current emotional state |
+| `!botstats` | Bot shares its self-awareness statistics |
+| `!ourhistory` | See your history with the bot |
+| `!birthday <date>` | Set your birthday for the bot to remember |
+
+**Note:** When commands are disabled, the bot handles these naturally through conversation:
+- Ask "what do you know about me?" instead of `!whatdoyouknow`
+- Say "call me Alex" instead of `!setname Alex`
+- Ask "how are you feeling?" instead of `!mood`
+- Say "my birthday is March 15th" instead of `!birthday`
+
 ## AI Providers
 
 | Provider | Models | Notes |
@@ -193,15 +252,25 @@ src/daemon_boyfriend/
 ├── models/
 │   ├── user.py         # User, UserFact, UserPreference
 │   ├── conversation.py # Conversation, Message
-│   └── guild.py        # Guild, GuildMember
+│   ├── guild.py        # Guild, GuildMember
+│   └── living_ai.py    # BotState, UserRelationship, etc.
 └── services/
     ├── ai_service.py   # AI provider factory
     ├── database.py     # PostgreSQL connection
     ├── user_service.py # User management
     ├── persistent_conversation.py  # DB-backed history
     ├── providers/      # AI providers
-    └── searxng.py      # Web search service
-alembic/                # Database migrations
+    ├── searxng.py      # Web search service
+    ├── mood_service.py           # Mood system
+    ├── relationship_service.py   # Relationship tracking
+    ├── fact_extraction_service.py # Autonomous learning
+    ├── communication_style_service.py # Style learning
+    ├── opinion_service.py        # Opinion formation
+    ├── proactive_service.py      # Scheduled events
+    ├── self_awareness_service.py # Bot self-reflection
+    └── association_service.py    # Cross-user connections
+schema.sql              # Database schema
+project-vision.md       # Living AI design document
 ```
 
 ## License