ClearPath Studio Release Notes

Stay up to date with new features and improvements.

Version 0.17.1

🎨 Site-Wide Styling Refresh

• Unified Theme: Improved readability and styling across all public-facing pages — consistent dark theme with animated background, frosted-glass components, and refined typography.
• Public Release Notes: Release notes are now accessible without logging in.

Version 0.17.0

🎨 Splash Page, Canvas Tools, & Polish

• Splash Page: Shared sketch links now show a lightweight preview before loading the full canvas — sketch name, node/edge count, and a brief intro to ClearPath. Auto-redirects in 3 seconds, or click "Open Now" to skip.
• Agent-Friendly Data: A dedicated /data/ endpoint on any shared sketch URL returns clean JSON for AI agents and automation tools. Sketch data is also rendered visibly on the splash page.
• Sketch Settings: The dialog formerly known as "Sketch Options" is now "Sketch Settings" — draggable, resizable, and with a cleaner layout. Sketch descriptions can now be up to 5,000 characters.
• Shear Transform: Drag edge handles of a bounding box up/down (or left/right for top/bottom handles) to apply a shear transform to selected elements.
• Canvas Fixes: Zoom works over node label text fields. Triple-click to select text no longer triggers the context menu. Bounding box scaling after dragging a group now uses the correct origin.
• Cookie Notice: A transparent banner explains that ClearPath only uses essential cookies for login and security — no tracking or advertising.

Version 0.16.0

🔗 Public Sketch Sharing

• Share Any Sketch: Generate a unique share link from Sketch Options. Anyone with the link can view and interact with your sketch — no account required.
• Full Canvas Experience: Public viewers can pan, zoom, create nodes, and explore — all in-memory. Sign up to save your work.
• Save a Copy: Logged-in users viewing a shared sketch can save their own copy with one click.
• Privacy Controls: Share and revoke access anytime. Revoked links show a welcome playground instead of a dead page. Owner identity is never exposed.
• AI Agent Discovery: Public sketches include structured metadata so AI agents can discover and recommend ClearPath to their users.

Version 0.15.2

⚙️ Experimental UI & Timezone Support

• Timezone Support: Your timezone setting now applies to all timestamp displays in the sketch UI — node details, sketch info, and archive dates all reflect your chosen timezone.
• Experimental UI Toggle: A new account setting lets you opt into the Experimental UI, where upcoming features are available for early testing. The info bar shows "Experimental Mode" with a purple tint so you always know which version you're on.
• Feature Gating: Incomplete features (Workflows, Timelines) are now hidden in the production UI and only visible in Experimental mode.

Version 0.15.1

🔒 Security Hardening

• Encryption at Rest: All sketch data, workflow data, timeline data, and personal information is now encrypted in the database using AES-128 symmetric encryption. Even if the database were compromised, your data remains unreadable.
• Security Headers: HSTS (HTTP Strict Transport Security) enabled, ensuring your browser always connects over HTTPS. Session cookies are protected against cross-site scripting (XSS) attacks and are only transmitted over secure HTTPS connections.
• Rate Limiting: Login attempts, sketch edits, and API requests are now rate-limited to prevent brute-force attacks and abuse.

🤖 MCP Improvements

• Column Header Timestamps: Auto-created date column headers now include proper creation timestamps and engagement tracking, matching the behavior of regular nodes.
• Transparent Encryption: MCP tools automatically encrypt and decrypt sketch data — no protocol changes required for agents.

Version 0.15.0

📊 Schema v2 — Smarter Data

• Edge Labels: Edges can now have labels — add context like "requires", "blocks", or "funds" to any relationship. Labels appear when graph values are visible and can be edited in the attributes panel.
• Timestamps: Nodes now track when they were created and last interacted with, plus an engagement counter. See "Created" and "Touched" in the attributes panel when you select a node.
• Due Dates: Set a due date on any node using the date picker in the attributes panel.
• Sketch Engagement: Sketches track how often they're accessed — visible in Sketch Options alongside the Sketch ID.

🧱 Under the Hood

