This release significantly enhances the stability, debuggability, and user experience of the diagramming feature. It introduces a robust optimistic locking mechanism to prevent data conflicts during concurrent edits, alongside a comprehensive structured logging system for better insight into diagram operations. The diagram legend component has been re-engineered for improved integration with the underlying canvas technology, and the application's base URL resolution is now standardized for consistency. These changes are supported by expanded automated testing and updated development guidelines.

Highlights

• Optimistic Locking for Diagram Layouts: Implemented optimistic locking for diagram layouts, allowing clients to send an updatedAt timestamp to prevent overwriting newer versions. This is supported by new API routes and an E2E test.
• Structured Diagram Pipeline Logging: Introduced a new structured logging utility (diagram-pipeline-log.ts) and integrated it across diagram-related API routes and UI components. This provides detailed, filterable logs for save, versioning, and state changes, significantly improving debugging capabilities.
• Refactored Diagram Legend Component: The diagram legend has been refactored to use a native JointJS custom shape (LegendShape and LegendShapeView). This improves rendering, interactivity, and compatibility with JointJS tooling, replacing previous manual DOM manipulation.
• Standardized Base URL Resolution: A new utility (base-url.ts) was added to consistently determine the application's base URL from environment variables or request headers, ensuring correct link generation across various services and SEO configurations.
• Enhanced Diagram Save Pipeline E2E Tests: New E2E tests have been added to cover the new optimistic locking mechanism and improve coverage of the diagram save workflow.