# Changelog All notable changes to Momentry Studio will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). --- ## [0.1.0] - 2026-10-11 ### ✨ Features #### Search Pagination - **Initial search returns top 5 results** for faster response - **"Load More" button** to fetch additional 10 results progressively - Supports all 5 search modes: Keyword, Semantic, Visual, Agent, People - **Deduplication logic** ensures no duplicate results across pages - **Remaining count display** shows how many results are left #### Library Management - **118 files display** correctly in Library view - **Unregistered files** show complete metadata (file_size, modified_time) - **Scene VLM status** always visible with "—" fallback for no data #### Pipeline Progress - **10-stage pipeline visualization** - Scene VLM stage added (3% weight) - Real-time progress tracking #### Advanced Mode Toggle - 🔒/🔓 Toggle button for advanced features - Controls visibility of QC buttons, marks, and advanced controls - Persists in localStorage --- ### 🐛 Bug Fixes #### Search Pagination - Fixed duplicate results in "Load More" button - Changed Visual search from `page` to `offset` parameter - Implemented `existingIds` Set for deduplication #### Library Display - Fixed file count showing only 20 instead of 118 - Corrected API parameter name: `limit` → `page_size` - Fixed `per_page` → `page_size` mismatch #### Unregistered Files - Added `file_size` and `modified_time` to FileItem structure - Fixed parameter passing in `get_files` API call --- ### 🔧 Technical Improvements #### API Layer - Dual-mode API (Tauri IPC + HTTP) with automatic detection - `apiCall()` function handles both desktop and browser modes - Proper error handling and loading states #### State Management - Global store with `filesCache`, `thumbnailsCache`, `profilesCache` - LRU-style thumbnail caching (max 4 concurrent requests) - Search history and bookmarks in SQLite #### Architecture - **4 core modules**: Search, File Prep/Processing, Admin, File Management - Modular Vue 3 Composition API design - TypeScript type definitions for all data structures --- ### 📚 Documentation #### New Documentation - **ARCHITECTURE.md** - Complete system architecture overview - **Agent_Search_Integration_Analysis.md** - React to Vue 3 migration guide - **Vue3_Pagination_Implementation_Guide.md** - Complete pagination implementation - **Quick_Implementation_Checklist.md** - 5-step quick start guide - **Pagination_Implementation_Roadmap.md** - Implementation roadmap #### API Documentation - Two-API architecture clarified (v1 → Momentry Core, v2 → MarkBase) - All endpoints documented with examples - Error codes and troubleshooting guides --- ### 🎨 UI/UX Improvements #### Search Interface - Responsive search bar with mode selector - Search history dropdown with Pin/Rename/Delete - Bookmark system for quick access - Result cards with thumbnails and metadata #### Library Interface - Collapsible sections for Completed/Registered/Unregistered files - File status badges with icons - Progress bars for processing files - Processor QC buttons (Advanced Mode) #### Video Player - Frame-accurate seeking - Mark timeline visualization (Advanced Mode) - VLM description display - Full-screen support --- ### ⚡ Performance #### Search Performance - Initial search: **~2s → ~0.5s** (4x faster) - Memory usage: **Progressive loading** instead of all-at-once - User experience: **Immediate feedback** #### Library Performance - Correct pagination with `page_size` parameter - Efficient thumbnail loading with queue - No duplicate API calls --- ### 🛠️ Build & Deployment #### Build Process - Vue 3 + TypeScript + Vite frontend - Tauri 2 (Rust) desktop wrapper - Production build: `npm run build` + `cargo tauri build` - Development mode: `npm run dev` (proxy + vite) #### System Requirements - macOS 12+ (Apple Silicon or Intel) - Node.js 18+ and npm - Rust 1.70+ and Cargo - PostgreSQL 14+ - Qdrant 1.6+ - Redis 7+ (optional) --- ### 🔐 Security - API key injection by Studio proxy (never exposed to frontend) - Per-user SQLite database in `data/users/` - No secrets in localStorage - HTTPS only in production --- ### 📦 Dependencies #### Frontend - Vue 3.5.13 - Vue Router 4.5.0 - VueUse Core 14.3.0 - Vue i18n 9.14.5 - Tauri API 2.11.0 #### Backend (Rust) - Tauri 2.0 - Axum 0.7 (proxy server) - SQLx 0.8 (PostgreSQL) - Rusqlite 0.32 (SQLite) - Reqwest 0.12 (HTTP client) - Tokio 1.40 (async runtime) --- ### 🌐 API Endpoints #### Momentry Core API (v1) - `/api/v1/search/*` - Search endpoints - `/api/v1/files/*` - File management - `/api/v1/identities/*` - Identity management - `/api/v1/agents/*` - Agent search #### MarkBase API (v2) - `/api/v2/admin/*` - Admin endpoints - `/api/v2/myfiles/*` - File management - `/api/v2/service/*` - Service control #### Studio Proxy (8888) - Gateway for v1 and v2 APIs - Local SQLite for history/bookmarks - Face thumbnail generation - Identity profile images --- ### 🚀 Known Issues 1. **Visual Search API** does not support `offset` parameter (using `page_size` as fallback) 2. **Agent Search** does not have dedicated `/api/v1/agent/search` endpoint (using semantic search fallback) 3. **WebSocket** state push not implemented (using polling) 4. **Search history** limited to 30 items (no full-text search) --- ### 🎯 Next Release (0.2.0) #### Planned Features - WebSocket real-time state updates - Session-based search API - Resumable file upload - Advanced search filters - Multi-language support expansion #### Performance Improvements - IndexedDB for persistent caching - Lazy loading for large result sets - Service Worker for offline support #### Architecture Improvements - Unified API Gateway - Plugin system for custom processors - Multi-tenant architecture --- ## Release Team - **Development**: Momentry Studio Team - **QA**: Manual testing on macOS (Apple Silicon) - **Documentation**: Complete guides and architecture docs - **Deployment**: Production-ready on m5max48 --- **Full Changelog**: https://github.com/anomalyco/momentry_studio/compare/v0.0.1...v0.1.0 --- **Installation Guide**: See `RELEASE_v0.1.0_INSTALLATION_GUIDE.md`