feat: add LiteLLM provider and Code-Inc image target

docs/agent-handoff.md

@@ -1,6 +1,17 @@
 # Agent Handoff
 
-Last updated: 2026-05-17
+Last updated: 2026-07-03
+
+## Current 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 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.
+- Related maintenance: issue #21 tracks the failing security scan, #45 tracks the dependency workflow, and #46 tracks remaining namespace/handoff cleanup.
 
 ## Repository State
 
@@ -15,7 +26,7 @@ C:\Users\MrSphay\Documents\Codex\Crucix\intelligence-terminal
 Remotes:
 
 ```text
-origin   https://git.wilkensxl.de/MrSphay/intelligence-terminal.git
+origin   https://git.wilkensxl.de/Code-Inc/intelligence-terminal.git
 upstream https://github.com/calesthio/Crucix.git
 ```
 
@@ -25,23 +36,22 @@ Current branch tip:
 Run `git rev-parse HEAD` after clone/pull. This handoff was updated by the `docs: sync issue tracker and handoff` commit after the implementation commit below.
 ```
 
-Latest implementation commit before issue-sync documentation:
+Production baseline before the current LiteLLM work:
 
 ```text
-53470cc701ec322080a89d220aef449b25850590
+c159c83a0768486c8c6f445b458b760dba4ba385
 ```
 
-Both pushed branches currently point to this commit:
+The default production branch points to this commit before the current PR:
 
 ```text
 origin/codex/production-intelligence-terminal
-origin/main
 ```
 
 Gitea repository:
 
 ```text
-https://git.wilkensxl.de/MrSphay/intelligence-terminal
+https://git.wilkensxl.de/Code-Inc/intelligence-terminal
 ```
 
 Default branch observed through the Gitea API:
@@ -79,7 +89,7 @@ Rules applied from the kit:
 - `docker-compose.yml` uses the Gitea Registry image by default:
 
 ```text
-git.wilkensxl.de/mrsphay/intelligence-terminal:latest
+git.wilkensxl.de/code-inc/intelligence-terminal:latest
 ```
 
 ### API And Health
@@ -226,32 +236,27 @@ README includes:
 
 ## Registry And Images
 
-Registry image:
+Target registry image after the current production merge:
 
 ```text
-git.wilkensxl.de/mrsphay/intelligence-terminal
+git.wilkensxl.de/code-inc/intelligence-terminal
 ```
 
-Verified package tags through Gitea API:
+The legacy `mrsphay` package remains available. Verify these new `code-inc` tags after the current runner publication:
 
 ```text
 latest
-20260517
-e933586b220656a2858d2215b934b22d1f08a908
-53470cc701ec322080a89d220aef449b25850590
+YYYYMMDD
+<production-commit-sha>
 ```
 
-Successful pull test:
+Required pull verification after publication:
 
 ```bash
-docker pull git.wilkensxl.de/mrsphay/intelligence-terminal:latest
+docker pull git.wilkensxl.de/code-inc/intelligence-terminal:latest
 ```
 
-Observed digest:
-
-```text
-sha256:780a41413921bd9a676461eca1cd1372591f523be4b7c9513d9bc085cbe7922d
-```
+Record the resulting digest after the runner push.
 
 ## Gitea Actions
 
@@ -460,7 +465,7 @@ if ($env:GITEA_TOKEN) { "GITEA_TOKEN=set" } else { "GITEA_TOKEN=missing" }
 ```bash
 npm run test:unit
 docker compose --env-file .env.example config
-docker pull git.wilkensxl.de/mrsphay/intelligence-terminal:latest
+docker pull git.wilkensxl.de/code-inc/intelligence-terminal:latest
 ```
 
 6. Start with Dockge/Pangolin using the README compose example and a `.env` based on `.env.example`.
@@ -479,11 +484,11 @@ docker pull git.wilkensxl.de/mrsphay/intelligence-terminal:latest
 For deployment:
 
 ```bash
-docker pull git.wilkensxl.de/mrsphay/intelligence-terminal:latest
+docker pull git.wilkensxl.de/code-inc/intelligence-terminal:latest
 ```
 
 For a pinned deployment:
 
 ```bash
-docker pull git.wilkensxl.de/mrsphay/intelligence-terminal:20260517
+docker pull git.wilkensxl.de/code-inc/intelligence-terminal:YYYYMMDD
 ```

docs/release-checklist.md

@@ -3,7 +3,7 @@
 1. Confirm `.env.example`, README compose sample, and registry image name match.
 2. Run `npm run test:unit`.
 3. Run `docker compose config`.
-4. Build `git.wilkensxl.de/mrsphay/intelligence-terminal:latest`.
+4. Build `git.wilkensxl.de/code-inc/intelligence-terminal:latest`.
 5. Start the image and verify `/api/health`.
 6. Push branch to Gitea.
 7. Push `latest` and a dated image tag to the Gitea Registry.