screenhand 0.4.7 → 0.4.9

package/dist/mcp-desktop.js

@@ -401,6 +401,16 @@ async function ensureCDP(overridePort) {
 const server = new McpServer({ name: "screenhand", version: "3.0.0" }, {
     instructions: `ScreenHand gives you native desktop control on macOS/Windows. 111 tools across 7 layers.
 
+## Prebuilt Knowledge (already loaded — no setup needed)
+ScreenHand ships with EXPERT-level references, playbooks, and app maps for these apps. They load automatically when the app is detected — you do NOT need to learn or explore these:
+
+**Apple-native apps:** Terminal, Mail, Finder, Calendar, Reminders, Keynote, Pages, Notes, Photos, Apple Music, WhatsApp, iOS Simulator (37 refs, 65 playbooks, 15 app maps)
+**Web/Creative apps:** Figma, Discord, DaVinci Resolve, Canva, Instagram, X/Twitter, LinkedIn, YouTube, Reddit, Threads, Notion, n8n, DevTo, Google Flow, Codex Desktop
+
+For Simulator specifically: 53 shortcuts, 37 flows, 16 playbooks (launch app, screenshot, Face ID, push notifications, permissions, location, dark mode, etc.), all simctl commands documented.
+
+To check what's available: coverage_report(bundleId, appName) — if it shows selectors + flows, you're good to go. Skip learning.
+
 ## Quick Actions (1-2 steps, no setup)
 focus("com.apple.Notes") → ui_press("New Note") → type_text("hello") → key("cmd+s")
 browser_navigate("https://...") → browser_click("#btn") → browser_js("return ...")

package/dist/src/ingestion/coverage-auditor.js

@@ -190,6 +190,9 @@ export class CoverageAuditor {
     }
     loadReferences(bundleId) {
         const refs = [];
+        // Derive short name for matching: "com.apple.iphonesimulator" → "iphonesimulator"
+        const bundleParts = bundleId.split(".");
+        const shortName = (bundleParts[bundleParts.length - 1] ?? "").toLowerCase();
         try {
             const files = fs.readdirSync(this.referencesDir);
             for (const file of files) {
@@ -198,7 +201,10 @@ export class CoverageAuditor {
                 try {
                     const raw = fs.readFileSync(path.join(this.referencesDir, file), "utf-8");
                     const ref = JSON.parse(raw);
-                    if (ref.bundleId === bundleId || ref.platform === bundleId) {
+                    if (ref.bundleId === bundleId ||
+                        ref.platform === bundleId ||
+                        ref.platform?.toLowerCase() === shortName ||
+                        ref.id?.toLowerCase() === shortName) {
                         refs.push(ref);
                     }
                 }
@@ -214,6 +220,27 @@ export class CoverageAuditor {
         const bundleParts = bundleId.split(".");
         const shortName = (bundleParts[bundleParts.length - 1] ?? "").toLowerCase();
         const appNameLower = appName.toLowerCase();
+        // Also match by filename prefix (e.g. "simulator-launch-app.json" matches appName "Simulator")
+        const filenamePrefixes = [shortName, appNameLower];
+        // Find the platform name from reference files for cross-matching
+        // e.g. bundleId "com.apple.iphonesimulator" → platform "simulator" in reference
+        const refPlatforms = [];
+        try {
+            const refFiles = fs.readdirSync(this.referencesDir);
+            for (const file of refFiles) {
+                if (!file.endsWith(".json"))
+                    continue;
+                try {
+                    const raw = fs.readFileSync(path.join(this.referencesDir, file), "utf-8");
+                    const ref = JSON.parse(raw);
+                    if (ref.bundleId === bundleId && ref.platform) {
+                        refPlatforms.push(ref.platform.toLowerCase());
+                    }
+                }
+                catch { /* skip */ }
+            }
+        }
+        catch { /* dir not found */ }
         try {
             const files = fs.readdirSync(this.playbooksDir);
             for (const file of files) {
@@ -222,12 +249,16 @@ export class CoverageAuditor {
                 try {
                     const raw = fs.readFileSync(path.join(this.playbooksDir, file), "utf-8");
                     const pb = JSON.parse(raw);
-                    // Match by bundleId (exact), platform name (case-insensitive), or app name
+                    // Match by bundleId (exact), platform name (case-insensitive), app name, or ref platform
                     const platformLower = (pb.platform ?? "").toLowerCase();
+                    const fileBase = file.replace(".json", "").toLowerCase();
                     if (pb.bundleId === bundleId ||
                         platformLower === bundleId ||
                         platformLower === shortName ||
-                        platformLower === appNameLower) {
+                        platformLower === appNameLower ||
+                        refPlatforms.includes(platformLower) ||
+                        filenamePrefixes.some(p => fileBase.startsWith(p + "-")) ||
+                        refPlatforms.some(rp => fileBase.startsWith(rp + "-"))) {
                         playbooks.push(pb);
                     }
                 }

package/dist-app-maps/com.apple.iphonesimulator.json

@@ -20,7 +20,7 @@
     "consistency": 6
   },
   "confidence": 0.13111111111111112,
-  "lastValidated": "2026-03-25T10:15:29.651Z",
+  "lastValidated": "2026-03-25T10:23:29.084Z",
   "mapVersion": 1,
   "uiArchitecture": {
     "type": "other",
@@ -2849,7 +2849,7 @@
   "shortcutsUsed": 20,
   "playbooksExported": 0,
   "edgeCasesHandled": 2,
-  "lastRecomputed": "2026-03-25T10:15:18.462Z",
+  "lastRecomputed": "2026-03-25T10:23:17.594Z",
   "visibilityConditions": [
     {
       "elementLabel": "iPhone 16 Plus",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "screenhand",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "mcpName": "io.github.manushi4/screenhand",
   "description": "Give AI eyes and hands on your desktop. ScreenHand is an open-source MCP server that lets Claude and other AI agents see your screen, click buttons, type text, and control any app on macOS and Windows.",
   "homepage": "https://screenhand.com",