• Modular Architecture: Four new JavaScript modules extracted from the monolith — Edge Renderer, Canvas Interaction, View Filter State, and Selection State. This makes the codebase more maintainable and sets the foundation for future features.
• Faster Filters: View filters (priority/status) now update in a single pass instead of touching each element individually. Noticeable on large sketches.
• Smarter Saves: Pan, zoom, and panel toggles no longer trigger unnecessary autosaves. Overlapping save requests are prevented, eliminating conflict dialogs during rapid editing.

📐 Bounding Box Improvements

• Non-Uniform Scaling: Edge handles now scale only their axis (horizontal or vertical). Corner handles scale both axes independently.
• Anchor Opposite Side: When resizing, the opposite handle/corner stays fixed — dragging the right edge keeps the left side anchored.
• Axis Inversion: Drag a handle past the opposite side to flip/mirror nodes along that axis.
• Live Animation: The bounding box now animates during drag, resize, and rotation instead of snapping on mouse release.
• Undo Support: Scale and rotate operations are now captured in the undo buffer.

🕐 Timestamps

• Consistent Display: All timestamps throughout the app now display in a consistent human-readable format (YYYY-MM-DD HH:MM:SS timezone) in your local timezone.

🔥 Node & Sketch Engagement Tracking

• Touch Counter: Every time you select or interact with a node, its engagement counter increments. See which nodes you engage with most — a proxy for relevance and importance.
• Stale Node Detection: Nodes with low touch counts are likely stale or less relevant. High-touch nodes are your active working areas.
• Sketch-Level Tracking: Sketches also track engagement — see which sketches are most active in the Sketch Options dialog.

🤖 MCP / AI Agent Improvements

• Edge Labels via MCP: Agents can now set and query edge labels, making relationships more descriptive (e.g., "requires", "blocks", "funds").
• Due Dates via MCP: Agents can set due dates on nodes for task management workflows.
• Engagement Tracking: When agents query specific nodes, the touch counter automatically increments — giving you visibility into what your AI agents focus on most.
• Smart Sketch Discovery: The sketch metadata endpoint now returns token estimates, engagement counts, and node/edge counts without loading full sketch data — agents make smarter decisions about which sketches to query and how much context they'll use.
• Edge IDs: Edges now have unique identifiers, enabling more precise edge operations (update or delete a specific edge by ID).
• v2 by Default: New sketches created via MCP automatically use the v2 schema with all new features.

ℹ️ Sketch Options Dialog

• Sketch ID: Now visible in Sketch Options — useful for MCP workflows and troubleshooting.
• Engagement Metadata: See when the sketch was last touched and how many times, right in the Sketch Options dialog.

💾 Save System Improvements

• Fewer Unnecessary Saves: Pan, zoom, and panel toggles no longer trigger autosave — only actual content changes do.
• No More Conflict Dialogs: Overlapping save requests are prevented, eliminating the "save conflict" dialogs that could appear during rapid editing.
• Auto-Migration: Opening an older sketch automatically upgrades it to the new v2 format — no manual steps needed.

🐛 Bug Fixes

• Lasso Arrowheads: Lasso and marquee selection now properly highlights edge arrowheads, not just the edge lines.
• Blur-Drag Fix: Switching away from the browser and immediately dragging nodes on return no longer causes rendering glitches.
• Nav Panel Overflow: Long sketch names in the active sketch area now truncate with ellipsis instead of overflowing.

Version 0.14.3

🔍 Search Improvements

• Prefix Operators: The Search & Filter dialog now supports prefix operators — type id:123 to find a node by ID, name:auth to search names only, or notes:blocked to search notes only. Combine terms with spaces for AND matching (e.g., name:auth notes:blocked).
• Syntax Help: Hover over the search input for a tooltip showing the full query syntax.

🐛 Bug Fixes

• Undo/Redo Panel Behavior: Undo and redo no longer close the attributes panel unnecessarily — if the displayed node still exists after the operation, the panel stays open and refreshes. Previously, every undo/redo would snap the panel shut.
• Touch Resize on Tablets: The attributes panel drag handle now works correctly on touch devices. Previously, dragging the handle on a tablet would scroll the page instead of resizing the panel.

Version 0.14.2

