feat(canvas): added the ability to lock blocks

[waleedlatif1]

Summary

• added the ability to lock blocks

Type of Change

• Bug fix

Testing

Tested manually

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
docs	Skipped		Feb 1, 2026 5:15am

[greptile-apps]

Greptile Overview

Greptile Summary

This PR implements a comprehensive block locking feature for workflows, allowing admins to lock blocks to prevent accidental modifications.

Key Changes

• Database: Added locked boolean column to workflow_blocks table with migration
• Core Functionality: Implemented lock/unlock operations with cascading behavior for container blocks (loops/parallels)
• UI Integration: Added lock/unlock buttons in action bar (admin-only), disabled editing/dragging/deletion for locked blocks
• Smart Duplication: Duplicated blocks are always unlocked; blocks inside locked containers are placed outside
• Collaborative Features: Full socket sync, undo/redo support, and real-time collaboration handling
• Protective Measures: Locked blocks cannot be dragged, deleted, connected, edited, enabled/disabled, or auto-layouted
• User Feedback: Informative notifications when operations are blocked due to locked state

Implementation Quality

The implementation is thorough and well-tested with comprehensive unit tests covering edge cases. The feature integrates cleanly with existing systems (undo/redo, collaborative editing, socket operations). The cascading lock behavior for containers ensures consistency.

Confidence Score: 4/5

• Safe to merge with one minor issue to address regarding consistent logic in enabled toggle operations
• The implementation is comprehensive with excellent test coverage and thoughtful handling of edge cases. One inconsistency exists in the enabled toggle logic between frontend and backend that should be addressed
• apps/sim/socket/database/operations.ts - logic inconsistency in batch toggle enabled operation

Important Files Changed

Filename	Overview
apps/sim/stores/workflows/workflow/store.ts	Implements setBlockLocked, batchToggleLocked with cascading to children, handles locked parent logic in duplication and toggle operations
apps/sim/socket/database/operations.ts	Adds BATCH_TOGGLE_LOCKED operation, respects locked state in toggle operations, cascades lock to children
apps/sim/hooks/use-collaborative-workflow.ts	Added collaborativeBatchToggleLocked hook with undo/redo support, filters locked blocks in toggle enabled
apps/sim/hooks/use-undo-redo.ts	Implements undo/redo for BATCH_TOGGLE_LOCKED operation with proper state restoration
apps/sim/app/workspace/[workspaceId]/w/[workflowId]/workflow.tsx	Prevents drag, delete, connection operations on locked blocks and blocks in locked containers with user notifications
apps/sim/app/workspace/[workspaceId]/w/[workflowId]/components/action-bar/action-bar.tsx	Added lock/unlock button for admins, disables enable/disable and toggle handles when locked
apps/sim/app/workspace/[workspaceId]/w/[workflowId]/components/panel/components/editor/editor.tsx	Disables editing for locked blocks, shows lock indicator with unlock option for admins

Sequence Diagram

sequenceDiagram
    participant User
    participant UI as Action Bar/Context Menu
    participant Hook as useCollaborativeWorkflow
    participant Store as WorkflowStore
    participant Socket as Socket Operations
    participant DB as Database
    participant UndoRedo as Undo/Redo System

    User->>UI: Click Lock/Unlock button
    UI->>Hook: collaborativeBatchToggleLocked(blockIds)
    Hook->>Store: Get current block states
    Store-->>Hook: Return blocks with locked states
    Hook->>Hook: Collect blocks + children (if container)
    Hook->>Hook: Build previousStates map
    Hook->>Socket: addToQueue(BATCH_TOGGLE_LOCKED)
    Hook->>Store: batchToggleLocked(blockIds)
    Store->>Store: Toggle locked state for blocks
    Store->>Store: If container, cascade to all children
    Store-->>Hook: State updated
    Hook->>UndoRedo: recordBatchToggleLocked(blockIds, previousStates)
    UndoRedo-->>Hook: Operation recorded
    Socket->>DB: Update locked column in workflow_blocks
    DB-->>Socket: Update confirmed
    Socket-->>UI: State synchronized

    Note over User,DB: Locked blocks prevent:
    Note over User,DB: - Dragging (draggable=false)
    Note over User,DB: - Deletion (filtered out)
    Note over User,DB: - Connection changes (blocked)
    Note over User,DB: - Editing (canEditBlock=false)
    Note over User,DB: - Enable/disable toggle
    Note over User,DB: - Handle orientation change

    User->>UI: Try to drag locked block
    UI->>UI: Check block.locked
    UI-->>User: Show notification (cannot drag)

    User->>UI: Try to delete locked block
    UI->>UI: Filter out locked blocks
    UI-->>User: Show notification (cannot delete)

    User->>UI: Duplicate locked block
    UI->>Store: duplicateBlock(id)
    Store->>Store: Check if parent is locked
    alt Parent is locked
        Store->>Store: Place duplicate outside container
        Store->>Store: Remove parentId from duplicate
    else Parent not locked
        Store->>Store: Place duplicate with offset
    end
    Store->>Store: Set locked=false on duplicate
    Store-->>UI: New unlocked block created

Loading

[greptile-apps]

_{7 files reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

[cursor]

Exported function hasProtectedBlocks is never used

Low Severity

The hasProtectedBlocks function is exported but never used anywhere in the codebase. The grep search found only its definition (line 82) with no imports or usages. Other functions from this file (isBlockProtected, isEdgeProtected, filterProtectedBlocks) are all used in workflow.tsx, but this one is dead code.