v2026.05.16.1: odilo-developer fixes

Changes

fix(adf): Restart ADF via systemd as alex user

Claude Code was failing authentication because the ADF was running as root (manual restart). Claude Code OAuth tokens are user-scoped and not accessible to root, causing all Claude-based agents to fail with "not logged in" errors and exit via the fallback (kimi-for-coding/k2p5) which was hanging silently.

• Restarted ADF via (runs as User=alex)
• Added PATH override in systemd service () so claude binary is resolvable
• Removed duplicate user-level systemd service that was crash-looping
• All 3 Claude model probes now passing: sonnet, opus, haiku

fix(orchestrator): WARN log when project_by_id returns None

When an agent's configured project_id was not found in the config (e.g., after restart), the ADF silently fell back to the orchestrator's working_dir, causing agents to work on the wrong repo. A recent odilo-developer worktree was observed containing terraphim-ai code instead of odilo code due to this silent fallback.

• Added WARN-level log with agent name, requested project_id, and fallback path
• Enables operators to detect and fix project resolution failures

Release 2026-05-16

Summary

• Cron scheduler fix: prevent agents from re-triggering within same schedule window (fixes 130+ fires issue)
• RLM executor hardening
• Agent search envelope improvements
• OpenCode hook improvements

##包含的提交
068c10e fix(rlm): harden executor surface, agent search envelope, and OpenCode hook (#870)
9832fc9 docs: add handover for evolution wiring session
07b002e feat(orchestrator): wire terraphim_agent_evolution into ADF orchestrator (#1487)
5b5ef40 docs: add handover for ADF orchestrator investigation and fix
4442671 Merge remote-tracking branch 'origin/main'
c018f36 fix(adf-setup): update stale /home/alex/terraphim-ai paths to canonical path
2d41798 fix(agent): populate concepts_matched in robot-mode search envelope (#1486)
e8febcb feat(terraphim_rlm): implement DockerExecutor for container-based isolation (#1485)
669beba feat(terraphim_rlm): implement DockerExecutor for container-based isolation
45e9df1 feat(examples): add opencode-plugin-rlm with OpenCode plugin and Claude Code hook
c836433 Merge remote-tracking branch 'origin/main'
e4d896d feat(terraphim_rlm): add LocalExecutor backend for local code execution
ce1ba57 Merge remote-tracking branch 'origin/main'
f96b8b9 chore(adf): split implementation-swarm into 2 agents, disable broken safety agents
baca48b Merge pull request 'Fix #1459: add unit tests for apply_min_quality_filter' (#1460) from task/1459-min-quality-filter-tests into main
6002ab0 docs(spec): mark Task 1.6 complete -- tests exist since 2026-05-11
9c9cd31 fix(test): remove unused Path import and widen config-set exit code assertion
42d6f2a docs: update CHANGELOG and doc report for session 2026-05-14
365e5ab fix(service): clamp min_quality threshold and add negative-threshold test Refs #1459
c074fb7 docs(server): add rustdoc to all public items in terraphim_server
6f040be test(service): add unit tests for apply_min_quality_filter Refs #1459
64b5999 Merge pull request 'feat(gitea_skill_loader): load SKILL.md files from Gitea at startup Refs #1434' (#1450) from task/1434-gitea-skill-loading into main
8599cf0 Merge pull request 'Fix #547: add QualityScore to IndexedDocument with min_quality filtering' (#1456) from task/547-quality-scores-indexed-document into main
6da5261 feat(types): add QualityScore to IndexedDocument and Document Refs #547
b12ca99 docs: add rustdoc to undocumented public types in core crates Refs #547
704f1f3 style(gitea_skill_loader): fix cargo fmt and mod declaration ordering Refs #1434
afd8003 fix(gitea_skill_loader): use api endpoint for raw content to support SHA refs Refs #1434
df1e634 fix(webhook): resolve project from repo for unqualified @adf: mentions
e7cbcc8 fix(provider_probe): increase probe timeout from 60s to 120s
dba0a3f feat(orchestrator): trigger fallback provider on rate_limit exit when KG routing fails
5a8411b docs: add validation and verification reports for ADF config validation
f995463 feat(orchestrator): add ADF config validation for grace_period, max_cpu, and probe_ttl
b58c174 docs: add disciplined research on Gitea-based config loading Refs #IDX

v1.17.0: KG-boosted file search

What's New

KG-Boosted File Search

• terraphim_file_search crate: New crate providing KgPathScorer that uses Aho-Corasick automata from the knowledge graph to boost file search results matching domain terms
• MCP integration: find_files and grep_files tools in the MCP server now support KG-boosted scoring
• Directory watcher: KgWatcher monitors thesaurus directories and hot-reloads the scorer when files change
• Benchmarks: Criterion benchmarks for KG scoring performance

Usage Tracking

• terraphim_usage and terraphim_ccusage crates for token tracking
• CLI commands for querying token usage statistics

Agent Orchestration

• MentionDetector for @agent: mention dispatch
• OutputPoster and drain-before-drop in poll_agent_exits
• Wall-clock timeout with fallback respawn

Improvements

• ID types reverted from String/UUID to u64 integer for consistency
• Custom SQLite store replaced with terraphim_persistence
• zlob feature flag enabled in CI for faster glob matching (Zig 0.15.2)

Full Changelog: v1.16.0...v1.17.0

v1.19.0

Release Assets

macOS Universal Binaries (Intel + Apple Silicon)

Signed and Notarized - No Gatekeeper warnings

• terraphim_server-universal-apple-darwin: Server binary for all Macs
• terraphim-agent-universal-apple-darwin: TUI binary for all Macs

Server Binaries

• terraphim_server-*: Server binaries for various platforms

TUI Binaries

• terraphim-agent-*: Terminal UI binaries for various platforms

Desktop Applications

Desktop applications are now built and released separately in the terraphim-ai-desktop repository.

• *.dmg: macOS desktop installer
• *.AppImage: Linux portable desktop app
• *.msi, *.exe: Windows desktop installers

Debian Packages

• *.deb: Debian/Ubuntu packages for easy installation

Docker Images

• ghcr.io/terraphim/terraphim-server:latest: Multi-arch server image

Installation

# Install via Homebrew (macOS/Linux)
brew tap terraphim/terraphim
brew install terraphim-server
brew install terraphim-agent

# Install Debian package (Ubuntu/Debian)
sudo dpkg -i terraphim-server_*.deb

# Run with Docker
docker run ghcr.io/terraphim/terraphim-server:latest

See checksums.txt for file integrity verification.

v1.16.37

Release Assets

macOS Universal Binaries (Intel + Apple Silicon)

Signed and Notarized - No Gatekeeper warnings

• terraphim_server-universal-apple-darwin: Server binary for all Macs
• terraphim-agent-universal-apple-darwin: TUI binary for all Macs

Server Binaries

• terraphim_server-*: Server binaries for various platforms

TUI Binaries

• terraphim-agent-*: Terminal UI binaries for various platforms

Desktop Applications

Desktop applications are now built and released separately in the terraphim-ai-desktop repository.

• *.dmg: macOS desktop installer
• *.AppImage: Linux portable desktop app
• *.msi, *.exe: Windows desktop installers

Debian Packages

• *.deb: Debian/Ubuntu packages for easy installation

Docker Images

• ghcr.io/terraphim/terraphim-server:latest: Multi-arch server image

Installation

# Install via Homebrew (macOS/Linux)
brew tap terraphim/terraphim
brew install terraphim-server
brew install terraphim-agent

# Install Debian package (Ubuntu/Debian)
sudo dpkg -i terraphim-server_*.deb

# Run with Docker
docker run ghcr.io/terraphim/terraphim-server:latest

See checksums.txt for file integrity verification.

v1.16.36

Release Assets

macOS Universal Binaries (Intel + Apple Silicon)

Signed and Notarized - No Gatekeeper warnings

• terraphim_server-universal-apple-darwin: Server binary for all Macs
• terraphim-agent-universal-apple-darwin: TUI binary for all Macs

Server Binaries

• terraphim_server-*: Server binaries for various platforms

TUI Binaries

• terraphim-agent-*: Terminal UI binaries for various platforms

Desktop Applications

Desktop applications are now built and released separately in the terraphim-ai-desktop repository.

• *.dmg: macOS desktop installer
• *.AppImage: Linux portable desktop app
• *.msi, *.exe: Windows desktop installers

Debian Packages

• *.deb: Debian/Ubuntu packages for easy installation

Docker Images

• ghcr.io/terraphim/terraphim-server:latest: Multi-arch server image

Installation

# Install via Homebrew (macOS/Linux)
brew tap terraphim/terraphim
brew install terraphim-server
brew install terraphim-agent

# Install Debian package (Ubuntu/Debian)
sudo dpkg -i terraphim-server_*.deb

# Run with Docker
docker run ghcr.io/terraphim/terraphim-server:latest

See checksums.txt for file integrity verification.

v1.16.35

Release Assets

macOS Universal Binaries (Intel + Apple Silicon)

Signed and Notarized - No Gatekeeper warnings

• terraphim_server-universal-apple-darwin: Server binary for all Macs
• terraphim-agent-universal-apple-darwin: TUI binary for all Macs

Server Binaries

• terraphim_server-*: Server binaries for various platforms

TUI Binaries

• terraphim-agent-*: Terminal UI binaries for various platforms

Desktop Applications

Desktop applications are now built and released separately in the terraphim-ai-desktop repository.

• *.dmg: macOS desktop installer
• *.AppImage: Linux portable desktop app
• *.msi, *.exe: Windows desktop installers

Debian Packages

• *.deb: Debian/Ubuntu packages for easy installation

Docker Images

• ghcr.io/terraphim/terraphim-server:latest: Multi-arch server image

Installation

# Install via Homebrew (macOS/Linux)
brew tap terraphim/terraphim
brew install terraphim-server
brew install terraphim-agent

# Install Debian package (Ubuntu/Debian)
sudo dpkg -i terraphim-server_*.deb

# Run with Docker
docker run ghcr.io/terraphim/terraphim-server:latest

See checksums.txt for file integrity verification.

v1.16.34

Release Assets

macOS Universal Binaries (Intel + Apple Silicon)

Signed and Notarized - No Gatekeeper warnings

• terraphim_server-universal-apple-darwin: Server binary for all Macs
• terraphim-agent-universal-apple-darwin: TUI binary for all Macs

Server Binaries

• terraphim_server-*: Server binaries for various platforms

TUI Binaries

• terraphim-agent-*: Terminal UI binaries for various platforms

Desktop Applications

Desktop applications are now built and released separately in the terraphim-ai-desktop repository.

• *.dmg: macOS desktop installer
• *.AppImage: Linux portable desktop app
• *.msi, *.exe: Windows desktop installers

Debian Packages

• *.deb: Debian/Ubuntu packages for easy installation

Docker Images

• ghcr.io/terraphim/terraphim-server:latest: Multi-arch server image

Installation

# Install via Homebrew (macOS/Linux)
brew tap terraphim/terraphim
brew install terraphim-server
brew install terraphim-agent

# Install Debian package (Ubuntu/Debian)
sudo dpkg -i terraphim-server_*.deb

# Run with Docker
docker run ghcr.io/terraphim/terraphim-server:latest

See checksums.txt for file integrity verification.

v1.16.33

Release Assets

macOS Universal Binaries (Intel + Apple Silicon)

Signed and Notarized - No Gatekeeper warnings

• terraphim_server-universal-apple-darwin: Server binary for all Macs
• terraphim-agent-universal-apple-darwin: TUI binary for all Macs

Server Binaries

• terraphim_server-*: Server binaries for various platforms

TUI Binaries

• terraphim-agent-*: Terminal UI binaries for various platforms

Desktop Applications

Desktop applications are now built and released separately in the terraphim-ai-desktop repository.

• *.dmg: macOS desktop installer
• *.AppImage: Linux portable desktop app
• *.msi, *.exe: Windows desktop installers

Debian Packages

• *.deb: Debian/Ubuntu packages for easy installation

Docker Images

• ghcr.io/terraphim/terraphim-server:latest: Multi-arch server image

Installation

# Install via Homebrew (macOS/Linux)
brew tap terraphim/terraphim
brew install terraphim-server
brew install terraphim-agent

# Install Debian package (Ubuntu/Debian)
sudo dpkg -i terraphim-server_*.deb

# Run with Docker
docker run ghcr.io/terraphim/terraphim-server:latest

See checksums.txt for file integrity verification.

v1.16.31

Release Assets

macOS Universal Binaries (Intel + Apple Silicon)

Signed and Notarized - No Gatekeeper warnings

• terraphim_server-universal-apple-darwin: Server binary for all Macs
• terraphim-agent-universal-apple-darwin: TUI binary for all Macs

Server Binaries

• terraphim_server-*: Server binaries for various platforms

TUI Binaries

• terraphim-agent-*: Terminal UI binaries for various platforms

Desktop Applications

Desktop applications are now built and released separately in the terraphim-ai-desktop repository.

• *.dmg: macOS desktop installer
• *.AppImage: Linux portable desktop app
• *.msi, *.exe: Windows desktop installers

Debian Packages

• *.deb: Debian/Ubuntu packages for easy installation

Docker Images

• ghcr.io/terraphim/terraphim-server:latest: Multi-arch server image

Installation

# Install via Homebrew (macOS/Linux)
brew tap terraphim/terraphim
brew install terraphim-server
brew install terraphim-agent

# Install Debian package (Ubuntu/Debian)
sudo dpkg -i terraphim-server_*.deb

# Run with Docker
docker run ghcr.io/terraphim/terraphim-server:latest

See checksums.txt for file integrity verification.