Milestones

Milestones

This page summarizes the major checkpoints reached during PICAZHU Windows development. The detailed source-of-truth progress log lives in PROGRESS.md in the repository.

Completed Milestones

• Core WPF app foundation with modular App, Core, Data, Indexing, Media, Cache, AI, and Tests projects.
• SQLite catalog and local settings persistence.
• Virtualized media grid for large folders.
• Folder-first navigation with breadcrumbs, pinned folders, recent folders, and saved searches.
• Premium shell redesign with stronger hierarchy, spacing, themes, and media-first layout.
• HEIC decoder abstraction with native WIC first and bundled libheif fallback.
• Stable preview behavior for images and videos.
• Recursive folder indexing with AppleDouble sidecar ignore rules.
• Indexing and thumbnail progress indicators with pause/resume/stop controls.
• Multi-select workflow and original-file export.
• Tags tab for OCR and AI output inspection.
• AI runtime kill switch and provider readiness/status layer.
• LM Studio vision integration with compact image payload handling.
• First-pass video AI through representative frame analysis.
• Responsive shell rework with vertical command rail and bottom status strip.
• iPhone import workflow with visual thumbnail picker and original-file copy.
• Settings hardening for provider selection, connection testing, and theme controls.
• Runtime light/dark theme system with dynamic theme resources and regression tests.
• Windows packaging with native installer, portable zip, checksums, and GitHub release workflow.
• GitHub Wiki initialized and published with status, roadmap, release process, AI/performance notes, troubleshooting, and milestone documentation.

Key Lessons

• WPF event ordering can trigger handlers before constructor state is ready.
• Serial MSBuild with -m:1 is the most reliable diagnostic mode in this environment.
• HEIC fallback needs real decode validation, not only codec registration checks.
• Thumbnail cache versioning is required when rendering logic changes.
• Background refresh must not disturb UI selection state.
• Local multimodal models are constrained heavily by request size and context window.
• Desktop responsiveness needs explicit layout tiers, not only flexible grids.
• Filesystem filtering must use exact-or-child path matching, not raw prefix matching.
• Large-folder scans must isolate failures per directory.
• Phone import must be treated as a portable-device workflow, not as normal filesystem access.
• GitHub wikis use a separate .wiki.git repository and may need one browser-created page before git pushes are accepted.

Documentation Rule

Update this wiki, README.md, STATUS.md, PROGRESS.md, and DISTRIBUTION.md whenever a meaningful capability, release, reliability fix, or architectural decision is completed.