Process Builder Improvements: Mermaid Diagram Generation and Output Organization

Changes

Mermaid Diagram Generation

• Fixed node ID sanitization to ensure valid Mermaid syntax
• Improved handling of special characters in node descriptions
• Updated PNG generation to use proper base64 encoding for Mermaid.INK API
• Added support for process notes as subgraphs in diagrams

Output Directory Structure

• Implemented timestamped subfolders for process outputs
• Each process run now creates a unique directory: output/process_name/YYYYMMDD_HHMMSS/
• Prevents overwriting of previous outputs
• Organizes related files together in versioned directories

Documentation

• Updated README to reflect new features and improvements
• Added clear documentation of output directory structure
• Added section on Mermaid diagram features
• Streamlined installation and usage instructions

Testing

• Verified Mermaid diagram generation with various process flows
• Confirmed PNG generation using Mermaid.INK API
• Tested output directory creation with multiple process runs
• Validated file organization in timestamped directories

Breaking Changes

None - all changes are backward compatible with existing process definitions.

Dependencies

• Added requirement for internet connection (Mermaid.INK API)
• No new package dependencies added

Related Issues

• Fixes issue with Mermaid diagram parsing errors
• Resolves problem of output files being overwritten