screenhand 0.4.0 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/dist/mcp-desktop.js +10 -0
  2. package/dist/src/ingestion/coverage-auditor.js +12 -3
  3. package/dist/src/ingestion/feature-extractor.js +29 -29
  4. package/dist/src/memory/playbook-seeds.js +1 -1
  5. package/dist/src/playbook/engine.js +15 -0
  6. package/dist/src/playbook/mcp-recorder.js +21 -1
  7. package/dist/src/state/app-map.js +56 -51
  8. package/dist/src/state/ladder-generator.js +28 -28
  9. package/dist-app-maps/com.apple.Music.json +6587 -0
  10. package/dist-app-maps/com.apple.Notes.json +6098 -0
  11. package/dist-app-maps/com.apple.Photos.json +406 -0
  12. package/dist-app-maps/com.apple.Terminal.json +3968 -0
  13. package/dist-app-maps/com.apple.finder.json +420 -0
  14. package/dist-app-maps/com.apple.iCal.json +2375 -0
  15. package/dist-app-maps/com.apple.iWork.Keynote.json +2374 -0
  16. package/dist-app-maps/com.apple.iWork.Pages.json +7564 -0
  17. package/dist-app-maps/com.apple.mail.json +8353 -0
  18. package/dist-app-maps/com.apple.reminders.json +3322 -0
  19. package/dist-app-maps/net.whatsapp.WhatsApp.json +5151 -0
  20. package/dist-playbooks/calendar-create-event.json +20 -0
  21. package/dist-playbooks/calendar-list-events.json +20 -0
  22. package/dist-playbooks/calendar-navigate-views.json +47 -0
  23. package/dist-playbooks/calendar-open-settings.json +20 -0
  24. package/dist-playbooks/google-ads-transparency-competitor-research.json +89 -0
  25. package/dist-playbooks/google-search-competitor-research.json +76 -0
  26. package/dist-playbooks/keynote-add-slide.json +20 -0
  27. package/dist-playbooks/keynote-create-presentation.json +20 -0
  28. package/dist-playbooks/keynote-export-pdf.json +20 -0
  29. package/dist-playbooks/keynote-play-slideshow.json +20 -0
  30. package/dist-playbooks/meta-ad-library-competitor-research.json +100 -0
  31. package/dist-playbooks/notes-mastery-workflows.json +468 -0
  32. package/dist-playbooks/pages-export-pdf.json +20 -0
  33. package/dist-playbooks/pages-new-document.json +20 -0
  34. package/dist-playbooks/pages-open-document.json +20 -0
  35. package/dist-playbooks/reminders-complete.json +21 -0
  36. package/dist-playbooks/reminders-create.json +21 -0
  37. package/dist-playbooks/reminders-list.json +22 -0
  38. package/dist-playbooks/reminders-open.json +35 -0
  39. package/dist-playbooks/whatsapp-contact-info.json +32 -0
  40. package/dist-playbooks/whatsapp-navigate.json +71 -0
  41. package/dist-playbooks/whatsapp-new-call.json +32 -0
  42. package/dist-playbooks/whatsapp-new-group.json +32 -0
  43. package/dist-playbooks/whatsapp-search.json +28 -0
  44. package/dist-playbooks/whatsapp-settings.json +23 -0
  45. package/dist-playbooks/x_change_avatar.json +52 -0
  46. package/dist-references/apple-music.json +822 -0
  47. package/dist-references/calendar.json +1020 -0
  48. package/dist-references/finder.json +735 -7
  49. package/dist-references/google-search-competitor-research.json +73 -0
  50. package/dist-references/keynote.json +134 -0
  51. package/dist-references/mail.json +431 -0
  52. package/dist-references/pages.json +1203 -0
  53. package/dist-references/photos.json +642 -0
  54. package/dist-references/reminders.json +835 -0
  55. package/dist-references/terminal.json +640 -0
  56. package/dist-references/whatsapp.json +324 -0
  57. package/package.json +1 -1
