v1.3.1

# Release Notes - v1.3.1

Release Date: January 10, 2026

## Overview

Version 1.3.1 is a maintenance release focused on bug fixes, documentation improvements, and development workflow enhancements. This release addresses several critical issues around file uploads, database persistence, and logging noise, while also adding Claude Code GitHub Actions integration and MCP documentation.

## 🐛 Bug Fixes

### File Upload Improvements
- **Increased proxy body size limit** (#405)
  - Raised Next.js proxy buffer limit from 10MB to 100MB
  - Allows larger files (MP3s, PDFs, videos) to upload successfully
  - Fixes upload failures for files larger than 10MB

- **Added CORS headers to error responses** (#404)
  - Custom exception handler ensures CORS headers are included in HTTP error responses
  - Prevents browser blocking when errors occur behind reverse proxies
  - Added comprehensive reverse proxy documentation with troubleshooting for nginx, traefik, kubernetes ingress, and caddy

- **Fixed TypeScript build failure** (#406)
  - Added type assertion for Next.js experimental `proxyClientMaxBodySize` config
  - Resolves CI build failures while maintaining type safety

### Database & Model Management
- **Fixed model duplicate check** (#402)
  - Changed uniqueness constraint from `(provider, name)` to `(provider, name, type)`
  - Users can now add the same model name for different purposes (e.g., language model vs embedding model)

- **Fixed SurrealDB persistent storage in docs** (#400)
  - Changed storage from `memory` to `rocksdb:/mydata/mydatabase.db` in all docker-compose documentation
  - Data now persists across container restarts

### Logging Improvements
- **Reduced retry log noise** (#380)
  - Changed RuntimeError logging from ERROR → DEBUG level
  - Eliminated hundreds of scary ERROR messages during large document processing
  - Increased retry resilience: 5→15 attempts, 30s→120s max wait time
  - Clean logs at INFO level - transaction conflicts only visible with `--log-level DEBUG`

- **Removed debug prefixes** (#382)
  - Cleaned up leftover "DEBUG - " prefixes from production error logs
  - Improves log readability

## ✨ Features

### Claude Code Integration (#403)
- Added GitHub Actions workflow for Claude Code integration
- Enables AI-powered assistance via @claude mentions in PRs and issues
- Supports bug fixes, documentation updates, feature implementation, code reviews, and test writing
- Secure with API key stored as GitHub Actions secret

### MCP Integration Documentation (#396)
- Added MCP integration documentation to README
- Created dedicated integration guide at `docs/5-CONFIGURATION/mcp-integration.md`
- Based on community contribution by @Epochal-dev

## 📚 Documentation

- **Added pull_policy to docker-compose examples** (#395)
  - Ensures Docker always checks for and pulls newer images with `pull_policy: always`
  - Updated across 9 documentation files with 16 service definitions

- **Clarified Ollama API base URL** (#387)
  - Improved docker-compose.md with clearer Ollama configuration guidance
  - Contributed by @M-Amrollahi

- **Fixed README assets** (#386)
  - Restored missing logo and screenshot images
  - Contributed by @jonigl

## 🔧 Chores & CI Improvements

- **Optimized CI workflow** (#407)
  - Removed single-container Docker build from development workflow
  - Cuts PR build time roughly in half
  - Single-container build still available in production `build-and-release` workflow

- **Removed unused AddButton component** (#394)
  - Cleaned up dead code that was never integrated into the UI
  - Notebook creation fully functional via existing UI paths

## 🙏 Contributors

Thank you to our contributors for this release:
- @lfnovo
- @M-Amrollahi
- @jonigl
- @thesohamdatta
- @Epochal-dev

## Upgrade Notes

This release is a drop-in replacement for v1.3.0. No breaking changes or migration steps required.

### Recommended Actions After Upgrade
1. If using docker-compose, update your configuration to use persistent RocksDB storage (see #400)
2. If behind a reverse proxy, review the new troubleshooting guide for file upload limits (see #404)
3. Consider adding `pull_policy: always` to your docker-compose files (see #395)

## Full Changelog

**All merged PRs since v1.3.0:**
- #407: ci: remove single-container build from dev workflow
- #406: fix: add type assertion for experimental proxyClientMaxBodySize config
- #405: fix: increase Next.js proxy body size limit for file uploads
- #404: fix: add CORS headers to error responses and document file upload limits
- #403: Add Claude Code GitHub Workflow
- #402: fix: include type in model duplicate check
- #400: fix: use persistent rocksdb storage instead of memory in docker-compose docs
- #396: feat: add MCP integration documentation
- #395: docs: add pull_policy always to docker-compose examples
- #394: chore: remove unused AddButton component
- #387: Update Doc for docker compose
- #386: docs: fix removed assets affecting README.md
- #382: Remove debug prefixes from production error logging
- #380: fix: reduce retry log noise during concurrent chunk processing

---

For more information, visit:
- **Documentation**: https://open-notebook.ai
- **Discord**: https://discord.gg/37XJPXfz2w
- **GitHub**: https://github.com/lfnovo/open-notebook