v0.1.0

# 🚀 Release v0.1.0

## 📝 Overview

This inaugural release of Archon Beta marks a major milestone as a comprehensive AI knowledge management system designed for local deployment. Built from the ground up with modern technologies, Archon serves as an operating system for AI coding assistants, featuring advanced RAG capabilities, project management, and seamless IDE integration through MCP (Model Context Protocol).

## ✨ What's New

### Major Features
- **Knowledge Management System** - Advanced RAG (Retrieval-Augmented Generation) with semantic search, web crawling, and document upload capabilities
- **Project Management** - Full project lifecycle management with tasks, documents, and version control
- **MCP Server Integration** - Native support for Claude Code, Cursor, Windsurf, and other AI IDEs through Model Context Protocol
- **Multi-LLM Provider Support** - Support for OpenAI, Anthropic, OpenRouter, Grok, Gemini, and Ollama with configurable models
- **Real-time Progress Tracking** - Live monitoring of crawling operations and long-running tasks
- **Document Browser** - Comprehensive document management with domain filtering and full-text search
- **Modern React UI** - Glassmorphism design with TanStack Query v5 for optimal performance

### Improvements
- **Hybrid Search Strategy** - Enhanced search combining vector embeddings with keyword matching using tsvector
- **Smart Polling Architecture** - Visibility-aware HTTP polling replacing WebSocket connections for better reliability
- **Optimistic Updates** - Instant UI feedback with UUID-based stable identifiers
- **ETag Caching** - Browser-native HTTP caching for 70% bandwidth reduction
- **Vertical Slice Architecture** - Feature-based organization for better maintainability
- **Comprehensive Error Handling** - Provider-agnostic error handling across all LLM providers
- **Docker Compose Profiles** - Flexible development environment with hybrid and full-docker modes

### Bug Fixes
- **Database Timeout Resolution** - Fixed timeout issues when deleting large knowledge sources
- **Crawler Stability** - Resolved memory crashes and timeout issues for JavaScript-heavy documentation sites
- **URL Resolution** - Fixed sitemap URL detection and recursive crawling edge cases
- **Task Priority Decoupling** - Separated task priority from display order for better UX
- **Provider Configuration** - Fixed Ollama default URL for Docker compatibility
- **Type Safety** - Resolved TypeScript strict mode errors across the codebase

## 🔧 Technical Changes

### Backend (Python/FastAPI)
- **FastAPI Server** - High-performance async API with comprehensive service layer pattern
- **Supabase Integration** - PostgreSQL with pgvector for advanced vector operations
- **PydanticAI Agents** - Specialized AI agents for document processing and code analysis
- **Async Architecture** - Full async/await implementation for optimal performance
- **Rate Limiting Protection** - Intelligent handling of LLM provider rate limits
- **Service Layer Pattern** - Clean separation between API routes, business logic, and data access

### Frontend (React/TypeScript)
- **TanStack Query v5** - Complete migration to modern data fetching with smart caching
- **Tailwind CSS 4** - Latest styling framework with custom glassmorphism theme
- **Biome + ESLint** - Dual linting setup for legacy and modern code patterns
- **Vite Build System** - Fast development and optimized production builds
- **Feature-based Architecture** - Vertical slices with self-contained features
- **Accessibility Improvements** - ARIA attributes and keyboard navigation support

### Infrastructure
- **Multi-service Docker Setup** - Separate containers for server, MCP, agents, and frontend
- **Development Profiles** - Hybrid development with backend in Docker, frontend local
- **CI/CD Pipeline** - Automated testing and linting with GitHub Actions
- **Package Management** - UV for Python dependencies, npm for frontend
- **Health Checks** - Comprehensive service monitoring and status endpoints

## 📊 Statistics
- **Commits:** 245
- **Pull Requests:** 0 (initial release)
- **Files Changed:** 500+ across frontend, backend, and documentation
- **Contributors:** 15

## 🙏 Contributors

Thanks to everyone who contributed to this release:
@Cole Medin @sean-eskerium @Wirasm @DIY Smart Code @Josh @Jonah Gray @John Fitzpatrick @leex279 @Rasmus Widing @Daniel Jankowski @Michael Hines @siparker @Nadjib Boubrim @Tim Carter @Arman Rafiee @Sanath Kumar U @Thilanga Pitigala @Eric Fisher @takshit12 @cannuri @Aniket @Hong @Michaelzag @Aniket1995 @Edilson Lima @BarelElbaz @Juan Miguel @xactant

## 📚 Documentation

- **Comprehensive README** - Detailed installation and usage instructions
- **Contributing Guidelines** - Clear guidelines for contributors
- **MCP Integration Docs** - Step-by-step setup for AI IDEs
- **Architecture Documentation** - Technical deep-dive into system design
- **Claude Code Instructions** - Specialized commands and agents for Claude Code
- **Development Setup** - Docker Compose profiles and hybrid development workflows

## ⚠️ Breaking Changes

- **Complete rewrite** - This is a ground-up rebuild from previous Archon versions
- **New database schema** - Fresh Supabase setup required
- **Configuration changes** - New environment variable structure
- **API endpoints** - RESTful API replacing previous patterns
- **Project structure** - Monorepo with separate frontend/backend directories

## 🔗 Links

- **Full Changelog:** https://github.com/coleam00/Archon/compare/c87bf3436044c8d38323d3bb20db69efb163cece...v0.1.0
- **Installation Guide:** See README.md for detailed setup instructions

---

**Note:** This is a beta release. Features may change rapidly. Report issues at: https://github.com/coleam00/Archon/issues

---