v1.3.0

# Open Notebook v1.3.0

This release brings a comprehensive refactoring of the codebase structure and a complete overhaul of the documentation system, focusing on improved maintainability, better code organization, and enhanced developer experience.

## 🎯 Highlights

- **Complete documentation restructure** with new numbered organization (0-7) for better navigation
- **Code reorganization** into dedicated modules (AI, podcasts, database)
- **CLAUDE.md reference files** across the entire codebase for AI-assisted development
- **Updated dependencies** including all LangChain packages to latest major versions
- **Enhanced developer experience** with streamlined documentation and improved dev commands

## 🔧 Code Organization

### New Module Structure
- Created `open_notebook/ai/` module for AI/model code
  - Moved `domain/models.py` → `ai/models.py`
  - Moved `graphs/utils.py` → `ai/provision.py`
- Created `open_notebook/podcasts/` module
  - Moved `domain/podcast.py` → `podcasts/models.py`
  - Removed deprecated `plugins/podcasts.py`
- Moved migrations: `/migrations/` → `open_notebook/database/migrations/`
- Reorganized prompts into subdirectories by type

## 📚 Documentation Overhaul

### New Structure (18,000+ line changes)
Removed old scattered documentation and introduced a numbered hierarchy:

- **0-START-HERE/** - Quick start guides (local, cloud, OpenAI)
- **1-INSTALLATION/** - Docker Compose, from source, single container
- **2-CORE-CONCEPTS/** - Notebooks, RAG, chat vs transformations, podcasts
- **3-USER-GUIDE/** - Complete user documentation with examples
- **4-AI-PROVIDERS/** - Provider configuration and setup
- **5-CONFIGURATION/** - Environment, security, reverse proxy, advanced
- **6-TROUBLESHOOTING/** - Connection issues, AI issues, FAQ, quick fixes
- **7-DEVELOPMENT/** - Architecture, API reference, contributing, testing

### CLAUDE.md Reference Documentation
Added comprehensive AI-assistant guidance files:
- Root `CLAUDE.md` - Project overview and architecture
- `api/CLAUDE.md` - FastAPI structure and patterns
- `frontend/src/CLAUDE.md` + subdirectories - React architecture
- `open_notebook/CLAUDE.md` + all submodules - Backend components
- `prompts/CLAUDE.md` - Prompt engineering guidance
- `commands/CLAUDE.md` - Command patterns

## ⬆️ Dependency Updates

- Updated all LangChain dependencies to latest major versions
- Cleaner dependency specifications in `pyproject.toml`
- Regenerated `uv.lock` with updated dependency tree

## 📖 Developer Experience

- **Streamlined README.md** for quick project overview
- **New README.dev.md** with detailed developer documentation
- **Updated Makefile** with improved development commands
- **Removed deprecated files**: MIGRATION.md, batch_fix_services.py
- **Enhanced guides**: CONFIGURATION.md, CONTRIBUTING.md

## 📊 Statistics

- **180 files changed**
- **+19,192 insertions, -18,302 deletions**
- No breaking changes - maintains full backward compatibility

## 🔄 Migration Notes

No migration required for users. All changes are internal to the codebase structure. The public API remains unchanged.

## 🐛 Bug Fixes

- Fixed migration path references in all documentation
- Updated AsyncMigrationManager to correctly reference new migration location

## 🙏 Contributors

This release represents a significant effort to improve the codebase organization and documentation quality for better long-term maintainability.

---

**Full Changelog**: https://github.com/lfnovo/open-notebook/compare/v1.2.4...v1.3.0