screenhand 0.1.1 → 0.3.0

package/dist-references/reddit.json

@@ -0,0 +1,341 @@
+{
+  "id": "reddit",
+  "name": "Reddit Automation",
+  "description": "Battle-tested playbook for Reddit browser automation via CDP. Covers feed browsing, upvote/downvote, comment, create post, search, join subreddit, and profile viewing. Reddit uses shadow DOM extensively (shreddit-post, faceplate-textarea-input) and Lexical editor for text input.",
+  "platform": "reddit",
+  "version": "1.0.0",
+  "urlPatterns": [
+    "*reddit.com*"
+  ],
+  "tags": [
+    "reddit",
+    "social",
+    "browser",
+    "cdp",
+    "shadow-dom"
+  ],
+  "successCount": 0,
+  "failCount": 0,
+  "urls": {
+    "home": "https://www.reddit.com/",
+    "popular": "https://www.reddit.com/r/popular/",
+    "subreddit": "https://www.reddit.com/r/{subreddit}/",
+    "post": "https://www.reddit.com/r/{subreddit}/comments/{postId}/{slug}/",
+    "submit": "https://www.reddit.com/r/{subreddit}/submit/?type=TEXT",
+    "submit_link": "https://www.reddit.com/r/{subreddit}/submit/?type=LINK",
+    "submit_image": "https://www.reddit.com/r/{subreddit}/submit/?type=IMAGE",
+    "search": "https://www.reddit.com/search/?q={query}&type=link",
+    "search_subreddit": "https://www.reddit.com/r/{subreddit}/search/?q={query}",
+    "profile": "https://www.reddit.com/user/{username}/",
+    "settings": "https://www.reddit.com/settings/",
+    "messages": "https://www.reddit.com/message/inbox/",
+    "notifications": "https://www.reddit.com/notifications/"
+  },
+  "selectors": {
+    "nav": {
+      "home": "left-nav-top-section button:has-text('Home')",
+      "popular": "left-nav-top-section button:has-text('Popular')",
+      "search": "input[type='search'], #search-input, reddit-search-large input",
+      "create_post": "a[href='/submit'], button:has-text('Create Post')",
+      "user_menu": "button:has-text('Expand user menu')"
+    },
+    "post": {
+      "container": "shreddit-post",
+      "title_attr": "[post-title]",
+      "author_attr": "[author]",
+      "score_attr": "[score]",
+      "permalink_attr": "[permalink]",
+      "subreddit_attr": "[subreddit-prefixed-name]"
+    },
+    "post_actions_shadow": {
+      "upvote": "shreddit-post >> shadowRoot >> button:has-text('Upvote')",
+      "downvote": "shreddit-post >> shadowRoot >> button:has-text('Downvote')",
+      "comments": "shreddit-post >> shadowRoot >> button:has-text('Go to comments')",
+      "share": "shreddit-post >> shadowRoot >> button:has-text('Share')",
+      "note": "These selectors are conceptual — use JS to access shadow roots: post.shadowRoot.querySelectorAll('button')"
+    },
+    "comment": {
+      "composer": "shreddit-composer",
+      "textbox": "div[role='textbox'][contenteditable='true'][aria-placeholder='Join the conversation']",
+      "submit_button": "button:has-text('Comment')",
+      "comment_element": "shreddit-comment",
+      "comment_author": "shreddit-comment[author]",
+      "comment_text": "shreddit-comment [slot='comment']"
+    },
+    "create_post": {
+      "title_wrapper": "faceplate-textarea-input[name='title']",
+      "title_textarea": "faceplate-textarea-input[name='title'] >> shadowRoot >> textarea",
+      "body_textbox": "div[role='textbox'][aria-placeholder='Body text (optional)']",
+      "submit_button": "button:has-text('Post')",
+      "flair_button": "button:has-text('Add flair')",
+      "type_text": "[type='TEXT']",
+      "type_link": "[type='LINK']",
+      "type_image": "[type='IMAGE']",
+      "note": "Title textarea is inside shadow root of faceplate-textarea-input — use native value setter via JS"
+    },
+    "subreddit": {
+      "header": "shreddit-subreddit-header",
+      "join_button": "button:has-text('Join')",
+      "joined_button": "button:has-text('Joined')",
+      "sort_dropdown": "shreddit-sort-dropdown"
+    },
+    "search": {
+      "input": "input[type='search']",
+      "results": "shreddit-post, a[href*='/comments/']",
+      "filter_posts": "button:has-text('Posts')",
+      "filter_communities": "button:has-text('Communities')",
+      "filter_comments": "button:has-text('Comments')",
+      "filter_people": "button:has-text('People')"
+    },
+    "feed": {
+      "post_list": "shreddit-feed, main",
+      "post_item": "shreddit-post",
+      "ad_post": "shreddit-ad-post"
+    }
+  },
+  "detection": {
+    "is_logged_in": "!!document.querySelector('button[aria-label*=\"Expand user menu\"], button:has-text(\"Expand user menu\")')",
+    "is_home": "window.location.pathname === '/' || window.location.pathname === '/home/'",
+    "is_subreddit": "/^\\/r\\/[a-zA-Z0-9_]+\\/?$/.test(window.location.pathname)",
+    "is_post": "/\\/comments\\//.test(window.location.pathname)",
+    "is_submit": "window.location.pathname.includes('/submit')",
+    "is_search": "window.location.pathname === '/search/'",
+    "is_profile": "window.location.pathname.startsWith('/user/')"
+  },
+  "flows": {
+    "upvote_post": {
+      "steps": [
+        "Find post element: document.querySelector('shreddit-post')",
+        "Access shadow root: post.shadowRoot",
+        "Find Upvote button: post.shadowRoot.querySelectorAll('button') — find by textContent 'Upvote'",
+        "Click via JS: button.click()",
+        "Verify: button text or style changes (filled arrow)"
+      ],
+      "guards": [
+        "Must be logged in",
+        "Post must not already be upvoted"
+      ],
+      "why": "Reddit uses shadow DOM for post action buttons. Regular CSS selectors cannot reach them — must use element.shadowRoot.querySelectorAll()."
+    },
+    "downvote_post": {
+      "steps": [
+        "Find post element: document.querySelector('shreddit-post')",
+        "Access shadow root: post.shadowRoot",
+        "Find Downvote button by textContent",
+        "Click via JS: button.click()"
+      ],
+      "guards": [
+        "Must be logged in"
+      ]
+    },
+    "comment_on_post": {
+      "steps": [
+        "Navigate to post page: reddit.com/r/{subreddit}/comments/{postId}/{slug}/",
+        "Scroll down to find comment composer",
+        "Click on 'Join the conversation' placeholder area using screen coordinates (CDP click at element center)",
+        "Wait 1s for Lexical editor to activate and show Cancel/Comment buttons",
+        "Use browser_fill_form with 80ms delay on div[role='textbox'][aria-placeholder='Join the conversation']",
+        "Verify textbox content is set",
+        "Click Comment button via JS: find visible button with textContent 'Comment'",
+        "Wait 2s for comment to post — composer collapses when successful"
+      ],
+      "guards": [
+        "Must be logged in",
+        "Comment composer must be visible (scroll to it)"
+      ],
+      "why": "Reddit uses Lexical editor which rejects execCommand, clipboard paste, and fast CDP key events. browser_fill_form with 80ms delay works. The composer must be activated by clicking the placeholder area first — it starts collapsed with 0 dimensions until clicked."
+    },
+    "create_post": {
+      "steps": [
+        "Navigate to reddit.com/r/{subreddit}/submit/?type=TEXT",
+        "Wait 2s for submit page to load",
+        "Set title via JS: access faceplate-textarea-input[name='title'].shadowRoot.querySelector('textarea'), use native value setter (Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, 'value').set), dispatch input event",
+        "Click body textbox via browser_human_click: div[role='textbox'][aria-placeholder='Body text (optional)']",
+        "Type body via browser_fill_form with 80ms delay",
+        "Optionally add flair",
+        "Click Post button"
+      ],
+      "guards": [
+        "Must be logged in",
+        "Must have sufficient karma for subreddit"
+      ],
+      "why": "Title is inside shadow root of faceplate-textarea-input custom element — cannot use CSS selectors directly. Must use native value setter. Body uses Lexical editor — same approach as comments."
+    },
+    "search": {
+      "steps": [
+        "Navigate to reddit.com/search/?q={query}&type=link",
+        "Wait 2s for results to load",
+        "Extract post data from shreddit-post elements using attributes: post-title, author, score, permalink, subreddit-prefixed-name",
+        "Filter by type: Posts, Communities, Comments, People tabs"
+      ],
+      "guards": [],
+      "why": "Direct URL navigation is more reliable than typing in Reddit's search input. Post metadata is stored as HTML attributes on shreddit-post elements."
+    },
+    "join_subreddit": {
+      "steps": [
+        "Navigate to reddit.com/r/{subreddit}/",
+        "Wait 2s for subreddit to load",
+        "Find Join button — may be in shreddit-subreddit-header shadow root or main DOM",
+        "Click Join button",
+        "Verify button changes to 'Joined'"
+      ],
+      "guards": [
+        "Must be logged in",
+        "Must not already be a member"
+      ],
+      "why": "Join button location varies — sometimes in shadow DOM of shreddit-subreddit-header, sometimes in sidebar. Check both."
+    },
+    "scroll_and_extract_feed": {
+      "steps": [
+        "Navigate to reddit.com or reddit.com/r/{subreddit}/",
+        "Wait 2s for feed to load",
+        "Extract posts from shreddit-post elements using attributes: post-title, author, score, permalink, subreddit-prefixed-name",
+        "Access shadow roots for upvote/downvote/comment counts",
+        "Scroll down for more posts",
+        "Wait 1.5s for lazy-loaded content"
+      ],
+      "guards": []
+    },
+    "view_profile": {
+      "steps": [
+        "Navigate to reddit.com/user/{username}/",
+        "Wait 2s for profile to load",
+        "Extract karma, account age, recent posts and comments",
+        "Scroll for more activity"
+      ],
+      "guards": [
+        "Profile must not be private or suspended"
+      ]
+    },
+    "extract_post_data": {
+      "steps": [
+        "Query shreddit-post elements",
+        "Read attributes: post.getAttribute('post-title'), post.getAttribute('author'), post.getAttribute('score'), post.getAttribute('permalink'), post.getAttribute('subreddit-prefixed-name')",
+        "For action buttons, access post.shadowRoot and find buttons by textContent",
+        "For comment count, find button with 'Go to comments' text in shadow root"
+      ],
+      "guards": [],
+      "why": "Reddit stores all post metadata as HTML attributes on the shreddit-post custom element. This is the most reliable way to extract data."
+    }
+  },
+  "errors": [
+    {
+      "error": "Login required",
+      "context": "Any action requiring authentication (upvote, comment, post)",
+      "solution": "Log in manually first. Reddit uses email/password or Google/Apple SSO.",
+      "severity": "high"
+    },
+    {
+      "error": "Shadow DOM blocks CSS selectors for action buttons",
+      "context": "Upvote, Downvote, Share, Comment buttons are inside shreddit-post.shadowRoot",
+      "solution": "Access via JS: document.querySelector('shreddit-post').shadowRoot.querySelectorAll('button'). Find by textContent ('Upvote', 'Downvote', etc.).",
+      "severity": "high"
+    },
+    {
+      "error": "Lexical editor rejects execCommand, clipboard paste, and fast typing",
+      "context": "Comment and post body use Lexical editor (contenteditable div with data-lexical-editor attribute)",
+      "solution": "Use browser_fill_form with 80ms+ delay. The composer must be activated first by clicking the placeholder area — it starts collapsed with 0 dimensions.",
+      "severity": "high"
+    },
+    {
+      "error": "Title textarea inside shadow root of faceplate-textarea-input",
+      "context": "Post creation title field is not accessible via regular CSS selectors",
+      "solution": "Use JS: document.querySelector('faceplate-textarea-input[name=\"title\"]').shadowRoot.querySelector('textarea'). Set value with native setter: Object.getOwnPropertyDescriptor(HTMLTextAreaElement.prototype, 'value').set.call(textarea, text). Dispatch input event.",
+      "severity": "high"
+    },
+    {
+      "error": "Comment composer has 0 dimensions until activated",
+      "context": "The shreddit-composer and its textbox start with 0x0 dimensions",
+      "solution": "Scroll to the comment area and click on the 'Join the conversation' placeholder using screen coordinates. Wait for composer to expand before typing.",
+      "severity": "medium"
+    },
+    {
+      "error": "browser_human_click returns (0,0) for shadow DOM elements",
+      "context": "Elements inside shadow roots report 0,0 coordinates to CDP selectors",
+      "solution": "Use browser_js to access shadow root, get bounding rect, then click by coordinates. Or use JS click: element.click().",
+      "severity": "medium"
+    },
+    {
+      "error": "Join button not found in expected location",
+      "context": "Join/Joined button may be in shadow root of shreddit-subreddit-header or rendered lazily",
+      "solution": "Search both main DOM and all shadow roots for button with 'Join' textContent. May need to scroll sidebar into view.",
+      "severity": "medium"
+    },
+    {
+      "error": "Ad posts mixed with regular posts",
+      "context": "Reddit inserts shreddit-ad-post elements between regular shreddit-post elements",
+      "solution": "Filter by tag name: use shreddit-post (not shreddit-ad-post) for real content.",
+      "severity": "low"
+    },
+    {
+      "error": "Reddit ads open new tabs on click",
+      "context": "Clicking on promoted posts navigates to external URLs",
+      "solution": "Skip shreddit-ad-post elements when interacting with feed.",
+      "severity": "low"
+    },
+    {
+      "error": "Frontmost app switches to VS Code when approving tool calls",
+      "context": "AccessibilityAdapter attaches to frontmost app",
+      "solution": "Use CDP browser tools — they work regardless of which app is frontmost.",
+      "severity": "high"
+    }
+  ],
+  "policyNotes": {
+    "rate_limits": [
+      "Posts: ~5/day for new accounts, more for established",
+      "Comments: ~50/day",
+      "Upvotes/Downvotes: no strict limit but don't spam",
+      "New accounts have karma requirements for many subreddits",
+      "Some subreddits require minimum account age"
+    ],
+    "safety": [
+      "Never automate login",
+      "Reddit aggressively detects automation — add 3-10s random delays",
+      "Use browser_stealth before interacting",
+      "Respect subreddit rules — many ban self-promotion",
+      "New accounts have very limited posting ability",
+      "Use browser_fill_form with 80ms+ delays for Lexical editor text input",
+      "Reddit may require CAPTCHA for suspicious activity"
+    ],
+    "tool_preferences": [
+      "browser_fill_form (80ms+ delay) — for Lexical editor text (comments, post body)",
+      "browser_js with native value setter — for shadow DOM inputs (post title)",
+      "browser_js with shadowRoot access — for upvote/downvote/action buttons",
+      "browser_human_click — for activating collapsed composers (needs real coordinates)",
+      "browser_navigate — for search (direct URL), subreddit/post navigation"
+    ]
+  },
+  "steps": [
+    {
+      "action": "navigate",
+      "url": "https://www.reddit.com/",
+      "description": "Open Reddit home feed"
+    },
+    {
+      "action": "wait",
+      "ms": 2000,
+      "description": "Wait for feed to load"
+    },
+    {
+      "action": "extract",
+      "target": "shreddit-post",
+      "format": "attributes",
+      "description": "Extract post titles, authors, scores from shreddit-post attributes"
+    },
+    {
+      "action": "scroll",
+      "direction": "down",
+      "amount": 5,
+      "description": "Scroll for more posts"
+    },
+    {
+      "action": "wait",
+      "ms": 1500,
+      "description": "Wait for lazy-loaded posts"
+    },
+    {
+      "action": "screenshot",
+      "description": "Capture current feed state"
+    }
+  ]
+}