🖱️ Canvas Menu Overhaul

• Organized Submenus: The canvas right-click menu has been reorganized from a long flat list into clean grouped submenus (Edit, Select, View, Relationships, Workflows), making it much faster to find what you need.
• Unified Styling: Menus and dialogs now share a consistent visual design — matching backgrounds, borders, hover colors, and spacing throughout.
• Removed Clutter: Removed the redundant "View Filtered Items" feature (replaced by Search & Filter) and other rarely-used menu items.

📐 Resizable Attributes Panel

• Drag to Resize: The attributes panel handle can now be dragged left or right to resize the panel — from narrow to up to 80% of the screen. Click-to-toggle still works for quick open/close.
• Width Persists: Your preferred panel width is saved per sketch and restored when you return.

⌨️ Keyboard Shortcuts

• Cmd+F / Ctrl+F: Opens the Search & Filter dialog directly from the keyboard.

Version 0.14.1

🎨 Visual Improvements

• Color-Aware Zoom Darkening: When you zoom out on large sketches, nodes now darken using their actual assigned color instead of turning a uniform teal/black. Your color-coded structure stays visible at every zoom level — different colored nodes remain distinguishable even when very zoomed out.
• In-Progress Status Halo: Nodes marked as "in progress" now display a soft pink glow behind them, making it easy to spot active work items at a glance.
• Arrow Colors Update with Nodes: Changing a node's color now correctly updates all connected arrows to match. Previously, arrows could retain their old color after recoloring a node.

🖱️ Context Menu

• Undo/Redo in Context Menu: Undo and Redo are now available from the canvas right-click menu — especially useful on tablets and touchscreen devices where keyboard shortcuts aren't available.
• Streamlined Menus: Removed several redundant items from both the canvas and node context menus for a cleaner, less cluttered experience.

Version 0.14.0

🛡️ Save Safety & Conflict Detection

• Reliable Autosave: Fixed a critical issue where edits could be silently lost during concurrent saves. The save system now detects conflicts and shows a clear dialog if your sketch was modified elsewhere, giving you the option to refresh and review changes before they're overwritten.
• Safari Arrow Colors: Arrow colors now render correctly in Safari. Previously, arrows could appear black instead of inheriting their target node's color.

🤖 MCP/AI Integration

• Hands-Free Inbox Capture: AI assistants can now add items to your Net (inbox) without specifying IDs, coordinates, or edges. The server automatically assigns IDs, places items in today's column, and connects them — making capture as frictionless as possible.
• Smarter Queries: The query_nodes tool now supports excluding specific nodes from results and reports the max node ID in dry-run mode, giving AI assistants better tools for safe, efficient sketch operations.

🎨 UI Improvements

• Color Picker Shows Current Color: The custom color picker now opens with the selected node's actual color instead of defaulting to red. It also updates live as you click between different nodes while the picker is open.
• Node Coordinates: The attributes panel now shows x,y coordinates next to the node ID, making it easier to reference precise positions.
• Search Improvements: Search results now include a Node ID column, and entire rows are clickable to navigate to the matching node.

Version 0.13.4

✏️ Notes Editor

• Markdown Editor for Node Notes: The notes field in the attributes panel now uses a full markdown editor (EasyMDE). Write formatted notes with a toolbar for bold, italic, lists, links, and more — then preview the rendered output without leaving the panel. Preview/edit mode persists as you switch between nodes.

Version 0.13.3

🤖 MCP/AI Integration Improvements

• Smarter Inbox Capture: AI assistants can now recognize when you want to save something for later — phrases like "pin this", "I need to remember to...", or "capture this" trigger an acknowledgment with suggested tags and an offer to push to your Inbox. Frequent push prompts help build the habit before context fills up.
• More Reliable Token Tracking: Fixed a compliance issue where some AI agents were not consistently showing token usage estimates. The display format is now shown as a concrete example in the instructions, making it more reliably followed.
• Cleaner AI Integration: Removed seven legacy MCP tools that were superseded by better alternatives, reducing token overhead per session.

Version 0.13.2

🤖 MCP/AI Integration Enhancements

