Terraphim AI v1.21.3

Release date: 2026-08-16

Highlights

This patch restores the extracted orchestrator integration on canonical main and hardens native agent execution.

Fixed

Re-included terraphim_orchestrator in the workspace and repointed its extracted dependencies to the canonical registry packages.
Ensured an agent's configured working directory exists before spawning the child process.
Removed native-CI Clippy blockers and closed the spawner stdin handoff race.
Corrected the stale author_is_agent review test after its signature changed.

Validation

Dynamic-routing golden tests now assert that provider selection is data-driven rather than hard-coded.
The release candidate is version-bound to 1.21.3; the comprehensive tag workflow must verify terraphim_server --version metadata against v1.21.3 before building artifacts.

Source

Canonical source: terraphim/terraphim-ai on Gitea. The exact annotated tag is mirrored to GitHub; both release objects must resolve to the same commit.

Terraphim client channel alignment — v1.21.2

This release marker aligns the public Terraphim release channel with the canonical private Gitea Cargo release 1.21.2.

Canonical package evidence:

terraphim_grep 1.21.2: exact private-registry clean-root install and functional smoke passed.
terraphim_agent 1.21.2: immutable repair published; exact locked clean-root install, provenance, version, and guard smoke passed.
Release Guardian exact-package enforcement is merged in private/cto-executive-system#86; final pass evidence is merged in #88.

The private Gitea Cargo registry remains authoritative for fleet package installation. Public crates.io mirrors may lag and are not substituted for canonical proof.

Tooling-only release. The release-guardian probe now surfaces actual smoke stdout (chunks=/reported= numbers + MISMATCH flag) for the R7 install-smoke checks. No source code changes from v1.21.0.

Node.js Package Release

Package: @terraphim/autocomplete
Version: patch
Tag: latest

Installation

npm install @terraphim/autocomplete@latest --registry=https://npm.pkg.github.com

Features

Autocomplete: Fast prefix search with scoring
Knowledge Graph: Semantic connectivity analysis
Native Performance: Rust backend with NAPI bindings
Cross-Platform: Linux, macOS, Windows support
TypeScript: Auto-generated type definitions

Performance

Autocomplete Index: ~749 bytes
Knowledge Graph: ~856 bytes
Native Library: ~10MB (optimized for production)

Links

🤖 Generated on: $(date)

What's new

KG validation in execution hot paths

KnowledgeGraphValidator wired into Firecracker/Docker/Local executors
QueryLoop validation with LLM context feedback (not error-out)
ValidationEvent hooks for agent learning/security capture

LLM auto-configuration with smart routing

auto_configure_llm() with Ollama + OpenRouter capability routing
RouterBridgeLlmClient with CapabilityFirst strategy
rlm_query returns real LLM responses (was LlmNotConfigured)

Verification

127 tests pass, clippy clean

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
terraphim-grep-universal-apple-darwin: Hybrid grep CLI for all Macs

Server Binaries

terraphim_server-*: Server binaries for various platforms

TUI Binaries

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

Grep Binaries

terraphim-grep-*: Hybrid grep CLI (knowledge-graph boost + LLM fallback)
for various platforms. See
crates/terraphim_grep/RELEASE_NOTES_v1.20.0.md
for crate-focused details.

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.

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
terraphim-grep-universal-apple-darwin: Hybrid grep CLI for all Macs

Server Binaries

terraphim_server-*: Server binaries for various platforms

TUI Binaries

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

Grep Binaries

terraphim-grep-*: Hybrid grep CLI (knowledge-graph boost + LLM fallback)
for various platforms. See
crates/terraphim_grep/RELEASE_NOTES_v1.20.0.md
for crate-focused details.

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.

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
terraphim-grep-universal-apple-darwin: Hybrid grep CLI for all Macs

Server Binaries

terraphim_server-*: Server binaries for various platforms

TUI Binaries

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

Grep Binaries

terraphim-grep-*: Hybrid grep CLI (knowledge-graph boost + LLM fallback)
for various platforms. See
crates/terraphim_grep/RELEASE_NOTES_v1.20.0.md
for crate-focused details.

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.

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
terraphim-grep-universal-apple-darwin: Hybrid grep CLI for all Macs

Server Binaries

terraphim_server-*: Server binaries for various platforms

TUI Binaries

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

Grep Binaries

terraphim-grep-*: Hybrid grep CLI (knowledge-graph boost + LLM fallback)
for various platforms. See
crates/terraphim_grep/RELEASE_NOTES_v1.20.0.md
for crate-focused details.

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.

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
terraphim-grep-universal-apple-darwin: Hybrid grep CLI for all Macs

Server Binaries

terraphim_server-*: Server binaries for various platforms

TUI Binaries

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

Grep Binaries

terraphim-grep-*: Hybrid grep CLI (knowledge-graph boost + LLM fallback)
for various platforms. See
crates/terraphim_grep/RELEASE_NOTES_v1.20.0.md
for crate-focused details.

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.

Releases: terraphim/terraphim-ai

Release list