Skip to content

Latest commit

 

History

History
252 lines (180 loc) · 6.18 KB

CHANGELOG.md

File metadata and controls

252 lines (180 loc) · 6.18 KB

Changelog

All notable changes to ChatGPT Memory Toolkit will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[2.0.0] - 2025-10-27

🎉 Major Rewrite

Complete rewrite from vanilla JavaScript to React + TypeScript, following Linus Torvalds' pragmatic principles.

✨ Added

Architecture

  • React 19 UI: Modern component-based popup interface
  • TypeScript: Full type safety across entire codebase
  • esbuild: Lightning-fast build system (< 100ms)
  • Manifest V3: Updated to latest Chrome Extension standards

Features

  • Smart Deduplication: Content hash-based duplicate detection
  • Improved Storage Manager: TypeScript implementation with better error handling
  • Enhanced Content Script: Refined DOM manipulation and memory detection
  • Better Error Handling: Comprehensive try-catch blocks and user-friendly messages

Developer Experience

  • 5000+ lines of documentation:
    • dev/BUILD-SUCCESS.md - Build process details
    • dev/CHROME-TESTING-GUIDE.md - 390-line testing guide
    • dev/MIGRATION-COMPLETE.md - Full migration report
    • dev/architecture.md - System architecture
    • dev/testing-checklist.md - 160+ test cases
  • Simple build script: Custom build.mjs for controlled builds
  • Automated cleanup: Removes unnecessary template files

🔧 Changed

Project Structure

  • Migrated from flat structure to monorepo pattern
  • Separated concerns: content script, popup, background, storage
  • Simplified module dependencies

Build Process

  • Replaced complex template system with custom esbuild script
  • Build time reduced from ~10s to < 100ms
  • Automatic cleanup of _locales and devtools directories

Popup UI

  • Rewritten as Popup-simple.tsx for maintainability
  • Direct chrome.storage API usage (avoiding over-abstraction)
  • Cleaner state management with React hooks

🐛 Fixed

  • [Bug #001] Fixed manifest default_locale error
    • Removed unnecessary _locales/ directory
    • Extension now loads without errors
    • Details: dev/BUGFIX-001-manifest.md

🗑️ Removed

  • Template boilerplate (newtab, devtools, side-panel pages)
  • Unnecessary i18n infrastructure
  • Complex build dependencies causing conflicts
  • Over-engineered abstraction layers

📊 Performance

Metric v1.6.0 v2.0.0 Improvement
Build Time ~10s < 100ms 100x faster
Content Script 20KB 17.5KB 12% smaller
Type Safety 0% 100% Full coverage
Documentation 500 lines 5000+ lines 10x more

🎓 Philosophy

Following Linus Torvalds' principles:

  • ✅ Simple is better than complex
  • ✅ Remove unnecessary code
  • ✅ Never break userspace (backward compatible)
  • ✅ Good taste in architecture
  • ✅ Pragmatic over perfect

Details in LINUS_GUIDE.md

📚 Documentation

New documentation:

  • Complete README with architecture overview
  • Detailed testing guides
  • Bug fix reports with root cause analysis
  • Migration notes and decisions

🔄 Migration Path

From v1.x to v2.0:

  1. All features fully reimplemented
  2. Storage format compatible (no data loss)
  3. Settings preserved
  4. History maintained

⚠️ Breaking Changes

None for end users. All changes are internal.

For developers:

  • Build command changed from pnpm build to node build.mjs
  • Source structure changed (see dev/architecture.md)
  • TypeScript now required for development

[1.6.0] - 2024-XX-XX

Added

  • Initial implementation of memory export
  • History management
  • Settings page
  • Auto-detection of memory full status

Features

  • Basic popup UI (vanilla JavaScript)
  • Content script for ChatGPT page
  • Chrome storage for persistence
  • Markdown export format

[1.5.0] - 2024-XX-XX

Added

  • Visual enhancements for memory full status
  • Auto-open modal option
  • Storage usage monitoring

[1.0.0] - 2024-XX-XX

Added

  • Initial release
  • Basic memory export functionality
  • Simple popup interface

Versioning Notes

Semantic Versioning

  • MAJOR (X.0.0): Incompatible API changes
  • MINOR (2.X.0): New features, backward compatible
  • PATCH (2.0.X): Bug fixes, backward compatible

Release Schedule

  • Stable releases: Tagged and published to Chrome Web Store
  • Beta releases: Available on GitHub releases page
  • Development builds: Available in dist/ after running build script

Upgrade Guide

From v1.x to v2.0

Automatic Migration:

  • Settings preserved automatically
  • History maintained
  • No user action required

Manual Steps (for developers):

  1. Clone new repository
  2. Run pnpm install
  3. Run node build.mjs
  4. Load dist/ into Chrome

Breaking Changes for Developers:

  • Source structure changed
  • Build process changed
  • TypeScript now used

Future Plans

v2.1.0 (Q1 2025)

  • JSON export format
  • Memory search functionality
  • Batch operations
  • Chrome Web Store publication

v2.2.0 (Q2 2025)

  • Multi-language support (i18n)
  • Cloud backup integration
  • Memory categorization
  • Statistics dashboard

v3.0.0 (Future)

  • AI-powered memory insights
  • Memory suggestions
  • Advanced filtering
  • Team sharing features

Contributors

  • @s123104 - Lead Developer
  • ChatGPT Memory Toolkit Team

Links

Acknowledgments

Special thanks to:

  • Chrome Extensions Samples for examples
  • React team for amazing framework
  • esbuild for blazing fast builds
  • TypeScript for type safety
  • Community for feedback and support

Note: This changelog is maintained following the principles of:

  • Clear communication
  • User-first perspective
  • Technical accuracy
  • Actionable information

For detailed technical changes, see:

  • dev/MIGRATION-COMPLETE.md - Full migration details
  • dev/architecture.md - System design
  • dev/BUGFIX-*.md - Individual bug reports

Last updated: 2025-10-27