@@ -0,0 +1,406 @@
1
+ {
2
+ "app": "com.apple.Photos",
3
+ "appName": "Photos",
4
+ "version": "unknown",
5
+ "masteryLevel": "beginner",
6
+ "rating": {
7
+ "grade": "F",
8
+ "subTier": 1
9
+ },
10
+ "ratingFactors": {
11
+ "featureCoverage": 0,
12
+ "workflowDepth": 0,
13
+ "outcomeVerification": 0,
14
+ "errorRecovery": 0,
15
+ "speedEfficiency": 0,
16
+ "crossFeatureChains": 0,
17
+ "edgeCaseHandling": 0,
18
+ "teachingAbility": 0,
19
+ "platformKnowledge": 0,
20
+ "consistency": 0
21
+ },
22
+ "confidence": 0,
23
+ "lastValidated": "2026-03-23T10:59:34.953Z",
24
+ "mapVersion": 1,
25
+ "uiArchitecture": {
26
+ "type": "other",
27
+ "rendering": "native",
28
+ "axSupport": "partial",
29
+ "bestMethod": "ax",
30
+ "menuStyle": "standard",
31
+ "dragDropHeavy": false,
32
+ "hasCanvas": false
33
+ },
34
+ "zones": {
35
+ "menu_bar": {
36
+ "relativePosition": {
37
+ "top": 0,
38
+ "left": 0,
39
+ "width": 1,
40
+ "height": 0.04
41
+ },
42
+ "type": "toolbar",
43
+ "elements": [
44
+ {
45
+ "label": "Photos",
46
+ "relativeX": 0.02,
47
+ "relativeY": 0.02,
48
+ "anchor": "top-left",
49
+ "ocrBackup": "Photos",
50
+ "successCount": 0,
51
+ "failCount": 0,
52
+ "lastInteracted": "2026-03-23T10:59:34.953Z",
53
+ "sessionsSinceUse": 0
54
+ },
55
+ {
56
+ "label": "File",
57
+ "relativeX": 0.1,
58
+ "relativeY": 0.02,
59
+ "anchor": "top-left",
60
+ "ocrBackup": "File",
61
+ "successCount": 0,
62
+ "failCount": 0,
63
+ "lastInteracted": "2026-03-23T10:59:34.953Z",
64
+ "sessionsSinceUse": 0
65
+ },
66
+ {
67
+ "label": "Edit",
68
+ "relativeX": 0.18,
69
+ "relativeY": 0.02,
70
+ "anchor": "top-left",
71
+ "ocrBackup": "Edit",
72
+ "successCount": 0,
73
+ "failCount": 0,
74
+ "lastInteracted": "2026-03-23T10:59:34.953Z",
75
+ "sessionsSinceUse": 0
76
+ },
77
+ {
78
+ "label": "Image",
79
+ "relativeX": 0.26,
80
+ "relativeY": 0.02,
81
+ "anchor": "top-left",
82
+ "ocrBackup": "Image",
83
+ "successCount": 0,
84
+ "failCount": 0,
85
+ "lastInteracted": "2026-03-23T10:59:34.953Z",
86
+ "sessionsSinceUse": 0
87
+ },
88
+ {
89
+ "label": "View",
90
+ "relativeX": 0.34,
91
+ "relativeY": 0.02,
92
+ "anchor": "top-left",
93
+ "ocrBackup": "View",
94
+ "successCount": 0,
95
+ "failCount": 0,
96
+ "lastInteracted": "2026-03-23T10:59:34.953Z",
97
+ "sessionsSinceUse": 0
98
+ },
99
+ {
100
+ "label": "Window",
101
+ "relativeX": 0.42000000000000004,
102
+ "relativeY": 0.02,
103
+ "anchor": "top-left",
104
+ "ocrBackup": "Window",
105
+ "successCount": 0,
106
+ "failCount": 0,
107
+ "lastInteracted": "2026-03-23T10:59:34.953Z",
108
+ "sessionsSinceUse": 0
109
+ },
110
+ {
111
+ "label": "Help",
112
+ "relativeX": 0.5,
113
+ "relativeY": 0.02,
114
+ "anchor": "top-left",
115
+ "ocrBackup": "Help",
116
+ "successCount": 0,
117
+ "failCount": 0,
118
+ "lastInteracted": "2026-03-23T10:59:34.953Z",
119
+ "sessionsSinceUse": 0
120
+ }
121
+ ],
122
+ "verified": false,
123
+ "lastSeen": "2026-03-23T10:59:34.953Z"
124
+ },
125
+ "menu::photos": {
126
+ "relativePosition": {
127
+ "top": 0.04,
128
+ "left": 0,
129
+ "width": 0.15,
130
+ "height": 0.05
131
+ },
132
+ "type": "menu",
133
+ "elements": [
134
+ {
135
+ "label": "AXMenu",
136
+ "relativeX": 0.02,
137
+ "relativeY": 0.06,
138
+ "anchor": "top-left",
139
+ "ocrBackup": "AXMenu",
140
+ "successCount": 0,
141
+ "failCount": 0,
142
+ "lastInteracted": "2026-03-23T10:59:34.953Z",
143
+ "sessionsSinceUse": 0
144
+ }
145
+ ],
146
+ "verified": false,
147
+ "lastSeen": "2026-03-23T10:59:34.953Z"
148
+ },
149
+ "menu::file": {
150
+ "relativePosition": {
151
+ "top": 0.04,
152
+ "left": 0.08,
153
+ "width": 0.15,
154
+ "height": 0.05
155
+ },
156
+ "type": "menu",
157
+ "elements": [
158
+ {
159
+ "label": "AXMenu",
160
+ "relativeX": 0.1,
161
+ "relativeY": 0.06,
162
+ "anchor": "top-left",
163
+ "ocrBackup": "AXMenu",
164
+ "successCount": 0,
165
+ "failCount": 0,
166
+ "lastInteracted": "2026-03-23T10:59:34.953Z",
167
+ "sessionsSinceUse": 0
168
+ }
169
+ ],
170
+ "verified": false,
171
+ "lastSeen": "2026-03-23T10:59:34.953Z"
172
+ },
173
+ "menu::edit": {
174
+ "relativePosition": {
175
+ "top": 0.04,
176
+ "left": 0.16,
177
+ "width": 0.15,
178
+ "height": 0.05
179
+ },
180
+ "type": "menu",
181
+ "elements": [
182
+ {
183
+ "label": "AXMenu",
184
+ "relativeX": 0.18,
185
+ "relativeY": 0.06,
186
+ "anchor": "top-left",
187
+ "ocrBackup": "AXMenu",
188
+ "successCount": 0,
189
+ "failCount": 0,
190
+ "lastInteracted": "2026-03-23T10:59:34.953Z",
191
+ "sessionsSinceUse": 0
192
+ }
193
+ ],
194
+ "verified": false,
195
+ "lastSeen": "2026-03-23T10:59:34.953Z"
196
+ },
197
+ "menu::image": {
198
+ "relativePosition": {
199
+ "top": 0.04,
200
+ "left": 0.24,
201
+ "width": 0.15,
202
+ "height": 0.05
203
+ },
204
+ "type": "menu",
205
+ "elements": [
206
+ {
207
+ "label": "AXMenu",
208
+ "relativeX": 0.26,
209
+ "relativeY": 0.06,
210
+ "anchor": "top-left",
211
+ "ocrBackup": "AXMenu",
212
+ "successCount": 0,
213
+ "failCount": 0,
214
+ "lastInteracted": "2026-03-23T10:59:34.953Z",
215
+ "sessionsSinceUse": 0
216
+ }
217
+ ],
218
+ "verified": false,
219
+ "lastSeen": "2026-03-23T10:59:34.953Z"
220
+ },
221
+ "menu::view": {
222
+ "relativePosition": {
223
+ "top": 0.04,
224
+ "left": 0.32,
225
+ "width": 0.15,
226
+ "height": 0.05
227
+ },
228
+ "type": "menu",
229
+ "elements": [
230
+ {
231
+ "label": "AXMenu",
232
+ "relativeX": 0.34,
233
+ "relativeY": 0.06,
234
+ "anchor": "top-left",
235
+ "ocrBackup": "AXMenu",
236
+ "successCount": 0,
237
+ "failCount": 0,
238
+ "lastInteracted": "2026-03-23T10:59:34.953Z",
239
+ "sessionsSinceUse": 0
240
+ }
241
+ ],
242
+ "verified": false,
243
+ "lastSeen": "2026-03-23T10:59:34.953Z"
244
+ },
245
+ "menu::window": {
246
+ "relativePosition": {
247
+ "top": 0.04,
248
+ "left": 0.4,
249
+ "width": 0.15,
250
+ "height": 0.05
251
+ },
252
+ "type": "menu",
253
+ "elements": [
254
+ {
255
+ "label": "AXMenu",
256
+ "relativeX": 0.42000000000000004,
257
+ "relativeY": 0.06,
258
+ "anchor": "top-left",
259
+ "ocrBackup": "AXMenu",
260
+ "successCount": 0,
261
+ "failCount": 0,
262
+ "lastInteracted": "2026-03-23T10:59:34.953Z",
263
+ "sessionsSinceUse": 0
264
+ }
265
+ ],
266
+ "verified": false,
267
+ "lastSeen": "2026-03-23T10:59:34.953Z"
268
+ },
269
+ "menu::help": {
270
+ "relativePosition": {
271
+ "top": 0.04,
272
+ "left": 0.48,
273
+ "width": 0.15,
274
+ "height": 0.05
275
+ },
276
+ "type": "menu",
277
+ "elements": [
278
+ {
279
+ "label": "AXMenu",
280
+ "relativeX": 0.5,
281
+ "relativeY": 0.06,
282
+ "anchor": "top-left",
283
+ "ocrBackup": "AXMenu",
284
+ "successCount": 0,
285
+ "failCount": 0,
286
+ "lastInteracted": "2026-03-23T10:59:34.953Z",
287
+ "sessionsSinceUse": 0
288
+ }
289
+ ],
290
+ "verified": false,
291
+ "lastSeen": "2026-03-23T10:59:34.953Z"
292
+ }
293
+ },
294
+ "navigationGraph": {
295
+ "nodes": {},
296
+ "edges": []
297
+ },
298
+ "masteryHistory": [],
299
+ "totalTasksCompleted": 0,
300
+ "sessionCount": 0,
301
+ "featureLadder": [
302
+ {
303
+ "id": "basic_navigation",
304
+ "description": "Open, navigate, and browse the app",
305
+ "level": "beginner",
306
+ "weight": 1,
307
+ "critical": false
308
+ },
309
+ {
310
+ "id": "core_action",
311
+ "description": "Perform the app's primary action",
312
+ "level": "beginner",
313
+ "weight": 1,
314
+ "critical": false
315
+ },
316
+ {
317
+ "id": "settings",
318
+ "description": "Configure settings and preferences",
319
+ "level": "pro",
320
+ "weight": 2,
321
+ "critical": false
322
+ },
323
+ {
324
+ "id": "advanced_features",
325
+ "description": "Use advanced/power-user features",
326
+ "level": "expert",
327
+ "weight": 2,
328
+ "critical": true
329
+ },
330
+ {
331
+ "id": "automation",
332
+ "description": "Automate or customize workflows",
333
+ "level": "grandmaster",
334
+ "weight": 3,
335
+ "critical": true
336
+ }
337
+ ],
338
+ "featureMastery": {
339
+ "file_management": {
340
+ "depth": 2,
341
+ "confidence": 0.3,
342
+ "repeatCount": 0,
343
+ "workflowCount": 0,
344
+ "healingCount": 0,
345
+ "failCount": 0,
346
+ "lastSeen": "2026-03-23T10:59:34.953Z",
347
+ "lastVerified": null
348
+ },
349
+ "editing": {
350
+ "depth": 2,
351
+ "confidence": 0.3,
352
+ "repeatCount": 0,
353
+ "workflowCount": 0,
354
+ "healingCount": 0,
355
+ "failCount": 0,
356
+ "lastSeen": "2026-03-23T10:59:34.953Z",
357
+ "lastVerified": null
358
+ },
359
+ "view_control": {
360
+ "depth": 2,
361
+ "confidence": 0.3,
362
+ "repeatCount": 0,
363
+ "workflowCount": 0,
364
+ "healingCount": 0,
365
+ "failCount": 0,
366
+ "lastSeen": "2026-03-23T10:59:34.953Z",
367
+ "lastVerified": null
368
+ },
369
+ "window_management": {
370
+ "depth": 2,
371
+ "confidence": 0.3,
372
+ "repeatCount": 0,
373
+ "workflowCount": 0,
374
+ "healingCount": 0,
375
+ "failCount": 0,
376
+ "lastSeen": "2026-03-23T10:59:34.953Z",
377
+ "lastVerified": null
378
+ },
379
+ "help_usage": {
380
+ "depth": 2,
381
+ "confidence": 0.3,
382
+ "repeatCount": 0,
383
+ "workflowCount": 0,
384
+ "healingCount": 0,
385
+ "failCount": 0,
386
+ "lastSeen": "2026-03-23T10:59:34.953Z",
387
+ "lastVerified": null
388
+ }
389
+ },
390
+ "masteryMetrics": {
391
+ "breadth": 0,
392
+ "workflowBreadth": 0,
393
+ "outcomeBreadth": 0,
394
+ "reliability": 0,
395
+ "healingRate": 0,
396
+ "crossFeatureWorkflows": 0,
397
+ "criticalFloor": 0,
398
+ "weightedScore": 0
399
+ },
400
+ "crossFeatureWorkflows": 0,
401
+ "actionSuccessCount": 0,
402
+ "actionFailCount": 0,
403
+ "shortcutsUsed": 0,
404
+ "playbooksExported": 0,
405
+ "edgeCasesHandled": 0
406
+ }