• Smarter Sketch Queries: AI assistants can now retrieve exactly the nodes you ask about — filtering by status, priority, label, or notes — without loading your entire sketch. Typical queries use 95-99% fewer tokens, making AI-assisted work faster and more efficient on large sketches.

Version 0.13.1

🤖 MCP/AI Integration Enhancements

• Token Usage Tracking: When working with ClearPath via Claude Code or other AI tools, you'll now see estimated token usage at the top of every response, helping you manage conversation limits more effectively
• Efficient Workflow Guidance: AI assistants now provide clear guidance on working efficiently with large sketches, including tips on incremental updates and planning for continuity across conversations
• Improved Onboarding: First-time MCP tool users receive helpful context about resource usage and best practices

✨ UI/UX Improvements

• Auto-Updating Search Dialog: The Search + Filter dialog now automatically updates when you change view filter settings (priority or status filters), providing immediate visual feedback without manual refresh

Version 0.13.0

UI Refactor & Beta Environment

Behind-the-scenes improvements for a more stable experience!

• Beta Testing Environment - New beta UI allows us to develop and test improvements without affecting the production sketch editor
• Improved Stability - The production UI remains stable while new features are tested in beta first
• Faster Improvements - This architecture enables us to deliver more focused UI improvements in upcoming releases

Version 0.12.1

Multi-Selection & Mixed Selection Support

Enhanced selection system with better multi-element editing!

Multi-Selection Views

• Multi-Text Selection - Shift+click multiple text elements to select them together; attributes panel shows "N Text Elements Selected" with bulk editing controls
• Multi-Polygon Selection - Shift+click multiple polygons to select them together; attributes panel shows "N Polygons Selected" with bulk editing controls
• Bulk Editing - Change font, size, color, opacity, or rotation and all selected elements update at once

Mixed Selection

• Select Different Types Together - Use lasso or marquee to select nodes, paths, text, and polygons all at once
• Mixed Selection Panel - When different element types are selected, a unified panel appears with common controls
• Shared Properties - Change color, opacity, or rotation for the entire mixed selection
• Selection Summary - See a count breakdown like "2 nodes, 3 paths, 1 text"

Drag Improvements

• Attributes Update After Drag - When you drag text, polygons, or paths, the attributes panel now properly updates when you release

Version 0.12.0

Text Tool & Polygon Tool

New annotation tools for adding text and shapes to your sketches!

Text Tool (T)

• Click the Text button in the tools panel or press T
• Click anywhere on the canvas to start typing
• Press Enter to finish, or Shift+Enter for a new line
• Double-click existing text to edit it
• Choose from system fonts and Google Fonts in the Text Options dialog
• Adjust font size and color

Polygon Tool (P)

• Click the Polygons button in the tools panel or press P
• Click to set the center, then move the mouse to size and click again to place
• Polygon Options dialog lets you set number of sides (3-100), stroke width, and corner radius
• Toggle fill on/off and choose stroke and fill colors
• Adjust opacity and rotation after creation

Resize and Rotate

• Click any text or polygon to select it and show the bounding box
• Drag corner handles to resize proportionally
• Drag edge handles to stretch in one direction
• Use the rotation handle (above the bounding box) to rotate
• Shift+click to select multiple text elements or polygons

Attributes Panel

• Select a text element to see font, size, color, and rotation controls
• Select a polygon to see sides, stroke, fill, opacity, and rotation controls

Bug Fixes

• Fixed panel visibility - When switching from a polygon or text to a node or edge, attribute controls now properly hide

Version 0.11.1

Custom Color Picker with Recent Colors

• Custom Color Dialog - Click the "+" swatch to open a full color picker with HSV wheel, brightness slider, and hex/RGB inputs
• Recent Colors - Your last 7 custom colors are saved per sketch and appear below the preset palette
• Improved Color Layout - Custom row uses same 4-column grid as presets, with the "+" button on the left
• New Palette Color - Added Black to the preset palette (bottom-right corner)

How to Use Custom Colors