package/dist-references/threads.json

@@ -0,0 +1,337 @@
+{
+  "id": "threads",
+  "name": "Threads Automation",
+  "description": "Battle-tested playbook for Threads (threads.com) browser automation via CDP. Covers feed, like, reply, repost, share, create post, search, follow/unfollow, and profile viewing.",
+  "platform": "threads",
+  "version": "1.0.0",
+  "urlPatterns": [
+    "*threads.com*",
+    "*threads.net*"
+  ],
+  "tags": [
+    "threads",
+    "social",
+    "browser",
+    "cdp",
+    "meta"
+  ],
+  "successCount": 0,
+  "failCount": 0,
+  "urls": {
+    "home": "https://www.threads.com/",
+    "search": "https://www.threads.com/search",
+    "activity": "https://www.threads.com/activity",
+    "profile": "https://www.threads.com/@{username}",
+    "post": "https://www.threads.com/@{username}/post/{postId}",
+    "settings": "https://www.threads.com/settings"
+  },
+  "selectors": {
+    "nav": {
+      "home": "svg[aria-label='Home']",
+      "search": "svg[aria-label='Search']",
+      "create": "svg[aria-label='Create']",
+      "notifications": "svg[aria-label='Notifications']",
+      "profile": "svg[aria-label='Profile']"
+    },
+    "search": {
+      "input": "input[placeholder='Search']",
+      "result_link": "a[href^='/@']"
+    },
+    "post_actions": {
+      "like_button": "svg[aria-label='Like']",
+      "unlike_button": "svg[aria-label='Unlike']",
+      "reply_button": "svg[aria-label='Reply']",
+      "repost_button": "svg[aria-label='Repost']",
+      "share_button": "svg[aria-label='Share']",
+      "more_options": "svg[aria-label='More']"
+    },
+    "feed": {
+      "post_container": "div[data-pressable-container='true']",
+      "username": "a[href^='/@'] span",
+      "follow_button": "svg[aria-label='Follow']"
+    },
+    "profile": {
+      "follow_button": "div[role='button']:has-text('Follow')",
+      "following_button": "div[role='button']:has-text('Following')",
+      "unfollow_button": "div[role='button']:has-text('Unfollow')"
+    },
+    "create_post": {
+      "textbox": "div[role='textbox'][contenteditable='true']",
+      "post_button": "button:has-text('Post'), div[role='button']:has-text('Post')",
+      "cancel_button": "button:has-text('Cancel')",
+      "attach_media": "button:has-text('Attach media')",
+      "add_gif": "button:has-text('Add a GIF')",
+      "add_emoji": "button:has-text('Add an emoji')",
+      "add_poll": "button:has-text('Add a poll')",
+      "add_location": "button:has-text('Add a location')"
+    },
+    "reply": {
+      "textbox": "div[role='textbox'][contenteditable='true']",
+      "post_button": "button:has-text('Post'), div[role='button']:has-text('Post')"
+    },
+    "repost_menu": {
+      "repost": "div[role='button']:has-text('RepostRepost')",
+      "quote": "div[role='button']:has-text('QuoteQuote')"
+    },
+    "share_menu": {
+      "copy_link": "div[role='button']:has-text('Copy link')",
+      "copy_as_image": "div[role='button']:has-text('Copy as image')",
+      "add_to_story": "div[role='button']:has-text('Add to Instagram story')"
+    }
+  },
+  "detection": {
+    "is_logged_in": "!!document.querySelector('svg[aria-label=\"Home\"]')",
+    "is_feed": "window.location.pathname === '/' || window.location.pathname === '/for_you' || window.location.pathname === '/following'",
+    "is_search": "window.location.pathname === '/search'",
+    "is_profile": "/^\\/@[a-zA-Z0-9._]+\\/?$/.test(window.location.pathname)",
+    "is_post": "/^\\/@[a-zA-Z0-9._]+\\/post\\//.test(window.location.pathname)",
+    "has_dialog_open": "!!document.querySelector('div[role=\"dialog\"]')"
+  },
+  "flows": {
+    "like_post": {
+      "steps": [
+        "Find post container: div[data-pressable-container='true']",
+        "Find Like button within post: svg[aria-label='Like']",
+        "Use browser_human_click on Like SVG",
+        "Verify: svg[aria-label='Unlike'] now exists in that post"
+      ],
+      "guards": [
+        "Must be logged in",
+        "Post must not already be liked"
+      ]
+    },
+    "reply_to_post": {
+      "steps": [
+        "Find Reply button in post: svg[aria-label='Reply']",
+        "Use browser_human_click on Reply SVG",
+        "Wait 1.5s for reply dialog to open",
+        "Find textbox: div[role='textbox'] with placeholder 'Reply to {username}...'",
+        "Type reply via browser_fill_form with ~80ms delay",
+        "Find Post button in dialog and click via browser_js",
+        "Wait 1s for reply to post"
+      ],
+      "guards": [
+        "Must be logged in"
+      ]
+    },
+    "repost": {
+      "steps": [
+        "Find Repost button in post: svg[aria-label='Repost']",
+        "Use browser_human_click on Repost SVG",
+        "Wait 1s for repost menu to appear",
+        "Click 'Repost' option (textContent contains 'RepostRepost')",
+        "Wait for repost confirmation"
+      ],
+      "guards": [
+        "Must be logged in",
+        "Post must not already be reposted"
+      ]
+    },
+    "quote_post": {
+      "steps": [
+        "Find Repost button in post: svg[aria-label='Repost']",
+        "Use browser_human_click on Repost SVG",
+        "Wait 1s for repost menu to appear",
+        "Click 'Quote' option (textContent contains 'QuoteQuote')",
+        "Wait for quote dialog to open",
+        "Type quote text via browser_fill_form",
+        "Click Post button"
+      ],
+      "guards": [
+        "Must be logged in"
+      ]
+    },
+    "share_copy_link": {
+      "steps": [
+        "Find Share button in post: svg[aria-label='Share']",
+        "Use browser_human_click on Share SVG",
+        "Wait 1s for share menu to appear",
+        "Click 'Copy link' button",
+        "Link is now in clipboard"
+      ],
+      "guards": [
+        "Must be logged in"
+      ]
+    },
+    "create_post": {
+      "steps": [
+        "Click Create button in sidebar: svg[aria-label='Create'] via parent element",
+        "Wait 1.5s for create dialog to open",
+        "Find textbox: div[role='textbox'] with placeholder 'What's new?'",
+        "Type post content via browser_fill_form with ~60ms delay",
+        "Optionally attach media, GIF, emoji, poll, or location",
+        "Click Post button in dialog",
+        "Wait for post to publish"
+      ],
+      "guards": [
+        "Must be logged in"
+      ],
+      "why": "Create dialog offers: Attach media, Add a GIF, Add an emoji, Add a poll, Attach text, Add a location, Add to thread, Reply options"
+    },
+    "search_profiles": {
+      "steps": [
+        "Navigate to threads.com/search",
+        "Wait 1s for search page to load",
+        "Find search input: input[placeholder='Search']",
+        "Type query via browser_fill_form with ~100ms delay",
+        "Wait 2s for search results",
+        "Extract profile results from a[href^='/@'] links"
+      ],
+      "guards": [
+        "Must be logged in"
+      ]
+    },
+    "follow_profile": {
+      "steps": [
+        "Navigate to threads.com/@{username}",
+        "Wait 2s for profile to load",
+        "Find Follow button: div[role='button'] with text 'Follow'",
+        "Click Follow via browser_js",
+        "Verify button changed to 'Following'"
+      ],
+      "guards": [
+        "Must be logged in",
+        "Must not already be following"
+      ]
+    },
+    "unfollow_profile": {
+      "steps": [
+        "Find Following button: div[role='button'] with text 'Following'",
+        "Click Following button",
+        "Wait 1s for unfollow confirmation to appear",
+        "Click Unfollow button",
+        "Verify button changed back to 'Follow'"
+      ],
+      "guards": [
+        "Must be logged in",
+        "Must currently be following"
+      ]
+    },
+    "scroll_and_extract_feed": {
+      "steps": [
+        "Navigate to threads.com",
+        "Verify logged in (check for Home icon)",
+        "Extract visible posts from div[data-pressable-container='true'] elements",
+        "Get username from a[href^='/@'] span within each post",
+        "Scroll down to load more content",
+        "Wait 1s for lazy-loaded posts",
+        "Extract next batch of posts"
+      ],
+      "guards": [
+        "Must be logged in"
+      ]
+    },
+    "view_profile": {
+      "steps": [
+        "Navigate to threads.com/@{username}",
+        "Wait 2s for profile to load",
+        "Extract follow/following status",
+        "Extract profile bio and thread count",
+        "Scroll to view recent threads"
+      ],
+      "guards": [
+        "Must be logged in"
+      ]
+    }
+  },
+  "errors": [
+    {
+      "error": "Login required / redirected to login",
+      "context": "Any action when not logged in",
+      "solution": "Log in manually first. ScreenHand cannot bypass login. Threads uses Instagram login.",
+      "severity": "high"
+    },
+    {
+      "error": "Rate limited / Action Blocked",
+      "context": "Too many likes, reposts, or replies",
+      "solution": "Wait 15-30 minutes. Threads shares rate limits with Instagram.",
+      "severity": "high"
+    },
+    {
+      "error": "Repost menu item text is 'RepostRepost' not 'Repost'",
+      "context": "Threads renders icon + text together causing doubled text in textContent",
+      "solution": "Match on textContent containing 'RepostRepost' for Repost option, 'QuoteQuote' for Quote option.",
+      "severity": "medium"
+    },
+    {
+      "error": "Search sidebar doesn't open search input",
+      "context": "Clicking Search SVG in sidebar navigates instead of opening inline search",
+      "solution": "Navigate directly to threads.com/search to get the search input.",
+      "severity": "medium"
+    },
+    {
+      "error": "Follow button is a div[role='button'] not a button element",
+      "context": "Threads uses div role=button for Follow/Following",
+      "solution": "Query div[role='button'] in addition to button elements.",
+      "severity": "low"
+    },
+    {
+      "error": "Frontmost app switches to VS Code when approving tool calls",
+      "context": "AccessibilityAdapter attaches to frontmost app",
+      "solution": "Use CDP browser tools (browser_js, browser_human_click, browser_fill_form) — they work regardless of which app is frontmost.",
+      "severity": "high"
+    }
+  ],
+  "policyNotes": {
+    "rate_limits": [
+      "Shares rate limits with Instagram",
+      "Likes: ~60/hr, ~150/day",
+      "Reposts: ~20/hr",
+      "Replies: ~20/hr, ~60/day",
+      "Follows: ~20/hr, ~100/day"
+    ],
+    "safety": [
+      "Never automate login (uses Instagram SSO)",
+      "Add 2-5s random delays between actions",
+      "Use browser_stealth before interacting",
+      "Don't exceed rate limits",
+      "Use browser_human_click for Like/Repost/Follow",
+      "Use browser_fill_form with 50-100ms delays for typing"
+    ],
+    "tool_preferences": [
+      "browser_human_click — for Like, Repost, Share, Follow buttons",
+      "browser_fill_form — for reply/post textboxes and search input",
+      "browser_js — for finding elements by textContent, clicking menu items, extracting data",
+      "browser_navigate — for page navigation (works in background)"
+    ]
+  },
+  "steps": [
+    {
+      "action": "navigate",
+      "url": "https://www.threads.com/",
+      "description": "Open Threads home feed"
+    },
+    {
+      "action": "wait",
+      "ms": 1500,
+      "description": "Wait for feed to load"
+    },
+    {
+      "action": "extract",
+      "target": "div[data-pressable-container='true']",
+      "format": "text",
+      "description": "Extract first visible post content"
+    },
+    {
+      "action": "scroll",
+      "direction": "down",
+      "amount": 5,
+      "description": "Scroll down to see more posts"
+    },
+    {
+      "action": "wait",
+      "ms": 1000,
+      "description": "Wait for new posts to load"
+    },
+    {
+      "action": "extract",
+      "target": "div[data-pressable-container='true']",
+      "format": "text",
+      "description": "Extract posts after scroll"
+    },
+    {
+      "action": "screenshot",
+      "description": "Capture current feed state"
+    }
+  ]
+}