🎉 v1.0.0 — First Stable Release

This release marks the first complete, stable version of the EML full-text search and viewer system.
All core design goals have been achieved: reliable indexing, accurate search, and interactive email inspection.

---

✨ Highlights

• ✅ End-to-end workflow fully implemented
  .eml archive → database index → search → expand → read

• 🔍 Robust full-text search using SQLite FTS5

  • Subject
  • Sender
  • Recipients
  • Body
  • Ranked with bm25

• 🧠 Clean separation of concerns

  • Structured storage (emails)
  • Search index (emails_fts)
  • Original .eml files as source of truth

• 🖱️ Interactive UI

  • Search results displayed as modern, readable bars
  • Click to expand and view the full email content
  • Click again to fold (no page reload)

---

🏗️ Core Components

Backend

• FastAPI-based API
• Deterministic indexing pipeline
• Explicit FTS rebuild logic
• Unicode-safe email parsing
• Graceful handling of duplicate paths and re-indexing

Database

• SQLite with FTS5 (external content table)
• Transparent schema, easy to inspect and debug
• No hidden state or background magic

Frontend

• Lightweight HTML + CSS + vanilla JavaScript
• No framework dependencies
• Incremental rendering for performance and clarity

---

🔧 Key Technical Decisions

• Full email bodies are not duplicated for display
  → Indexed for search, loaded from original .eml on demand

• No implicit auto-reindexing
  → Index rebuild is explicit and controlled

• Paths are treated as opaque identifiers, not URLs
  → Avoids encoding ambiguity and filesystem surprises

---

🧪 Verified Capabilities

• Phrase search ("campus card")
• Hyphenated terms (kick-off)
• Unicode subjects and filenames
• Large mailboxes (scales linearly with indexing)

---

🚫 Out of Scope (by design)

• Threading or conversation grouping
• HTML email rendering
• Attachment indexing
• Semantic / embedding-based search

These are intentionally deferred to keep v1.0.0 transparent and inspectable.

---

🚀 What’s Next

Planned directions for future releases may include:

• HTML body rendering
• Attachment support
• Thread reconstruction
• Advanced ranking or hybrid search
• Research-oriented analysis tools

---

🏁 Status

v1.0.0 is feature-complete and stable.
The system is suitable for:

• Developers
• Researchers
• Email corpus analysis
• IR / NLP experimentation
• Users who prefer simple design and functionality

Enjoy!