screenhand 0.4.1 → 0.4.3

package/dist-references/google-search-competitor-research.json

@@ -0,0 +1,73 @@
+{
+  "platform": "google-search-competitor-research",
+  "version": "1.0.0",
+  "updated": "2026-03-12",
+  "description": "Curated ScreenHand reference for competitor discovery and message validation through Google Search.",
+  "urls": {
+    "search": "https://www.google.com/search?q={QUERY}",
+    "site_search": "https://www.google.com/search?q=site:{DOMAIN}+{QUERY}"
+  },
+  "selectors": {
+    "search": {
+      "query_field": "textarea#APjFqb",
+      "fallback_query_field": "[name='q']",
+      "search_button": "[aria-label='Search']"
+    },
+    "results": {
+      "headings": "h3",
+      "result_links": "a[href]"
+    }
+  },
+  "flows": {
+    "market_query": {
+      "steps": [
+        "Open a direct Google Search URL with the target query",
+        "Capture the first 5-10 visible headings and their domains",
+        "Use repeated brand presence across multiple queries as a relevance signal"
+      ],
+      "guards": [
+        "Google Search is for discovery and validation, not direct proof of paid performance",
+        "Results vary with geography, personalization, and AI Overview presence"
+      ],
+      "why": "Search results show who consistently owns the category conversation and which phrases competitors emphasize."
+    },
+    "brand_validation": {
+      "steps": [
+        "Run exact brand and offer searches after the market query",
+        "Check whether the same landing page angles appear across multiple searches",
+        "Use Search findings to choose which domains to verify in Ads Transparency or Meta"
+      ],
+      "why": "Search helps decide which competitors deserve deeper ad-library validation."
+    }
+  },
+  "detection": {
+    "on_google_search": "location.hostname.includes('google.com') && location.pathname === '/search'",
+    "results_loaded": "document.querySelectorAll('h3').length > 0"
+  },
+  "errors": [
+    {
+      "error": "search result composition varies by query and account",
+      "context": "AI Overviews, videos, or local modules can reorder the page",
+      "solution": "Extract visible h3 headings and domains rather than assuming a fixed result layout.",
+      "severity": "medium"
+    },
+    {
+      "error": "Google Search does not prove ad performance",
+      "context": "Strong rankings or brand presence do not equal conversion success",
+      "solution": "Use Search for discovery, then validate active paid inventory through Meta Ad Library or Ads Transparency.",
+      "severity": "medium"
+    }
+  ],
+  "_meta": {
+    "curated": true,
+    "sourceArtifacts": [
+      "references/google-search-competitor-research-explore.json",
+      "client/careermitra/competitor-ad-scan.md"
+    ],
+    "seedQueries": [
+      "career counselling for students india psychometric test stream selection",
+      "psychometric test for students india",
+      "career counselling after 10th india"
+    ]
+  }
+}

package/dist-references/keynote.json

