Skip to content

v3.0.0 — Modernization release

Choose a tag to compare

@rajivpant rajivpant released this 25 Apr 07:14
· 151 commits to main since this release

Highlights

  • Pgvector by default. PostgreSQL with the pgvector extension is the default vector backend, replacing embedded Qdrant. Native full-text search via tsvector + GIN replaces in-process BM25. The legacy embedded Qdrant backend remains as an opt-in fallback (RAGBOT_VECTOR_BACKEND=qdrant).
  • Agent Skills as first-class content. Discover and index Agent Skills (SKILL.md plus references and scripts) from ~/.synthesis/skills, ~/.claude/skills, and plugin caches. New ragbot skills {list,info,index} CLI. The compiler can include skills via a sources.skills block in compile-config.yaml.
  • Workspace-rooted layout. AI Knowledge repos are discovered across ~/workspaces/*/ai-knowledge-* and via the synthesis-engineering shared ~/.synthesis/console.yaml source list. Configuration moved to ~/.synthesis/ (legacy ~/.config/ragbot/ falls through).
  • Reasoning / thinking modes. Models that advertise thinking support (Claude Sonnet 4.6, Claude Opus 4.7, GPT-5.5, GPT-5.5-pro, Gemini 3.x) are wired through LiteLLM's reasoning_effort. Flagship models default to medium; override per-call (--thinking-effort high) or globally (RAGBOT_THINKING_EFFORT).
  • Cross-workspace retrieval. get_relevant_context auto-merges results from the user's selected workspace and the canonical skills workspace via reciprocal rank fusion. Disable with --no-skills.

API additions

  • /api/chat accepts thinking_effort and additional_workspaces fields.
  • /api/config and /health report the active vector_backend (backend name, health, version, workspaces count).

Models (engines.yaml)

  • Anthropic: Haiku 4.5, Sonnet 4.6 (default), Opus 4.7.
  • OpenAI: GPT-5.4-mini, GPT-5.5, GPT-5.5-pro (flagship).
  • Google: Gemini 3.1 Flash Lite, Gemini 3 Flash (default), Gemini 3.1 Pro (flagship).

Dependency notes

  • litellm pinned >=1.83.0 (post-supply-chain-incident range; avoid 1.82.7-1.82.8).
  • Direct google-generativeai usage migrated to google-genai (the legacy SDK is end-of-life).
  • 259 tests pass on the release SHA.

Breaking changes

  • Vector backend default flipped to pgvector. Existing Qdrant users can opt back in with RAGBOT_VECTOR_BACKEND=qdrant. Postgres + pgvector is required for the default path; see CONFIGURE.md.
  • Configuration home moved to ~/.synthesis/. Legacy ~/.config/ragbot/{keys,config}.yaml is read as a fallback.

Setup

See README.md, CONFIGURE.md, and README-DOCKER.md for setup instructions.