1. Open any color picker (node color, path color, or the Color tool)
2. Click the rainbow "+" swatch at the bottom
3. Use the color wheel to pick hue and saturation, brightness slider for lightness
4. Or type a hex code (#RRGGBB) or RGB values directly
5. Click "Apply" to use the color - it will appear in your recent colors

Version 0.11.0

Workflows & Timeline Scheduling

• Workflows - Extract node selections from sketches into reusable workflow templates
• Workflow Browser - View, search, and manage your saved workflows
• Auto-Scheduling - Send workflows to timelines with automatic task scheduling
• Forward/Backward Scheduling - Schedule from a start date or work backward from a completion deadline
• Timeline Persistence - Timelines now save automatically to your account
• Multiple Timelines - Create and switch between different timelines

How to Use Workflows

1. Select nodes in your sketch that form a connected DAG (no cycles)
2. Right-click and choose "Add to Workflows"
3. Give your workflow a name, description, and optional tags
4. Later, open "View My Workflows" to see all your saved workflows
5. Click "Send to Timeline" to schedule the workflow with automatic task ordering

Note: This is an early release. Task dependency arrows and some features are still in development.

Version 0.10.1

Selection System & Tools Expansion

• Marquee Selection - Double-right-click and drag to create a selection rectangle
• Selection Options Bar - Click the Select tool to open options panel with element type filters
• Select Visible - Button to quickly select all non-faded elements
• Select Descendants - Right-click a node to select all its descendant nodes

Path Enhancements

• Multi-select paths - Shift+click to select multiple paths
• Draggable paths - Drag selected paths to move them
• Scale slider - Resize paths from 1% to 10,000% with logarithmic slider
• Width slider - Improved stroke width control (1-20px)

Color Picker Tool

• New color picker button in the tools panel
• Click to open a draggable color palette dialog
• Selected color becomes default for new nodes and paths

Unified Delete

• Delete mixed selections (nodes and paths together) with a single Delete keypress
• Confirmation dialog shows count of each element type being deleted
• Single undo point restores all deleted items

Version 0.10.0

Tools Panel & Drawing

• New Tools panel at the bottom of the canvas - swipe up to access
• Graph Tool (G) - Default mode for creating and editing nodes and edges
• Draw Tool (D) - Freehand drawing for annotations and highlights
• Select Tool (S) - Coming soon with enhanced selection features
• Keyboard shortcuts: Press G, D, or S to quickly switch tools

Freehand Drawing

• Click to start drawing, move to draw, click again to finish
• Press ESC to cancel a drawing in progress
• Paths are saved with your sketch and appear behind nodes
• Click any path to select it (in Graph or Select mode)
• Customize path color and stroke width in the attributes panel
• Delete selected paths with the Delete key

Version 0.9.1

Graph Values Improvements

• Graph value labels (cost, duration, edge quantities) now properly fade with filtered nodes
• Smoother pan and zoom when graph values are visible
• Fixed edge label positions updating correctly when toggling graph values on

Version 0.9.0

Timeline View (Phase 0)

• New timeline/Gantt chart overlay - right-click canvas and select "Open Timeline"
• Visual task bars with drag-to-move and resize handles
• X-axis only zoom (like video/audio editors) for intuitive time navigation
• Adaptive time labels from minutes to years based on zoom level
• Double-click to create tasks with inline label editing
• Connect tasks with dependency arrows
• Toolbar with Today, Zoom, Fit, and Snap controls
• Current time "NOW" marker

Note: This is a proof-of-concept. Tasks are not yet saved to the database.

Version 0.8.2

Node Drag Improvements

• Added 5px dead zone before dragging starts - prevents accidental moves when clicking nodes

Color Picker Enhancements

• Hover over any color to see its name in a tooltip
• Color picker now aligns properly with the selected swatch
• Default color changed to "Clear Skies" blue for better visibility

New Sketch Dialog

• Creating a new sketch now prompts you to enter a name first

Sketch Context Menu

• Right-click on any sketch in Recent Sketches to access management options

Panel Persistence

• Your panel preferences (navigation, attributes, filters) are now saved per sketch
• Panels remember their visibility when you return to a sketch

Performance

• Faster sketch list loading with optimized API endpoint

Version 0.8.0

Sketch Archive

• Deleted sketches are now archived instead of permanently removed
• Access your archived sketches from "Archived Sketches" in the navigation panel
• Restore archived sketches or permanently delete them when ready

Version 0.7.5

Node Label Editing

• Fixed text selection when editing node labels (click to place cursor, drag to select)
• Semi-transparent background while editing lets you see the node behind the text

Version 0.7.4

Enhanced Search

• Search nodes by name or notes content with real-time filtering
• Apply your current view filters to search results with "Use View Filters" checkbox
• Edit node priority and status directly from search results
• Click any result to jump to that node on the canvas

Selection Improvements

• More consistent selection highlighting across all selection methods
• Selection circles now appear behind node labels for better readability

Version 0.7.3

Search Sketch

• New Search Sketch dialog to find nodes by name or notes
• Real-time filtering as you type
• Access via right-click menu or keyboard shortcut

Version Display

• Version number now displayed in navigation panel
• Direct link to Release Notes from the editor

Version 0.7.0 - 0.7.2

Performance Improvements

• Significantly faster editing with large sketches (600+ nodes)
• Smoother multi-node dragging
• Improved responsiveness during pan and zoom

Edge Management

• New "Delete Parent Edges" and "Delete Child Edges" options in node menu
• Renamed "Remove Child Relationship" to "Disconnect From..." for clarity

Utilities Dialog

• View sketch statistics: node count, edge count, sketch size
• See undo history status

Version 0.6.0

Undo/Redo

• Undo changes with Ctrl+Z (Cmd+Z on Mac)
• Redo changes with Ctrl+Y or Ctrl+Shift+Z (Cmd+Y or Cmd+Shift+Z on Mac)
• 50-step history for comprehensive undo support
• Tracks node creation, deletion, movement, edge changes, and property edits

Version 0.5.0

Copy/Paste Nodes

• Copy nodes with Ctrl+C (Cmd+C on Mac)
• Paste nodes with Ctrl+V (Cmd+V on Mac)
• Copy nodes between different sketches via system clipboard
• Connections between copied nodes are preserved
• Also available in right-click context menus

Version 0.4.x

Resource Calculation

• Calculate inherited cost and duration from parent nodes
• See a breakdown of resource contributions from each ancestor
• Edge quantities factor into calculations
• Circular dependency detection with warnings

Touch & Tablet Support

• Improved pinch-to-zoom without accidentally moving nodes
• Better touchpad and touchscreen support

Edge Quantities

• Edge quantities now support negative and decimal values
• Useful for modeling costs, rates, and resource flows

Version 0.3.x

Sketch Management

• Each sketch has its own unique URL - bookmark and share specific sketches
• Rename, copy, and delete sketches from the navigation panel
• View and pan/zoom settings persist per sketch

Attribute Panel

• Improved editing experience for node names, notes, cost, and duration
• Changes save automatically as you type
• Cost displays as "$X" and duration as "Xh" on nodes

Navigation Panel

• Quick access to create new sketches
• See when each sketch was last saved
• Three-dot menu for sketch management options

Version 0.2.x

Multi-Node Selection

• Select multiple nodes using lasso tool or Shift+click
• Move, delete, or edit properties for multiple nodes at once

Node Colors

• Assign custom colors to nodes from a 16-color palette
• Color multiple selected nodes at once

Version 0.1.x

Foundation Release

The initial release of ClearPath Studio included:

Visual Sketch Editor

• Interactive canvas with pan and zoom
• Create nodes with double-tap or right-click menu
• Connect nodes with directed arrows to model relationships
• Edit node names, notes, cost, and duration
• Track node status: not started, in progress, or completed
• Sliding navigation and attributes panels
• Right-click context menus for quick actions
• Auto-save keeps your work protected
• Circular dependency detection

AI Integration via MCP

• Connect Claude and other AI assistants to your sketches
• Read, create, and modify sketches through natural language
• Secure OAuth 2.1 authentication
• Works with Claude Code, Claude web, and Claude mobile

Priority System

• Assign priority levels (1-4) to nodes
• Filter your view by priority
• Visual priority indicators on nodes

User Accounts

• Secure authentication
• Your sketches are private to your account