@@ -0,0 +1,134 @@
+{
+  "id": "keynote",
+  "name": "keynote playbook",
+  "description": "",
+  "platform": "keynote",
+  "urlPatterns": [],
+  "steps": [],
+  "tags": [
+    "keynote"
+  ],
+  "version": "1.0.0",
+  "successCount": 0,
+  "failCount": 0,
+  "bundleId": "com.apple.iWork.Keynote",
+  "selectors": {
+    "toolbar": {
+      "addSlideButton": "AXToolbar > AXButton[AXDescription='Add Slide']",
+      "playButton": "AXToolbar > AXButton[AXDescription='Play']",
+      "formatInspector": "AXToolbar > AXButton[AXDescription='Format']",
+      "animateInspector": "AXToolbar > AXButton[AXDescription='Animate']",
+      "documentInspector": "AXToolbar > AXButton[AXDescription='Document']"
+    },
+    "slidePanel": {
+      "slideNavigator": "AXScrollArea[AXDescription='Slide Navigator']",
+      "slideCell": "AXGroup > AXCell"
+    },
+    "canvas": {
+      "slideCanvas": "AXScrollArea[AXIdentifier='canvas-scroll-view']"
+    },
+    "presenterNotes": {
+      "notesArea": "AXTextArea[AXDescription='Presenter Notes']"
+    },
+    "auto_discovered": {}
+  },
+  "flows": {
+    "create-titled-presentation": {
+      "description": "Create a new presentation, set theme, and add a title slide",
+      "steps": [
+        "make new document with properties {document theme: theme id '...' of application 'Keynote'}",
+        "set object text of default title item of slide 1 to 'Title'",
+        "set object text of default body item of slide 1 to 'Subtitle'",
+        "save document in POSIX file '/path/file.key'"
+      ]
+    },
+    "batch-slide-deck": {
+      "description": "Create a multi-slide deck from a data list",
+      "steps": [
+        "make new document",
+        "set slide 1 title/body",
+        "repeat with data: make new slide, set title/body",
+        "export to PDF or PPTX"
+      ]
+    },
+    "export-all-formats": {
+      "description": "Export presentation in multiple formats",
+      "steps": [
+        "export as PDF to /tmp/out.pdf",
+        "export as Microsoft PowerPoint to /tmp/out.pptx",
+        "export as slide images (PNG) to /tmp/slides/",
+        "export as HTML to /tmp/html/"
+      ]
+    },
+    "add-data-table": {
+      "description": "Add a table to a slide and populate it",
+      "steps": [
+        "make new table with {position, row count, column count} in slide N",
+        "set value of cell C of row R of table 1 to 'header'",
+        "repeat for each data row"
+      ]
+    },
+    "set-auto-advance-slideshow": {
+      "description": "Configure slides to auto-advance and loop",
+      "steps": [
+        "set transition properties of each slide to {transition effect:dissolve, automatic transition:true}",
+        "set auto play of document to true",
+        "set auto loop of document to true",
+        "start front document"
+      ]
+    }
+  },
+  "errors": [
+    {
+      "error": "Can't make {x:100, y:200} into type point (-1700)",
+      "cause": "Using record notation {x:100, y:200} for position/size",
+      "fix": "Use list notation {100, 200} for position; set width and height separately for size"
+    },
+    {
+      "error": "Can't set size of shape N to {w, h} (-10006)",
+      "cause": "Setting size as a list in one step",
+      "fix": "Set width and height as separate properties: 'set width of shape to 200' then 'set height of shape to 150'"
+    },
+    {
+      "error": "Can't get theme id '...' of document 1 (-1728)",
+      "cause": "Accessing theme by ID from document scope",
+      "fix": "Get theme from application scope: 'theme id \"...\" of application \"Keynote\"'"
+    },
+    {
+      "error": "Can't make string into type document (-1700) when setting password",
+      "cause": "AppleScript cannot set password property directly",
+      "fix": "Password setting is UI-only via File > Set Password... dialog"
+    },
+    {
+      "error": "Can't make none into type constant (-1700) for transition effect",
+      "cause": "Using 'none' as transition effect constant",
+      "fix": "Use 'no transition effect' as the keyword for no transition"
+    },
+    {
+      "error": "Expected ',' or '}' but found ':' (-2741) in transition properties",
+      "cause": "Using abbreviated key names like 'duration:' instead of full names",
+      "fix": "Use full property names: 'transition duration', 'transition delay', 'transition effect', 'automatic transition'"
+    },
+    {
+      "error": "Keynote got an error: '.mov' or '.mp4' (6)",
+      "cause": "Attempting to export as QuickTime movie",
+      "fix": "Video export not supported via AppleScript in current Keynote version. Use File > Export To > Movie via UI."
+    },
+    {
+      "error": "Security filter blocked: string concatenation containing 'script'",
+      "cause": "ScreenHand security filter blocks AppleScript with 'script' in concatenated strings",
+      "fix": "Avoid concatenating the word 'script' in string expressions. Restructure to use separate variables."
+    },
+    {
+      "error": "Can't get name of slide N (-1728)",
+      "cause": "Slides in Keynote don't have a 'name' property",
+      "fix": "Use 'slide number' for identifier, 'object text of default title item' for the title text"
+    },
+    {
+      "error": "App com.apple.Music not running",
+      "context": "tool: platform_explore, domain: native:com.apple.iWork.Keynote",
+      "solution": "No resolution yet — investigate and update this entry",
+      "severity": "medium"
+    }
+  ]
+}

