Patch Notes
Alpha Stage: looking for feedback!
Dark Mode & UI Verticality
Added Dark Mode! The graph interface has been reorganised into a vertical stack, alongside real-time online user tracking and implemented graph filtering.
- Dark Mode: Implemented dark theme support across the entire application.
- Vertical Navigation: Refactored UI into a vertical stack for future mobile compatibility.
- Graph Filtering: Added keyword and author-based filters to the Stemma Graph.
Editor Refinement & Collaboration UX
This update focuses on stabilizing the new Hybrid Markdown environment, aligning component logic between the viewer and editor, and enhancing the collaborative visibility within the Git Graph.
- Hybrid Editor Stability: Integrated robust Undo/Redo stacks and fixed delete race conditions.
- Unified Component Architecture: The Markdown viewer and editor now share a single source of truth for component rendering.
- Git Graph Social: Added 'Add User' functionality to the map and enabled live user activity indicators.
- Deleting Nodes now prompts a confirmation dialog to prevent accidental data loss.
- Graph Styling: Re-aligned user avatars vertically and updated avatar handling logic for better clarity.
- Sharing: Projects are now 'Make Shareable' directly from the portal interface.
- Media Handling: Implemented image linkage parity between view/edit modes and resolved an infinite loop bug caused by missing images.
- Safety Cues: Added a global 'Delete Warning' popup to prevent accidental data loss.
- Hybrid Metadata: Introduced MD Config injection and Table Identifier support for block-level state management.
Hybrid Editor & Merge Protocols
A significant evolution in authoring and merging. We've introduced a 'Hybrid' Markdown environment that treats documents as discrete blocks (Math, Code, Prose) for maximum rendering stability. On the backend, the merge protocol has been hardened with a hidden '__incoming__' directory strategy.
- Hybrid Markdown Editor: Jupyter-style block editing with isolated state for Math (KaTeX) and Code.
- Added Editor Toggle: Seamlessly swap between 'Hybrid' (Block) and 'Raw' (Monaco) modes.
- Merge Protocol Upgrade: Standardized the hidden '__incoming__/' directory for safer merge staging.
- File Explorer: Added 'C' indicator on tree nodes to quickly diff Base vs. Incoming changes.
- Resolved 'disappearing text' bugs by moving to non-destructive Markdown parsing.
- Compare Resolver: Front-end diff calculation logic now triggers on 'C' node selection.
- Email Graph: Evaluated automatic thread mapping; discarded due to privacy/security constraints.
Merge Visualization & PDF Tools
A major update to the Graph capabilities, extending 'Ghost Nodes' to visualize complex merge operations. Also includes significant upgrades to the PDF viewer and production infrastructure fixes.
- Resolved WebSocket routing issues (Nginx/HTTPS); broadcast now functions correctly on production domains.
- Extended Ghost Node system to visualize merge targets from two distinct sources (Shift+Click).
- Refined Merge algorithm: Improved node positioning and rendered strict edge directionality.
- Upgraded PDF Viewer: Added panning, rotation, and a streamlined control bar.
- Added 'Show Password' visibility toggle for secure inputs.
- Added Loading Placeholders for smoother component transitions.
- Added 404 Error handling to the Editor Title Bar.
New CSV Editor and Viewer Added
Full read/write capabilities for CSV datasets. The new spreadsheet interface includes column/row manipulation, a dedicated toolbar, and robust undo/redo history management.
- Implemented Spreadsheet Editor with 'react-spreadsheet'.
- Added CSV Toolbar with Add/Delete Row & Column controls.
- Integrated Undo/Redo history stack with keyboard shortcuts (Ctrl+Z/Y).
- Added live version tag to global navigation bar.
- Polished selection state and delete logic for strict row/col handling.
Phase 1: Mapping [Alpha Access]
Core architecture operational. Now featuring a fully usable File Explorer, multi-modal Editor, and live Stemma Graph collaboration. System is capable of verifiable history mapping in a live environment.
- Official System Tag: v0.1.0 Alpha applied.
- Deployment verified on production droplet.
- Resolved Equation/LaTeX rendering pipeline.
- Polished Empty State UX with instructional cues.
Live Deployment & Security
Establishing secure communication channels and public access points.
- stemmalabs.com is live via HTTPS (Certbot/SSL).
- Implemented System Changelog (Patch Notes).
Renderer & Visualization Engine
Enhanced the visual fidelity of the Stemma Tree and file rendering capabilities.
- Smooth Pan/Zoom for User Avatars in Graph.
- Docx Support: Added Mammoth & TipTap renderers.
- Image Insertion support for Word documents.
- Multi-user location rendering in Git Graph.
- Optimized staging: Converting .docx to HTML for diff computation.
Real-Time Collaboration Layer
Activated live tracking and Laika agent autonomy.
- New Project Dashboard (Public/Private Toggles).
- Live User Tracking: Visible changes when collaborators edit.
- Laika Agent: Improved async commit handling.
- Generalized Broadcast Mechanism via WebSockets.
- DAG Inversion: Recursive prune propagation for node deletion.
- Cookie Token Listeners for seamless auth updates.
Core R&D & Architecture
Deep research into distributed graph theory and file system architecture. Multiple prototypes were built and discarded to arrive at the current Stemma Protocol.
- VCS Engine: Custom PyGit2 implementation.
- Laika v1: Llama Index RAG + Commit-level context.
- Dockerized Microservices (Redis + Workers).
- Evaluated 'BarycenterHeuristics' for graph layout.
- Prototype: 'CirclesOfTime' (Radial visualization attempt).
- Prototype: 'GravityTree' (Physics-based node layout).
- Evaluated 'Sugiyama' framework for DAG rendering.
- Backend Tests: 'GCFUSE' vs 'GitVM' vs 'Gitea' integrations.