rdmsm4x-changelog-20260827-1603-litellm-mem0-ollama-boundary
rdmsm4x-changelog-20260827-1603-litellm-mem0-ollama-boundary
Recorded independently reproduced Mem0/Ollama authority and dependency identities in LiteLLM documentation so future routing work preserves the separate memory plane and cannot treat proposed aliases as configured.
Scope
- Host:
rdmsm4x - Canonical project:
/Users/richh/dev/localAI/litellm - Isolated worktree:
/Users/richh/dev/_worktrees/codex-litellm-qa-agent-20260827 - Branch:
codex/litellm-qa-agent-20260827 - Commit:
eb15041c7dcd73803e68e0366a8e9da27285da72 - Source coordination task:
01a0409d-475e-7ee1-bfa9-4a0f536ff9fe - Privacy: metadata only; no credentials, prompts, responses, Mem0 records, model blobs, or retired-worktree contents accessed
Files changed
/Users/richh/dev/_worktrees/codex-litellm-qa-agent-20260827/SESSION-STATE.md/Users/richh/dev/_worktrees/codex-litellm-qa-agent-20260827/ISSUES.md/Users/richh/dev/_worktrees/codex-litellm-qa-agent-20260827/docs/architecture-and-routing-design-2026-08-26.md/Users/richh/.agent-coordination/checkins/codex-litellm-mem0-ollama-coordination-20260827-1600.md- This changelog file
What changed
- Recorded accepted Mem0 authority as Compose project
mem0-localfrom the clean Mem0 task worktree at commit7079ac107ff2f3c9a3cf187c2bec9f5656cf24e1. - Recorded the competing Compose project
mem0localas retired and preserve-only, with zero containers and zero project networks. - Recorded exact loopback boundaries: LiteLLM
127.0.0.1:4000, Mem0 API127.0.0.1:8767, Ollama127.0.0.1:11434, and no Qdrant host port. - Recorded exact Ollama model identities for the Mem0 reasoner and 2,560-dimensional embedder.
- Added
LITELLM-014to keeplocal-memory-reasonerandlocal-memory-embedding-2560blocked and unconfigured until explicit approval plus separate chat/embeddings capability, resource, restart, failure, and rollback canaries. - Preserved the rule that clients call Mem0 separately and LiteLLM never proxies Mem0, copies its credential, ingests memory automatically, or acts as a prompt/query cache.
Commands and verification evidence
- Resolved the host with
scutil --get ComputerName:rdmsm4x. - Synced fleet check-ins and inspected released LiteLLM ownership before writing.
- Reproduced Git authority with
git rev-parse, branch, and porcelain status checks:- canonical LiteLLM
mainremained clean at74caa92e3bacae28b33d61cd16140204099ad70a; - isolated LiteLLM branch began clean at
aceaf5389ef82255c7749bb3fa28555feb6f6af3; - accepted Mem0 worktree was clean at
7079ac107ff2f3c9a3cf187c2bec9f5656cf24e1; - retired Mem0 worktree remained at
d56c3d5440221f4597e22aee7826305e896d4444, with no tracked delta and 20 untracked file entries under fully expanded status.
- canonical LiteLLM
- Queried Docker name/status/port metadata only;
mem0-api,mem0-qdrant, andlitellm-loopback-canarywere healthy. The retired Compose project had zero containers and zero networks; its preserved named volume remained present. - Queried non-secret loopback health/model metadata only:
- LiteLLM health HTTP 200 and model list exactly
agent-local; - Mem0 health
ok,mem0_shared_v1, 2,560 dimensions, the recorded reasoner/embedder, and explicit-literal capture; - Ollama
0.33.1, exact dependency digests present, neither dependency resident.
- LiteLLM health HTTP 200 and model list exactly
zsh tests/validate-static.zsh: 60 checks, zero failures.zsh tests/validate-qa-static.zsh: 10 checks, zero failures.python3 -m unittest tests.test_qa_agent: 6 tests,OK.- Documentation integrity/path guard and
git diff --check: passed; only the three intended Markdown files changed before commit. gitleaks detect --source . --no-git --redact --no-banner: no leaks found.- The runtime-mutating rollback suite was deliberately not run because it requires stopping the accepted live canary and this coordination pass authorized no runtime mutation.
Backups and rollback
- No pre-existing file was overwritten outside the isolated Git
worktree; Git commit
eb15041c7dcd73803e68e0366a8e9da27285da72is the recoverable change boundary. - To undo only this documentation alignment, revert that commit on
branch
codex/litellm-qa-agent-20260827after confirming no later dependent commit. - Do not delete the retired Mem0 worktree or its preserved named volume as part of rollback.
Outstanding owner actions
- Decide whether the two proposed model identities should ever be LiteLLM aliases or remain direct Mem0/Ollama dependencies.
- Any implementation still requires explicit approval and the
LITELLM-014canary gates. - The isolated LiteLLM branch remains unmerged; no push or canonical-main integration occurred.
- Apple Notes mirror remains pending because the shared publisher's documented deletion/count hazard has not been cleared; this Markdown file is the durable archive.