flowchart TD
    subgraph UserAction["User Action (e.g., Delete Tag)"]
        Action[deleteTag action]
    end

    subgraph MetaReducers["Meta-Reducer Chain (Atomic)"]
        Capture["stateCaptureMetaReducer
━━━━━━━━━━━━━━━
Captures before-state"]
        TagMeta["tagSharedMetaReducer
━━━━━━━━━━━━━━━
• Remove tag from tasks
• Delete orphaned tasks
• Clean TaskRepeatCfgs
• Clean TimeTracking"]
        OtherMeta["Other meta-reducers
━━━━━━━━━━━━━━━
Pass through"]
    end

    subgraph FeatureReducers["Feature Reducers"]
        TagReducer["tag.reducer
━━━━━━━━━━━━━━━
Delete tag entity"]
    end

    subgraph Effects["Effects Layer"]
        OpEffect["OperationLogEffects
━━━━━━━━━━━━━━━
• Compute state diff
• Create single Operation
• with entityChanges[]"]
    end

    subgraph Result["Single Atomic Operation"]
        Op["Operation {
  opType: 'DEL',
  entityType: 'TAG',
  entityChanges: [
    {TAG, delete},
    {TASK, update}x3,
    {TASK_REPEAT_CFG, delete}
  ]
}"]
    end

    Action --> Capture
    Capture --> TagMeta
    TagMeta --> OtherMeta
    OtherMeta --> FeatureReducers
    FeatureReducers --> OpEffect
    OpEffect --> Result

    style UserAction fill:#fff,stroke:#333,stroke-width:2px
    style MetaReducers fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px
    style FeatureReducers fill:#e3f2fd,stroke:#1565c0,stroke-width:2px
    style Effects fill:#fff3e0,stroke:#ef6c00,stroke-width:2px
    style Result fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px

flowchart LR
    subgraph Problem["❌ Effects Pattern (Non-Atomic)"]
        direction TB
        A1[deleteTag action] --> E1[tag.reducer]
        E1 --> A2[effect: removeTagFromTasks]
        A2 --> E2[task.reducer]
        E2 --> A3[effect: cleanTaskRepeatCfgs]
        A3 --> E3[taskRepeatCfg.reducer]

        Note1["Each action = separate operation
Sync may deliver partially
→ Inconsistent state"]
    end

    subgraph Solution["✅ Meta-Reducer Pattern (Atomic)"]
        direction TB
        B1[deleteTag action] --> M1[tagSharedMetaReducer]
        M1 --> M2["All changes in one pass:
• tasks updated
• repeatCfgs cleaned
• tag deleted"]
        M2 --> R1[Single reduced state]

        Note2["One action = one operation
All changes sync together
→ Consistent state"]
    end

    style Problem fill:#ffebee,stroke:#c62828,stroke-width:2px
    style Solution fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px

flowchart TD
    subgraph Before["Before State (captured by meta-reducer)"]
        B1["tasks: {t1, t2, t3}"]
        B2["tags: {tag1, tag2}"]
        B3["taskRepeatCfgs: {cfg1}"]
    end

    subgraph After["After State (post-reducer)"]
        A1["tasks: {t1', t2', t3}"]
        A2["tags: {tag2}"]
        A3["taskRepeatCfgs: {}"]
    end

    subgraph Diff["State Diff Computation"]
        D1["Compare entity collections"]
        D2["Identify: created, updated, deleted"]
    end

    subgraph Changes["Entity Changes"]
        C1["TAG tag1: DELETED"]
        C2["TASK t1: UPDATED (tagId removed)"]
        C3["TASK t2: UPDATED (tagId removed)"]
        C4["TASK_REPEAT_CFG cfg1: DELETED"]
    end

    Before --> Diff
    After --> Diff
    Diff --> Changes

    style Before fill:#fff3e0,stroke:#ef6c00,stroke-width:2px
    style After fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px
    style Diff fill:#e3f2fd,stroke:#1565c0,stroke-width:2px
    style Changes fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px

classDiagram
    class Operation {
        +string id
        +string clientId
        +OpType opType
        +EntityType entityType
        +string entityId
        +VectorClock vectorClock
        +number timestamp
        +EntityChange[] entityChanges
    }

    class EntityChange {
        +EntityType entityType
        +string entityId
        +ChangeType changeType
        +unknown beforeState
        +unknown afterState
    }

    class ChangeType {
        <<enumeration>>
        CREATED
        UPDATED
        DELETED
    }

    Operation --> EntityChange : contains 0..*
    EntityChange --> ChangeType : has

sequenceDiagram
    participant Remote as Remote Op
    participant Applier as OperationApplierService
    participant Store as NgRx Store
    participant State as Final State

    Remote->>Applier: Operation with entityChanges[]

    loop For each entityChange
        Applier->>Applier: Convert to action
        Applier->>Store: dispatch(action)
    end

    Note over Store: All changes applied
in single reducer pass

    Store->>State: Consistent state

    Note over State: Either ALL changes applied
or NONE (transaction semantics)

flowchart TD
    subgraph Input["LWW Update Action"]
        Action["[TASK] LWW Update
entityType + entityId + winningData"]
    end

    subgraph Lookup["Entity Registry Lookup"]
        Registry["Look up entity storage pattern
in entity registry"]
    end

    subgraph Patterns["Storage Pattern Handling"]
        Adapter["ADAPTER ENTITIES
━━━━━━━━━━━━━━━
TASK, PROJECT, TAG, NOTE,
TASK_REPEAT_CFG, ISSUE_PROVIDER,
SIMPLE_COUNTER, BOARD, METRIC,
REMINDER, PLUGIN_USER_DATA,
PLUGIN_METADATA
━━━━━━━━━━━━━━━
adapter.updateOne() or addOne()
+ relationship syncing"]

        Singleton["SINGLETON ENTITIES
━━━━━━━━━━━━━━━
GLOBAL_CONFIG,
TIME_TRACKING,
MENU_TREE,
WORK_CONTEXT
━━━━━━━━━━━━━━━
Entire feature state replaced
with winning data"]

        Unsupported["UNSUPPORTED
━━━━━━━━━━━━━━━
Map, array, virtual
━━━━━━━━━━━━━━━
Warning logged,
no action taken"]
    end

    Input --> Lookup
    Lookup --> Patterns

    style Adapter fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px
    style Singleton fill:#e3f2fd,stroke:#1565c0,stroke-width:2px
    style Unsupported fill:#fff3e0,stroke:#ef6c00,stroke-width:2px