Merge pull request 'docs: synchronize README with production configuration' (#50) from codex/issue-46-readme-sync into codex/production-intelligence-terminal

Merge pull request #50: synchronize README with production configuration

README.md

@@ -85,7 +85,7 @@ npm run dev
 > ```
 > This bypasses npm's script runner, which can swallow errors on some systems (particularly PowerShell on Windows). You can also run `node diag.mjs` to diagnose the exact issue — it checks your Node version, tests each module import individually, and verifies port availability. See [Troubleshooting](#troubleshooting) for more.
 
-The dashboard opens automatically at `http://localhost:3117` and immediately begins its first intelligence sweep. This initial sweep queries all 27 sources in parallel and typically takes 30–60 seconds — the dashboard will appear empty until the sweep completes and pushes the first data update. After that, it auto-refreshes every 15 minutes via SSE (Server-Sent Events). No manual page refresh needed.
+The server starts at `http://localhost:3117` and immediately begins its first intelligence sweep. Browser auto-open is disabled by default; open the URL yourself or explicitly set `AUTO_OPEN_BROWSER=true` for a supported desktop environment. The initial sweep queries all 27 sources in parallel and typically takes 30–60 seconds — the dashboard will appear empty until the sweep completes and pushes the first data update. After that, it auto-refreshes every 15 minutes via SSE (Server-Sent Events). No manual page refresh is needed.
 
 **Requirements:** Node.js 22+ (uses native `fetch`, top-level `await`, ESM)
 
@@ -157,9 +157,13 @@ ACLED_EMAIL=
 ACLED_PASSWORD=
 CLOUDFLARE_API_TOKEN=
 BLS_API_KEY=
+REDDIT_CLIENT_ID=
+REDDIT_CLIENT_SECRET=
 
 TELEGRAM_BOT_TOKEN=
 TELEGRAM_CHAT_ID=
+TELEGRAM_POLL_INTERVAL=5000
+TELEGRAM_CHANNELS=
 DISCORD_BOT_TOKEN=
 DISCORD_CHANNEL_ID=
 DISCORD_GUILD_ID=
@@ -436,14 +440,18 @@ Reddit is OAuth-only in this fork. If the Reddit credentials are missing or reje
 
 ### LLM Provider (optional, for AI-enhanced ideas)
 
-Set `LLM_PROVIDER` to one of: `anthropic`, `openai`, `gemini`, `codex`, `openrouter`, `minimax`, `mistral`, `grok`
+Set `LLM_PROVIDER` to one of: `litellm`, `openrouter`, `openai-compatible`, `lmstudio`, `ollama`, `anthropic`, `openai`, `gemini`, `codex`, `minimax`, `mistral`, or `grok`.
 
-| Provider | Key Required | Default Model |
-|----------|-------------|---------------|
+| Provider | Key Required | Default Model / Requirement |
+|----------|--------------|-----------------------------|
+| `litellm` | `LLM_API_KEY` | Explicit `LLM_BASE_URL` and `LLM_MODEL` required |
+| `openrouter` | `LLM_API_KEY` | `openrouter/free` |
+| `openai-compatible` | Endpoint-dependent | `local-model`; set `LLM_BASE_URL` |
+| `lmstudio` | No | `local-model` |
+| `ollama` | No | `llama3.1:8b` |
 | `anthropic` | `LLM_API_KEY` | claude-sonnet-4-6 |
-| `openai` | `LLM_API_KEY` | gpt-5.4 |
+| `openai` | `LLM_API_KEY` | `gpt-4o-mini` |
 | `gemini` | `LLM_API_KEY` | gemini-3.1-pro |
-| `openrouter` | `LLM_API_KEY` | openrouter/auto |
 | `codex` | None (uses `~/.codex/auth.json`) | gpt-5.3-codex |
 | `minimax` | `LLM_API_KEY` | MiniMax-M2.5 |
 | `mistral` | `LLM_API_KEY` | mistral-large-latest |
@@ -631,9 +639,22 @@ All settings are in `.env` with sensible defaults:
 | `STALE_DATA_MAX_AGE_MINUTES` | `60` | Data age threshold for stale health state |
 | `STALE_ALERT_COOLDOWN_MINUTES` | `60` | Minimum time between repeated operator stale-data alerts |
 | `DASHBOARD_URL` | local URL | Dashboard URL included in operator alerts |
+| `AUTO_OPEN_BROWSER` | `false` | Open the dashboard in a host browser; keep disabled in Docker |
+| `TERMINAL_ACTIONS_ENABLED` | environment-dependent | Enable guarded dashboard actions such as sweep and brief |
+| `SWEEP_TOKEN` | disabled | Shared token required for remote action requests |
+| `SSE_HEARTBEAT_INTERVAL_MS` | `25000` | Heartbeat interval for reverse-proxy SSE connections |
+| `TERMINAL_ACTION_RATE_LIMIT_WINDOW_MS` | `60000` | Terminal action rate-limit window |
+| `TERMINAL_ACTION_RATE_LIMIT_MAX` | `10` | Maximum terminal actions per client/window |
+| `BRIEF_VERBOSITY` | `standard` | Briefing detail level |
 | `LLM_PROVIDER` | disabled | `litellm`, `openrouter`, `openai-compatible`, `lmstudio`, `ollama`, `anthropic`, `openai`, `gemini`, `codex`, `minimax`, `mistral`, or `grok` |
-| `LLM_API_KEY` | — | API key (not needed for codex) |
+| `LLM_BASE_URL` | provider default | API base URL; required for LiteLLM and custom endpoints |
+| `LLM_API_KEY` | — | Provider or proxy API key; required for LiteLLM |
 | `LLM_MODEL` | per-provider default | Override model selection |
+| `LLM_TEMPERATURE` | `0.2` | Sampling temperature for OpenAI-compatible providers |
+| `LLM_MAX_TOKENS` | `2000` | Maximum completion token budget |
+| `LLM_TIMEOUT_MS` | `90000` | LLM request timeout in milliseconds |
+| `OPENROUTER_SITE_URL` | repository URL | OpenRouter attribution URL |
+| `OPENROUTER_APP_NAME` | `Intelligence Terminal` | OpenRouter application title |
 | `TELEGRAM_BOT_TOKEN` | disabled | For Telegram alerts + bot commands |
 | `TELEGRAM_CHAT_ID` | — | Your Telegram chat ID |
 | `TELEGRAM_CHANNELS` | — | Extra channel IDs to monitor (comma-separated) |

docs/agent-handoff.md

@@ -2,15 +2,16 @@
 
 Last updated: 2026-07-03
 
-## Current Work
+## Latest Completed Work
 
 - Canonical repository: `https://git.wilkensxl.de/Code-Inc/intelligence-terminal`
-- Production baseline before this work: `c159c83a0768486c8c6f445b458b760dba4ba385`
-- Active branch: `codex/issue-47-litellm-provider`
-- Issue: `#47 Add first-class LiteLLM provider and publish updated image`
+- LiteLLM implementation merge: `5c4bf80eb0c19bd59080f5432a2a344798d7a3ce`
+- Merged PR: `#48 feat: add LiteLLM provider and publish Code-Inc image`
+- Completed issue: `#47 Add first-class LiteLLM provider and publish updated image`
 - LiteLLM is implemented through the OpenAI-compatible `/chat/completions` API and requires `LLM_BASE_URL`, `LLM_API_KEY`, and `LLM_MODEL`.
 - The build workflow now targets `git.wilkensxl.de/code-inc/intelligence-terminal` and publishes only from the production branch, not from pull requests.
-- Runner build/test/image verification and the first `code-inc` registry publication must be recorded here after the branch is pushed and merged.
+- Gitea Actions runs 231-235 passed for the PR and production merge, including unit tests, Compose validation, Docker build, release dry-run, and template compliance.
+- The first `code-inc` registry publication was verified through the Gitea Package API on 2026-07-03.
 - Related maintenance: issue #21 tracks the failing security scan, #45 tracks the dependency workflow, and #46 tracks remaining namespace/handoff cleanup.
 
 ## Repository State
@@ -236,27 +237,41 @@ README includes:
 
 ## Registry And Images
 
-Target registry image after the current production merge:
+Production registry image:
 
 ```text
 git.wilkensxl.de/code-inc/intelligence-terminal
 ```
 
-The legacy `mrsphay` package remains available. Verify these new `code-inc` tags after the current runner publication:
+The legacy `mrsphay` package remains available. Verified `code-inc` tags from the LiteLLM production merge:
 
 ```text
 latest
-YYYYMMDD
-<production-commit-sha>
+20260703
+5c4bf80eb0c19bd59080f5432a2a344798d7a3ce
 ```
 
-Required pull verification after publication:
+Operator pull command:
 
 ```bash
 docker pull git.wilkensxl.de/code-inc/intelligence-terminal:latest
 ```
 
-Record the resulting digest after the runner push.
+Published manifest digest:
+
+```text
+sha256:5e29483ebfd9baae368673adc790789f02aed2d5d5d3a550fe55a4b71b5b62dd
+```
+
+Relevant successful runner executions:
+
+```text
+PR build:             https://git.wilkensxl.de/Code-Inc/intelligence-terminal/actions/runs/231
+PR template check:    https://git.wilkensxl.de/Code-Inc/intelligence-terminal/actions/runs/232
+Production publish:   https://git.wilkensxl.de/Code-Inc/intelligence-terminal/actions/runs/233
+Release dry-run:      https://git.wilkensxl.de/Code-Inc/intelligence-terminal/actions/runs/234
+Template compliance: https://git.wilkensxl.de/Code-Inc/intelligence-terminal/actions/runs/235
+```
 
 ## Gitea Actions
 
@@ -285,12 +300,12 @@ template-compliance.yml on codex/production-intelligence-terminal: success
 Relevant run URLs:
 
 ```text
-https://git.wilkensxl.de/MrSphay/intelligence-terminal/actions/runs/23
-https://git.wilkensxl.de/MrSphay/intelligence-terminal/actions/runs/24
-https://git.wilkensxl.de/MrSphay/intelligence-terminal/actions/runs/25
-https://git.wilkensxl.de/MrSphay/intelligence-terminal/actions/runs/26
-https://git.wilkensxl.de/MrSphay/intelligence-terminal/actions/runs/27
-https://git.wilkensxl.de/MrSphay/intelligence-terminal/actions/runs/28
+https://git.wilkensxl.de/Code-Inc/intelligence-terminal/actions/runs/23
+https://git.wilkensxl.de/Code-Inc/intelligence-terminal/actions/runs/24
+https://git.wilkensxl.de/Code-Inc/intelligence-terminal/actions/runs/25
+https://git.wilkensxl.de/Code-Inc/intelligence-terminal/actions/runs/26
+https://git.wilkensxl.de/Code-Inc/intelligence-terminal/actions/runs/27
+https://git.wilkensxl.de/Code-Inc/intelligence-terminal/actions/runs/28
 ```
 
 Repository secret expected by the registry publish workflow:
@@ -320,28 +335,28 @@ The following Gitea issues were created for real remaining work:
 
 ```text
 #1 Reddit source must stop unauthenticated .json scraping
-   https://git.wilkensxl.de/MrSphay/intelligence-terminal/issues/1
+   https://git.wilkensxl.de/Code-Inc/intelligence-terminal/issues/1
 
 #2 Send operator alerts when dashboard data remains stale
-   https://git.wilkensxl.de/MrSphay/intelligence-terminal/issues/2
+   https://git.wilkensxl.de/Code-Inc/intelligence-terminal/issues/2
 
 #3 ACLED credentialed integration needs regression test and diagnostics
-   https://git.wilkensxl.de/MrSphay/intelligence-terminal/issues/3
+   https://git.wilkensxl.de/Code-Inc/intelligence-terminal/issues/3
 
 #4 Complete memory and prediction loop beyond Phase-1 SQLite
-   https://git.wilkensxl.de/MrSphay/intelligence-terminal/issues/4
+   https://git.wilkensxl.de/Code-Inc/intelligence-terminal/issues/4
 
 #5 Remove old inline dashboard snapshot from production builds
-   https://git.wilkensxl.de/MrSphay/intelligence-terminal/issues/5
+   https://git.wilkensxl.de/Code-Inc/intelligence-terminal/issues/5
 
 #6 Harden Terminal Actions for public reverse-proxy deployments
-   https://git.wilkensxl.de/MrSphay/intelligence-terminal/issues/6
+   https://git.wilkensxl.de/Code-Inc/intelligence-terminal/issues/6
 
 #7 Replace ADS-B stub with real disabled/degraded source handling
-   https://git.wilkensxl.de/MrSphay/intelligence-terminal/issues/7
+   https://git.wilkensxl.de/Code-Inc/intelligence-terminal/issues/7
 
 #8 Clean inherited public-demo and upstream marketing references
-   https://git.wilkensxl.de/MrSphay/intelligence-terminal/issues/8
+   https://git.wilkensxl.de/Code-Inc/intelligence-terminal/issues/8
 ```
 
 ## Verification Already Performed
@@ -371,7 +386,7 @@ Audit result:
 0 high vulnerabilities
 ```
 
-Docker build and smoke test were performed locally earlier:
+Docker build and smoke test were performed locally earlier against the now-legacy `mrsphay` image namespace. Current deployments must use the `code-inc` image documented above:
 
 ```bash
 docker build -t git.wilkensxl.de/mrsphay/intelligence-terminal:latest .
@@ -425,7 +440,7 @@ origin/main
 1. Clone the Gitea repository:
 
 ```bash
-git clone https://git.wilkensxl.de/MrSphay/intelligence-terminal.git
+git clone https://git.wilkensxl.de/Code-Inc/intelligence-terminal.git
 cd intelligence-terminal
 git checkout codex/production-intelligence-terminal
 ```
@@ -490,5 +505,5 @@ docker pull git.wilkensxl.de/code-inc/intelligence-terminal:latest
 For a pinned deployment:
 
 ```bash
-docker pull git.wilkensxl.de/code-inc/intelligence-terminal:YYYYMMDD
+docker pull git.wilkensxl.de/code-inc/intelligence-terminal:20260703
 ```