package/dist-references/mail.json

@@ -0,0 +1,431 @@
+{
+  "id": "mail",
+  "name": "Mail — Auto-Generated Reference",
+  "platform": "mail",
+  "bundleId": "com.apple.mail",
+  "shortcuts": {
+    "Apple": {
+      "AXMenu > Force Quit…": "Option+Cmd+⎋",
+      "AXMenu > Force Quit Mail": "Option+Shift+Cmd+⎋",
+      "AXMenu > Lock Screen": "Ctrl+Cmd+Q",
+      "AXMenu > Log Out khushi goyal…": "Shift+Cmd+Q",
+      "AXMenu > Log Out khushi goyal": "Option+Shift+Cmd+Q"
+    },
+    "Mail": {
+      "AXMenu > Settings…": "Cmd+,",
+      "AXMenu > Hide Mail": "Cmd+H",
+      "AXMenu > Hide Others": "Option+Cmd+H",
+      "AXMenu > Quit Mail": "Cmd+Q",
+      "AXMenu > Quit and Keep Windows": "Option+Cmd+Q"
+    },
+    "File": {
+      "AXMenu > New Message": "Cmd+N",
+      "AXMenu > New Viewer Window": "Option+Cmd+N",
+      "AXMenu > New Viewer Tab": "Option+Shift+Cmd+N",
+      "AXMenu > Open Messages": "Cmd+O",
+      "AXMenu > Close": "Cmd+W",
+      "AXMenu > Close All": "Option+Cmd+W",
+      "AXMenu > Save": "Cmd+S",
+      "AXMenu > Save As…": "Shift+Cmd+S",
+      "AXMenu > Attach Files…": "Shift+Cmd+A",
+      "AXMenu > Quick Look Attachments…": "Cmd+Y",
+      "AXMenu > Print…": "Cmd+P"
+    },
+    "Edit": {
+      "AXMenu > Undo": "Cmd+Z",
+      "AXMenu > Redo": "Shift+Cmd+Z",
+      "AXMenu > Cut": "Cmd+X",
+      "AXMenu > Copy": "Cmd+C",
+      "AXMenu > Paste": "Cmd+V",
+      "AXMenu > Delete": "Cmd+\b",
+      "AXMenu > Select All": "Cmd+A",
+      "AXMenu > Complete": "Option+Cmd+\u001b",
+      "AXMenu > Paste as Quotation": "Shift+Cmd+V",
+      "AXMenu > Paste and Match Style": "Option+Shift+Cmd+V",
+      "AXMenu > Append Selected Messages": "Option+Cmd+I",
+      "AXMenu > Add Link…": "Cmd+K",
+      "AXMenu > Remove Link": "Option+Cmd+K",
+      "AXMenu > Find > AXMenu > Mailbox Search": "Option+Cmd+F",
+      "AXMenu > Find > AXMenu > Find…": "Cmd+F",
+      "AXMenu > Find > AXMenu > Find Next": "Cmd+G",
+      "AXMenu > Find > AXMenu > Find Previous": "Shift+Cmd+G",
+      "AXMenu > Find > AXMenu > Use Selection for Find": "Cmd+E",
+      "AXMenu > Find > AXMenu > Jump to Selection": "Cmd+J",
+      "AXMenu > Find > AXMenu > Jump to Top": "Ctrl+Cmd+T",
+      "AXMenu > Spelling and Grammar > AXMenu > Show Spelling and Grammar": "Cmd+:",
+      "AXMenu > Spelling and Grammar > AXMenu > Check Document Now": "Cmd+;",
+      "AXMenu > Start Dictation…": "Cmd+🎤",
+      "AXMenu > Emoji & Symbols": "Cmd+🌐"
+    },
+    "View": {
+      "AXMenu > Filter > AXMenu > Enable Message Filter": "Cmd+L",
+      "AXMenu > Bcc Address Field": "Option+Cmd+B",
+      "AXMenu > Reply-To Address Field": "Option+Cmd+R",
+      "AXMenu > Message > AXMenu > All Headers": "Shift+Cmd+H",
+      "AXMenu > Message > AXMenu > Raw Source": "Option+Cmd+U",
+      "AXMenu > Hide Sidebar": "Ctrl+Cmd+S",
+      "AXMenu > Hide Toolbar": "Option+Cmd+T",
+      "AXMenu > Show Favorites Bar": "Option+Shift+Cmd+H",
+      "AXMenu > Enter Full Screen": "Ctrl+Cmd+F"
+    },
+    "Mailbox": {
+      "AXMenu > Get New Mail": "Shift+Cmd+N",
+      "AXMenu > Erase Deleted Items > AXMenu > In All Accounts…": "Shift+Cmd+\b",
+      "AXMenu > Erase Deleted Items > AXMenu > In All Accounts": "Option+Shift+Cmd+\b",
+      "AXMenu > Erase Junk Mail": "Option+Cmd+J",
+      "AXMenu > Go to Favorite Mailbox > AXMenu > Inbox": "Cmd+1",
+      "AXMenu > Go to Favorite Mailbox > AXMenu > Flagged": "Cmd+2",
+      "AXMenu > Go to Favorite Mailbox > AXMenu > Drafts": "Cmd+3",
+      "AXMenu > Go to Favorite Mailbox > AXMenu > Sent": "Cmd+4",
+      "AXMenu > Move to Favorite Mailbox > AXMenu > Inbox": "Ctrl+Cmd+1",
+      "AXMenu > Move to Favorite Mailbox > AXMenu > Flagged": "Ctrl+Cmd+2",
+      "AXMenu > Move to Favorite Mailbox > AXMenu > Drafts": "Ctrl+Cmd+3",
+      "AXMenu > Move to Favorite Mailbox > AXMenu > Sent": "Ctrl+Cmd+4",
+      "AXMenu > Go to Previous Mailbox": "Ctrl+Cmd+[",
+      "AXMenu > Go to Previous Unread Mailbox": "Ctrl+Option+Cmd+[",
+      "AXMenu > Go to Next Mailbox": "Ctrl+Cmd+]",
+      "AXMenu > Go to Next Unread Mailbox": "Ctrl+Option+Cmd+]"
+    },
+    "Message": {
+      "AXMenu > Send Again": "Shift+Cmd+D",
+      "AXMenu > Reply": "Cmd+R",
+      "AXMenu > Reply All": "Shift+Cmd+R",
+      "AXMenu > Forward": "Shift+Cmd+F",
+      "AXMenu > Redirect": "Shift+Cmd+E",
+      "AXMenu > Mark as Unread": "Shift+Cmd+U",
+      "AXMenu > Move to Junk": "Shift+Cmd+J",
+      "AXMenu > Unmute": "Ctrl+Shift+Cmd+M",
+      "AXMenu > Flag > AXMenu > Toggle Flag": "Shift+Cmd+L",
+      "AXMenu > Archive": "Ctrl+Cmd+A",
+      "AXMenu > Move to Predicted Mailbox": "Ctrl+Cmd+M",
+      "AXMenu > Apply Rules": "Option+Cmd+L"
+    },
+    "Format": {
+      "AXMenu > Show Fonts": "Cmd+T",
+      "AXMenu > Show Colors": "Shift+Cmd+C",
+      "AXMenu > Style > AXMenu > Bold": "Cmd+B",
+      "AXMenu > Style > AXMenu > Italic": "Cmd+I",
+      "AXMenu > Style > AXMenu > Underline": "Cmd+U",
+      "AXMenu > Style > AXMenu > Bigger": "Cmd++",
+      "AXMenu > Style > AXMenu > Smaller": "Cmd+-",
+      "AXMenu > Style > AXMenu > Copy Style": "Option+Cmd+C",
+      "AXMenu > Style > AXMenu > Paste Style": "Option+Cmd+V",
+      "AXMenu > Alignment > AXMenu > Align Left": "Cmd+{",
+      "AXMenu > Alignment > AXMenu > Center": "Cmd+|",
+      "AXMenu > Alignment > AXMenu > Align Right": "Cmd+}",
+      "AXMenu > Indentation > AXMenu > Increase": "Cmd+]",
+      "AXMenu > Indentation > AXMenu > Decrease": "Cmd+[",
+      "AXMenu > Quote Level > AXMenu > Increase": "Cmd+'",
+      "AXMenu > Quote Level > AXMenu > Decrease": "Option+Cmd+'",
+      "AXMenu > Make Rich Text": "Shift+Cmd+T"
+    },
+    "Window": {
+      "AXMenu > Minimize": "Cmd+M",
+      "AXMenu > Minimize All": "Option+Cmd+M",
+      "AXMenu > Fill": "Ctrl+Cmd+F",
+      "AXMenu > Center": "Ctrl+Cmd+C",
+      "AXMenu > Move & Resize > AXMenu > Return to Previous Size": "Ctrl+Cmd+R",
+      "AXMenu > Message Viewer": "Cmd+0",
+      "AXMenu > Show Previous Tab": "Ctrl+Shift+Cmd+\t",
+      "AXMenu > Show Next Tab": "Ctrl+Cmd+\t",
+      "AXMenu > Activity": "Option+Cmd+0"
+    },
+    "Help": {}
+  },
+  "selectors": {},
+  "flows": {},
+  "errors": [],
+  "websiteFeatures": [
+    {
+      "id": "get_started_with_mail",
+      "name": "Get Started with Mail",
+      "description": "Set up Mail and start sending, receiving, and managing all your email accounts from one app.",
+      "sourceHeading": "Get Started with Mail",
+      "level": "grandmaster"
+    },
+    {
+      "id": "reduce_the_noise",
+      "name": "Reduce the noise",
+      "description": "Keep your inbox and attention focused by blocking emails from specific people or groups.",
+      "sourceHeading": "Reduce the noise",
+      "level": "pro"
+    },
+    {
+      "id": "stay_organized_with_categories",
+      "name": "Stay organized with categories",
+      "description": "Mail automatically sorts your messages into categories—Primary, Transactions, Updates, and Promotions.",
+      "sourceHeading": "Stay organized with categories",
+      "level": "pro"
+    },
+    {
+      "id": "find_the_perfect_words",
+      "name": "Find the perfect words",
+      "description": "With Apple Intelligence*, you can use Writing Tools to summarize selected text with a click, proofread your work, and find just the right wording and tone.",
+      "sourceHeading": "Find the perfect words",
+      "level": "pro"
+    },
+    {
+      "id": "mail_user_guide",
+      "name": "Mail User Guide",
+      "description": "Mail User Guide",
+      "sourceHeading": "Mail User Guide",
+      "level": "beginner"
+    },
+    {
+      "id": "apple_footer",
+      "name": "Apple Footer",
+      "description": "Apple Footer",
+      "sourceHeading": "Apple Footer",
+      "level": "beginner"
+    },
+    {
+      "id": "welcome",
+      "name": "Welcome",
+      "description": "Welcome",
+      "sourceHeading": "Welcome",
+      "level": "beginner"
+    }
+  ],
+  "mastery": "expert",
+  "masteryNotes": "50+ features verified live across 2 sessions. Core: compose/reply/forward/flag/archive/junk/search/rules/categories/smart mailbox/export PDF. Advanced: Full Screen, Tab management (New Viewer Tab/Merge All), Move to Predicted Mailbox, live send via AppleScript, Signatures create/delete, Undo Send 10s delay, Forward as Attachment/Redirect, Remind Me, Set Priority, Mute/Unmute, Categorize Sender, Raw Source, Sort By, Column Layout, Favorites Bar. 108 shortcuts, 483 menu items mapped. Known bugs: platform_explore crash, Don't Save apostrophe, focus tool error (all workarounded).",
+  "testedOn": "2026-03-24",
+  "selectors": {
+    "compose": {
+      "newMessage": "Cmd+N",
+      "toField": "AXTextField[To:]",
+      "subjectField": "AXTextField[Subject:]",
+      "bodyArea": "AXTextArea (body)",
+      "bccToggle": "Option+Cmd+B",
+      "replyToToggle": "Option+Cmd+R",
+      "attachFiles": "Shift+Cmd+A",
+      "addLink": "Cmd+K",
+      "sendButton": "AXButton[Send]",
+      "saveDraft": "Cmd+S"
+    },
+    "messageActions": {
+      "reply": "Cmd+R",
+      "replyAll": "Shift+Cmd+R",
+      "forward": "Shift+Cmd+F",
+      "archive": "Ctrl+Cmd+A",
+      "flag": "Shift+Cmd+L",
+      "markUnread": "Shift+Cmd+U",
+      "moveToJunk": "Shift+Cmd+J",
+      "exportPDF": "File/Export as PDF…"
+    },
+    "navigation": {
+      "inbox": "Cmd+1",
+      "flagged": "Cmd+2",
+      "drafts": "Cmd+3",
+      "sent": "Cmd+4",
+      "search": "Option+Cmd+F",
+      "filterToggle": "Cmd+L",
+      "sidebarToggle": "Ctrl+Cmd+S"
+    },
+    "settings": {
+      "open": "Cmd+,",
+      "rulesTab": "AXButton[Rules]",
+      "signaturesTab": "AXButton[Signatures]",
+      "junkMailTab": "AXButton[Junk Mail]"
+    },
+    "utilities": {
+      "activityWindow": "Option+Cmd+0",
+      "connectionDoctor": "Window/Connection Doctor",
+      "photoBrowser": "Window/Photo Browser",
+      "previousRecipients": "Window/Previous Recipients"
+    },
+    "tabs": {
+      "newViewerTab": "Option+Shift+Cmd+N",
+      "showNextTab": "Ctrl+Cmd+Tab",
+      "showPreviousTab": "Ctrl+Shift+Cmd+Tab",
+      "mergeAllWindows": "Window/Merge All Windows"
+    },
+    "windowManagement": {
+      "enterFullScreen": "Ctrl+Cmd+F",
+      "exitFullScreen": "Ctrl+Cmd+F"
+    }
+  },
+  "flows": {
+    "compose_and_save_draft": {
+      "steps": [
+        "key: Cmd+N",
+        "type To address, Tab",
+        "type Subject, Tab",
+        "type body",
+        "key: Cmd+S to save as draft"
+      ],
+      "verified": true
+    },
+    "reply_to_message": {
+      "steps": [
+        "click message in list",
+        "key: Cmd+R",
+        "type reply body",
+        "key: Cmd+S or send"
+      ],
+      "verified": true
+    },
+    "forward_message": {
+      "steps": [
+        "click message in list",
+        "key: Shift+Cmd+F",
+        "type To address",
+        "send"
+      ],
+      "verified": true
+    },
+    "search_messages": {
+      "steps": [
+        "key: Option+Cmd+F",
+        "type search query",
+        "results show Top Hits + All Results with smart suggestions"
+      ],
+      "verified": true
+    },
+    "create_smart_mailbox": {
+      "steps": [
+        "menu: Mailbox/New Smart Mailbox…",
+        "set name and conditions",
+        "click OK"
+      ],
+      "verified": true
+    },
+    "export_message_as_pdf": {
+      "steps": [
+        "select a message",
+        "menu: File/Export as PDF…",
+        "choose save location",
+        "click Save"
+      ],
+      "verified": true
+    },
+    "enable_categories": {
+      "steps": [
+        "navigate to Inbox",
+        "click 'Try Categories' in prompt",
+        "inbox now shows Primary/Transactions/Updates/Promotions tabs"
+      ],
+      "verified": true
+    },
+    "manage_rules": {
+      "steps": [
+        "menu: Mail/Settings…",
+        "click Rules tab",
+        "Add Rule / Edit / Remove"
+      ],
+      "verified": true
+    },
+    "send_email_applescript": {
+      "steps": [
+        "tell application Mail",
+        "make new outgoing message with properties {subject:..., content:..., visible:true}",
+        "make new to recipient with properties {address:...}",
+        "send newMsg"
+      ],
+      "verified": true,
+      "notes": "Returns true on success. Undo Send delay (10s) applies."
+    },
+    "full_screen": {
+      "steps": [
+        "key: Ctrl+Cmd+F to enter full screen (menu bar disappears)",
+        "key: Ctrl+Cmd+F again to exit"
+      ],
+      "verified": true
+    },
+    "tab_management": {
+      "steps": [
+        "key: Option+Shift+Cmd+N — New Viewer Tab (tab bar appears)",
+        "key: Ctrl+Cmd+Tab — Show Next Tab",
+        "menu: Window/Merge All Windows — consolidate windows to tabs",
+        "key: Ctrl+Cmd+W — close current tab"
+      ],
+      "verified": true
+    },
+    "manage_signatures": {
+      "steps": [
+        "menu: Mail/Settings… (Cmd+,)",
+        "click Signatures tab",
+        "click + button (button 1 of group 1 of splitter group 1) to create",
+        "click - button (button 2) to delete",
+        "Signature dropdown appears in compose window as AXPopUpButton[Signature:]"
+      ],
+      "verified": true,
+      "notes": "3-column layout: All Signatures | Account | Preview. Default content is name + email."
+    },
+    "message_advanced_actions": {
+      "steps": [
+        "Forward as Attachment: Message/Forward as Attachment (verified)",
+        "Redirect: Shift+Cmd+E (verified)",
+        "Remind Me: Message/Remind Me submenu — 1 Hour / Tonight / Tomorrow / Later (verified)",
+        "Set Priority: Message/Set Priority — Low/Normal/High (verified)",
+        "Mute: Message/Mute → menu changes to Unmute (verified via Ctrl+Shift+Cmd+M)",
+        "Categorize Sender: Message/Categorize Sender submenu (verified)",
+        "Move to Predicted Mailbox: Ctrl+Cmd+M (executes silently, verified)"
+      ],
+      "verified": true
+    },
+    "raw_source": {
+      "steps": [
+        "select a message",
+        "menu: View/Message/Raw Source (Option+Cmd+U)",
+        "opens in separate window showing full SMTP headers + raw body"
+      ],
+      "verified": true
+    },
+    "sort_and_layout": {
+      "steps": [
+        "Sort By: View/Sort By → Attachments/Date/From/Subject/Flags/Size/To/Unread (verified)",
+        "Column Layout: View/Use Column Layout (verified)",
+        "Bottom Preview: View/Show Side Preview (verified)",
+        "Favorites Bar: View/Show Favorites Bar → Option+Shift+Cmd+H (verified)"
+      ],
+      "verified": true
+    }
+  },
+  "errors": {
+    "platform_explore_crash": {
+      "description": "platform_explore fails with 'App com.apple.mail not running' even when app is running",
+      "workaround": "Use ui_tree(pid) + scan_menu_bar(pid) instead for exploration",
+      "observed": "2026-03-23"
+    },
+    "dont_save_apostrophe": {
+      "description": "ui_press cannot find AXButton \"Don't Save\" — curly apostrophe causes selector mismatch",
+      "workaround": "Use AppleScript: `click button 2 of sheet 1 of window \"New Message\"` (button index is stable: 1=Save, 2=Don't Save, 3=Cancel)",
+      "observed": "2026-03-24"
+    },
+    "focus_tool_error": {
+      "description": "focus tool throws 'playbook.errors is not iterable' for com.apple.mail",
+      "workaround": "Non-blocking error — tool still works. Or use AppleScript to activate: `tell application \"Mail\" to activate`",
+      "observed": "2026-03-24"
+    }
+  },
+  "valueAddFeatures": [
+    {
+      "id": "auto_organize",
+      "name": "Auto-Organize",
+      "description": "Sort and organize Mail items by content, date, or type",
+      "category": "organization",
+      "level": "expert"
+    },
+    {
+      "id": "smart_search",
+      "name": "Smart Search",
+      "description": "Search across all Mail content with pattern matching",
+      "category": "organization",
+      "level": "pro"
+    },
+    {
+      "id": "summarize_all",
+      "name": "Summarize",
+      "description": "Read and summarize all Mail content",
+      "category": "intelligence",
+      "level": "expert"
+    },
+    {
+      "id": "change_monitor",
+      "name": "Change Monitor",
+      "description": "Monitor Mail for changes and notify",
+      "category": "monitoring",
+      "level": "grandmaster"
+    }
+  ]
+}