Sasha Studio Release Notes: v1.0.95 to v1.0.96

Release Period: September 2025
Version Range: 1.0.95 → 1.0.96
Total Commits: 15

Executive Summary

This release streamlines how documentation is previewed in chat, adds first‑class editing support for Markdown files outside the docs root, and rounds out several quality and reliability improvements. Teams get a simpler, more consistent preview experience, better citation hygiene, and a few targeted UX and operational fixes.

Major Features & Improvements

Unified Markdown Preview in Chat

Md‑only previews in Chat via the existing MarkdownPreview component (replacing the custom docs modal)
Inline “open” icon and links open the same modal for a consistent experience
Read/write support for absolute .md files under HOME (outside docs root) with secure server endpoints

🧾 Knowledge Docs Enhancements

Server‑side DOCX download for knowledge documents
Embedded/inline HTML assets supported more robustly in generated content

Citation System Improvements

Stricter source URL requirements and priority rules to improve citation quality and traceability

UI Polish

Renamed “Tools” tab to “System Settings” and updated ordering for clarity

Stability & Reliability

Resolved React hook‑ordering warning by removing conditional hooks with the legacy docs preview modal (the chat preview now uses a single MarkdownPreview path)
Authentication robustness: clearer Postmark debug logs, Docker env passthrough, and fixes for SQLite password update and email domain typos
Issue reporting labels: automatically prefix reporter in created issues for easier triage
Debuggability: wired debug envs across Compose and Vite build args

Developer Experience & Docs

Added password reset backend guide (+ link from docs index)
Improved password‑reset test script with more realistic headers
Consolidated and refined release notes documentation

Upgrade Notes

No breaking changes expected. Chat preview behavior is now md‑only and uses a single MarkdownPreview modal. If you had custom flows depending on the old docs preview iframe, validate any “Open in new tab” flows against the revamped approach.
New endpoints (authenticated):
- GET /api/files/read-md-any?path=/abs/path.md (read)
- PUT /api/files/write-md-any with { path, content } (write)
- Both are restricted to .md files under HOME for safety.

🧾 Changelog Summary (since v1.0.95)

feat(chat,server): md‑only previews using MarkdownPreview; add read/write for absolute .md; remove DocsPreviewModal
feat(docs): server‑side DOCX download for knowledge documents
fix(docs): source‑level support for embedded HTML and asset rewriting in generated pages
feat(citations): enhance citation system with URL‑priority requirements; add comprehensive source URL requirements
feat(ui): rename Tools tab to System Settings and reorder
fix(auth): Postmark debug logs; Docker env passthrough; fix SQLite password update and email domain typos
docs(auth): add password reset backend guide and link from docs index
chore(test): improve password reset test script (headers, usage)
fix: comment out mermaid enhancements in legacy preview to resolve React error (#310)
feat(bugs): add reporter‑prefixed label on auto‑created issues
chore(debug): wire debug envs across Compose and Vite build args
docs: improve and consolidate release notes

🚦 Looking Ahead

Continued convergence on a single, accessible preview pipeline
Expanding quality gates for citations and document metadata
Iterative polish on admin/settings UX and operational observability

Thanks for upgrading. This release focuses on clarity, safety, and consistency in how documents are previewed and edited across Sasha.