screenhand 0.4.8 → 0.5.0

package/dist/mcp-desktop.js

@@ -531,17 +531,24 @@ const leaseManager = new LeaseManager(LOCK_DIR);
 // Playbooks dir holds only executable step sequences for job_create
 // Resolution order: local dev paths → npm dist paths → ~/.screenhand/ user paths
 function resolveDataDir(name) {
-    // 1. Local dev path (when running from source)
+    const hasJson = (dir) => fs.existsSync(dir) && fs.readdirSync(dir).some(f => f.endsWith(".json"));
+    // 1. Local dev path (when running from source: references/, playbooks/)
     const local = path.resolve(__dirname, name);
-    if (fs.existsSync(local) && fs.readdirSync(local).some(f => f.endsWith(".json"))) {
+    if (hasJson(local))
         return local;
-    }
-    // 2. npm dist path (when installed via npx/npm)
+    // 2. npm dist path — same level (dist-references/ next to dist/)
     const dist = path.resolve(__dirname, `dist-${name}`);
-    if (fs.existsSync(dist) && fs.readdirSync(dist).some(f => f.endsWith(".json"))) {
+    if (hasJson(dist))
         return dist;
-    }
-    // 3. User home path (always available for user-generated content)
+    // 3. npm dist path — parent level (when __dirname is dist/, check ../dist-references/)
+    const parentDist = path.resolve(__dirname, "..", `dist-${name}`);
+    if (hasJson(parentDist))
+        return parentDist;
+    // 4. Parent level plain name (../references/)
+    const parentLocal = path.resolve(__dirname, "..", name);
+    if (hasJson(parentLocal))
+        return parentLocal;
+    // 5. User home path (always available for user-generated content)
     const userDir = path.join(os.homedir(), ".screenhand", name);
     if (!fs.existsSync(userDir)) {
         fs.mkdirSync(userDir, { recursive: true });
@@ -563,6 +570,9 @@ const seedAppMapsDir = (() => {
     const dist = path.resolve(__dirname, "dist-app-maps");
     if (fs.existsSync(dist))
         return dist;
+    const parentDist = path.resolve(__dirname, "..", "dist-app-maps");
+    if (fs.existsSync(parentDist))
+        return parentDist;
     const local = path.resolve(__dirname, "seed-app-maps");
     if (fs.existsSync(local))
         return local;

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:26:08.299Z",
   "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:26:36.495Z",
   "visibilityConditions": [
     {
       "elementLabel": "iPhone 16 Plus",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "screenhand",
-  "version": "0.4.8",
+  "version": "0.5.0",
   "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",