# Visual Cohesion Audit: Workloads/LWLock/AIO ## The Baseline Metaphor **Index Node:** `_Aio.md` **Root Metaphor:** **The Tube Catchers (Pneumatic Tube Coordination)** - **Visual Baseline:** As an LWLock category, this represents "The Shoulder Nudge"—brief coordination between staff. Specifically, it protects access to the **Pneumatic Tube System** (The AIO metaphor). - **Setting/Mechanisms:** Tube canisters, pneumatic ports, staff members nudging each other to reach for a specific canister, and catching incoming messages. --- ## Exhaustive Visual Critique (Leaf Nodes) ### `AioUringCompletion.md` > [!CAUTION] **Total Metaphor Hallucination (The Fish Monger)** > **Image Asset:** `assets/wl_lw_aio_uringcompletion.png` > **Visual Content:** An angry **Crab** guarding a straw basket overflowing with blue **fish**. > **Critique:** Total failure. This image bears zero relation to "Lightweight Locks," "Pneumatic Tubes," or "Async IO." It belongs in a "Storage/Buffering" or "Query" chapter. > **Visual Fix Required:** Show two animals (e.g., the Crab and an Elephant) both reaching for the same **incoming tube canister** at a dispatch station. ### `AioWorkerSubmissionQueue.md` > [!CAUTION] **Metaphor Fracture (The Steam Train)** > **Image Asset:** `assets/wl_lw_aio_workersubmission.png` > **Visual Content:** A **Hamster in a mining hat** shoveling purple glowing **cubes** into a small **Steam Locomotive**. > **Critique:** Total failure. This swaps "Pneumatic Tubes" for "Victorian Industrial/Mining." It suggests a "Heavy Processing" task rather than a "Lightweight Coordination" task. > **Visual Fix Required:** Show the Hamster trying to shove a canister into a tube port while another worker is already using that port. --- ## Action Plan 1. **Re-anchor to the Pneumatic Tube infrastructure.** 2. **Incorporate the "Shoulder Nudge"**: Every LWLock image must feature at least two characters (or one character waiting for another) to emphasize the "Coordination" aspect of LWLocks. 3. Remove the "Fish" and "Steam Trains."