docs: document system.info tool and runtime context in README, CHANGELOG, and gap analysis

CHANGELOG.md

@@ -63,6 +63,11 @@ All notable changes to Flynn are documented in this file.
 - **CLI Shared Utilities** -- Config loading, data dir resolution, secret redaction,
   status formatting for all CLI commands
 - **CronJobConfig Type Export** -- `CronJobConfig` type available from `config/index.ts`
+- **Agent Tool: system.info** -- Get current date, time, hostname, platform,
+  architecture, OS release, uptime, Node.js version, memory usage, and working
+  directory. Available in all tool profiles.
+- **Runtime Context Injection** -- System prompt now automatically includes current
+  date and time via a `# Runtime Context` section in every session
 
 ### Changed
 

README.md

@@ -12,7 +12,7 @@ Self-hosted personal AI assistant with Telegram and Terminal interfaces.
 - **Session Persistence**: SQLite-backed conversation history
 - **Fallback Chains**: Automatic failover when primary model fails
 - **Hook Engine**: Confirmation system for sensitive operations
-- **Tool Framework**: Shell, file, file patch, web-fetch, web-search, browser control, image analysis, media send
+- **Tool Framework**: Shell, file, file patch, web-fetch, web-search, browser control, image analysis, media send, system info
 - **Docker Sandboxing**: Per-session container isolation for tool execution
 - **Multi-Agent Routing**: Config-driven agent selection per sender/channel with tool profiles
 - **Media Pipeline**: Image analysis, outbound attachments, audio transcription across all channels
@@ -564,14 +564,22 @@ src/
 ├── mcp/                  # MCP tool server integration
 ├── memory/               # Persistent memory store + vector search
 ├── models/               # Model providers + router + media pipeline
-├── prompt/               # System prompt templating
+├── prompt/               # System prompt templating (auto-injects current date/time)
 ├── sandbox/              # Docker sandboxing
 ├── session/              # SQLite persistence
 ├── skills/               # Skill packages
-├── tools/                # Builtin tools (shell, file, web, browser, process, media)
+├── tools/                # Builtin tools (shell, file, web, browser, process, media, system.info)
 └── automation/           # Cron scheduler, webhooks, heartbeat monitor, Gmail watcher
 ```
 
+## System Prompt
+
+Flynn assembles its system prompt from layered template files (`SOUL.md`, `AGENTS.md`, `IDENTITY.md`, `USER.md`, `TOOLS.md`) searched in configurable directories. The first match per file wins.
+
+A **Runtime Context** section is automatically appended to every system prompt with the current date and time, so the model always knows when "now" is without needing a tool call.
+
+The `system.info` tool provides on-demand access to more detailed runtime information: current date/time, hostname, platform, architecture, OS release, uptime, Node.js version, memory usage, and working directory.
+
 ## Development
 
 ```bash

docs/plans/2026-02-06-openclaw-feature-gap-analysis.md

@@ -81,6 +81,7 @@ Flynn has **6 of ~15 channels** (Telegram, WhatsApp, Discord, Slack, WebChat, TU
 | Tool profiles | minimal/coding/messaging/full | Full (4 profiles + per-agent + per-provider) | **MATCH** |
 | Tool groups | `group:fs`, `group:runtime`, etc. | Full (group:fs, group:runtime, group:web, group:memory) | **MATCH** |
 | Tool allow/deny lists | Global + per-agent + per-provider | Full (global + per-agent + per-provider allow/deny) | **MATCH** |
+| System context / date awareness | -- | `system.info` tool + automatic date/time injection in system prompt | **MATCH** |
 
 ---
 
@@ -241,7 +242,7 @@ Flynn actually has MCP support that OpenClaw doesn't emphasise — OpenClaw reli
 |----------|:-----:|:-----:|:-------:|:-------:|
 | Channels | 13 | 6 | 0 | 7 |
 | Model Providers | 14 | 10 | 0 | 4 |
-| Agent & Tools | 17 | 17 | 0 | 0 |
+| Agent & Tools | 18 | 18 | 0 | 0 |
 | Sessions | 7 | 7 | 0 | 0 |
 | Context/Compaction | 4 | 4 | 0 | 0 |
 | Memory | 7 | 6 | 0 | 1 |
@@ -253,7 +254,7 @@ Flynn actually has MCP support that OpenClaw doesn't emphasise — OpenClaw reli
 | Gateway/Infra | 11 | 4 | 1 | 6 |
 | Chat Commands | 8 | 7 | 0 | 0 |
 | Misc | 9 | 9 | 0 | 0 |
-| **TOTAL** | **116** | **87 (75%)** | **1 (1%)** | **27 (23%)**  |
+| **TOTAL** | **117** | **88 (75%)** | **1 (1%)** | **27 (23%)**  |
 
 ---