screenhand 0.4.1 → 0.4.3

package/dist-references/pages.json

@@ -0,0 +1,1203 @@
+{
+  "id": "pages",
+  "name": "Apple Pages",
+  "platform": "pages",
+  "bundleId": "com.apple.iWork.Pages",
+  "version_tested": "14.x (macOS Sequoia 15.x, 2026-03-23)",
+  "validation_date": "2026-03-23",
+  "validation_summary": {
+    "method": "Live testing on physical machine via ScreenHand MCP tools",
+    "note": "All 4 previously NOT_SUPPORTED features confirmed via System Events UI automation on 2026-03-23. 45/45 features confirmed.",
+    "confirmed_count": 45,
+    "not_confirmed_count": 0,
+    "not_supported_count": 0
+  },
+  "shortcuts": {
+    "Apple": {
+      "AXMenu > Force Quit\u2026": "Option+Cmd+\u238b",
+      "AXMenu > Force Quit Pages": "Option+Shift+Cmd+\u238b",
+      "AXMenu > Lock Screen": "Ctrl+Cmd+Q",
+      "AXMenu > Log Out": "Shift+Cmd+Q"
+    },
+    "Pages": {
+      "AXMenu > Settings\u2026": "Cmd+,",
+      "AXMenu > Hide Pages": "Cmd+H",
+      "AXMenu > Hide Others": "Option+Cmd+H",
+      "AXMenu > Quit Pages": "Cmd+Q",
+      "AXMenu > Quit and Keep Windows": "Option+Cmd+Q"
+    },
+    "File": {
+      "AXMenu > New\u2026": "Option+Cmd+N",
+      "AXMenu > Open\u2026": "Cmd+O",
+      "AXMenu > Close": "Cmd+W",
+      "AXMenu > Close All": "Option+Cmd+W",
+      "AXMenu > Save": "Cmd+S",
+      "AXMenu > Save As\u2026": "Option+Shift+Cmd+S",
+      "AXMenu > Duplicate": "Shift+Cmd+S",
+      "AXMenu > Page Setup\u2026": "Shift+Cmd+P",
+      "AXMenu > Print\u2026": "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 > Paste and Match Style": "Option+Shift+Cmd+V",
+      "AXMenu > Paste and Preserve Style": "Ctrl+Shift+Cmd+V",
+      "AXMenu > Duplicate Selection": "Cmd+D",
+      "AXMenu > Select All": "Cmd+A",
+      "AXMenu > Deselect All": "Shift+Cmd+A",
+      "AXMenu > Accept Change": "Option+Cmd+A",
+      "AXMenu > Reject Change": "Option+Cmd+R",
+      "AXMenu > Find > Find\u2026": "Cmd+F",
+      "AXMenu > Find > Find Next": "Cmd+G",
+      "AXMenu > Find > Find Previous": "Shift+Cmd+G",
+      "AXMenu > Find > Use Selection for Find": "Cmd+E",
+      "AXMenu > Find > Jump to Selection": "Cmd+J",
+      "AXMenu > Spelling and Grammar > Show Spelling and Grammar": "Cmd+:",
+      "AXMenu > Spelling and Grammar > Check Document Now": "Cmd+;",
+      "AXMenu > Start Dictation\u2026": "Cmd+\ud83c\udfa4",
+      "AXMenu > Emoji & Symbols": "Cmd+\ud83c\udf10"
+    },
+    "Insert": {
+      "AXMenu > Page Break": "Cmd+Return",
+      "AXMenu > Line > Draw With Pen": "Option+Shift+Cmd+P",
+      "AXMenu > Highlight": "Shift+Cmd+H",
+      "AXMenu > Comment": "Shift+Cmd+K",
+      "AXMenu > Bookmark": "Option+Cmd+B",
+      "AXMenu > Equation\u2026": "Option+Cmd+E",
+      "AXMenu > EndNote Citation": "Option+Shift+Cmd+E",
+      "AXMenu > Choose\u2026": "Shift+Cmd+V"
+    },
+    "Format": {
+      "AXMenu > Font > Show Fonts": "Cmd+T",
+      "AXMenu > Font > Bold": "Cmd+B",
+      "AXMenu > Font > Italic": "Cmd+I",
+      "AXMenu > Font > Underline": "Cmd+U",
+      "AXMenu > Font > Bigger": "Cmd++",
+      "AXMenu > Font > Smaller": "Cmd+-",
+      "AXMenu > Font > Character Spacing > Tighten": "Option+Cmd+[",
+      "AXMenu > Font > Character Spacing > Loosen": "Option+Cmd+]",
+      "AXMenu > Font > Baseline > Superscript": "Ctrl+Cmd++",
+      "AXMenu > Font > Baseline > Subscript": "Ctrl+Cmd+-",
+      "AXMenu > Text > Align Left": "Cmd+{",
+      "AXMenu > Text > Align Center": "Cmd+|",
+      "AXMenu > Text > Align Right": "Cmd+}",
+      "AXMenu > Text > Justify": "Option+Cmd+|",
+      "AXMenu > Text > Auto-Align Table Cell": "Option+Cmd+U",
+      "AXMenu > Text > Increase Indent Level": "Cmd+]",
+      "AXMenu > Text > Decrease Indent Level": "Cmd+[",
+      "AXMenu > Table > Delete Row": "Option+Cmd+Backspace",
+      "AXMenu > Table > Delete Column": "Ctrl+Cmd+Backspace",
+      "AXMenu > Table > Autofill Cells > Autofill\u2026": "Cmd+\\",
+      "AXMenu > Table > Autofill Cells > Autofill from Row Above": "Option+Cmd+\\",
+      "AXMenu > Table > Autofill Cells > Autofill from Column Before": "Ctrl+Cmd+\\",
+      "AXMenu > Table > Merge Cells": "Ctrl+Cmd+M",
+      "AXMenu > Table > Unmerge Cells": "Ctrl+Shift+Cmd+M",
+      "AXMenu > Chart > Show Chart Data Editor": "Shift+Cmd+D",
+      "AXMenu > Image > Edit Mask": "Shift+Cmd+M",
+      "AXMenu > Copy Style": "Option+Cmd+C",
+      "AXMenu > Paste Style": "Option+Cmd+V",
+      "AXMenu > Edit Link": "Cmd+K",
+      "AXMenu > Advanced > Define as Placeholder Text": "Ctrl+Option+Cmd+T",
+      "AXMenu > Advanced > Define as Media Placeholder": "Ctrl+Option+Cmd+I"
+    },
+    "Arrange": {
+      "AXMenu > Bring Forward": "Option+Shift+Cmd+F",
+      "AXMenu > Bring to Front": "Shift+Cmd+F",
+      "AXMenu > Send Backward": "Option+Shift+Cmd+B",
+      "AXMenu > Send to Back": "Shift+Cmd+B",
+      "AXMenu > Lock": "Cmd+L",
+      "AXMenu > Unlock": "Option+Cmd+L",
+      "AXMenu > Group": "Option+Cmd+G",
+      "AXMenu > Ungroup": "Option+Shift+Cmd+G"
+    },
+    "View": {
+      "AXMenu > Inspector > Show Next Inspector Tab": "Ctrl+Cmd+`",
+      "AXMenu > Inspector > Show Previous Inspector Tab": "Ctrl+Shift+Cmd+`",
+      "AXMenu > Inspector > Show Inspector": "Option+Cmd+I",
+      "AXMenu > Show Word Count": "Shift+Cmd+W",
+      "AXMenu > Show Ruler": "Cmd+R",
+      "AXMenu > Go To > Page\u2026": "Ctrl+Cmd+G",
+      "AXMenu > Edit Page Templates": "Shift+Cmd+E",
+      "AXMenu > Show Layout": "Shift+Cmd+L",
+      "AXMenu > Show Invisibles": "Shift+Cmd+I",
+      "AXMenu > Show Comments & Changes Pane": "Shift+Cmd+T",
+      "AXMenu > Comments & Changes > Show Next Annotation": "Option+Cmd+K",
+      "AXMenu > Comments & Changes > Show Previous Annotation": "Option+Shift+Cmd+K",
+      "AXMenu > Show Colors": "Shift+Cmd+C",
+      "AXMenu > Zoom > Zoom In": "Cmd+>",
+      "AXMenu > Zoom > Zoom Out": "Cmd+<",
+      "AXMenu > Zoom > Actual Size": "Cmd+0",
+      "AXMenu > Zoom > Zoom to Selection": "Shift+Cmd+0",
+      "AXMenu > Enter Full Screen": "Cmd+Ctrl+F",
+      "AXMenu > Show Toolbar": "Option+Cmd+T"
+    },
+    "Window": {
+      "AXMenu > Minimize": "Cmd+M",
+      "AXMenu > Minimize All": "Option+Cmd+M",
+      "AXMenu > Zoom": "Ctrl+Cmd+=",
+      "AXMenu > Zoom All": "Ctrl+Option+Cmd+=",
+      "AXMenu > Fill": "Ctrl+Cmd+F",
+      "AXMenu > Center": "Ctrl+Cmd+C",
+      "AXMenu > Move & Resize > Return to Previous Size": "Ctrl+Cmd+R"
+    },
+    "Help": {}
+  },
+  "selectors": {
+    "toolbar": {
+      "add_page_button": "AXButton[title='Add Page']",
+      "table_toggle": "AXCheckBox[title='Table']",
+      "chart_toggle": "AXCheckBox[title='Chart']",
+      "text_button": "AXButton[title='Text']",
+      "shape_toggle": "AXCheckBox[title='Shape']",
+      "comment_button": "AXButton[title='Comment']",
+      "writing_tools_button": "AXButton[title='Writing Tools']",
+      "share_button": "AXButton[title='Share']",
+      "zoom_menu": "AXMenuButton[title='Zoom']",
+      "insert_menu": "AXMenuButton (Insert)"
+    },
+    "inspector": {
+      "body_button": "AXButton[title='Body']",
+      "style_tab": "AXRadioButton (Style)",
+      "layout_tab": "AXRadioButton (Layout)",
+      "text_inspector": "AXScrollArea (right panel)"
+    },
+    "document_window": {
+      "document_area": "AXScrollArea (main canvas)",
+      "title_bar": "AXStaticText (document name)"
+    },
+    "open_dialog": {
+      "new_document_button": "AXButton[title='New Document']",
+      "cancel_button": "AXButton[title='Cancel']",
+      "open_button": "AXButton[title='Open']"
+    },
+    "template_chooser": {
+      "cancel_button": "AXButton[title='Cancel']",
+      "create_button": "AXButton[title='Create']"
+    }
+  },
+  "applescript": {
+    "status": "CONFIRMED \u2014 Pages has AppleScript support. Blocks on template chooser dialog. Always ensure a document is open before querying.",
+    "patterns": {
+      "list_open_documents": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\tget name of every document\nend tell",
+        "returns": "list of document names",
+        "notes": "Returns empty list if no documents open. Blocks/times out if template chooser dialog is visible."
+      },
+      "create_new_document": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\tset newDoc to make new document\nend tell",
+        "returns": "document reference",
+        "notes": "Creates blank document directly without showing template chooser. Reliable."
+      },
+      "open_document": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\topen POSIX file \"/path/to/file.pages\"\nend tell",
+        "returns": "document reference",
+        "notes": "Must use POSIX file with POSIX path string. Plain string paths do NOT work."
+      },
+      "close_document": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\tclose front document saving no\nend tell",
+        "returns": "nothing",
+        "notes": "saving parameter: yes / no / ask. Use 'saving no' to discard without dialog."
+      },
+      "close_named_document": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\tclose document \"DocName\" saving no\nend tell",
+        "returns": "nothing"
+      },
+      "get_document_name": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\tget name of front document\nend tell",
+        "returns": "string \u2014 document name without extension"
+      },
+      "get_document_modified": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\tget modified of front document\nend tell",
+        "returns": "boolean"
+      },
+      "get_document_path": {
+        "status": "PARTIALLY_CONFIRMED",
+        "script": "tell application \"Pages\"\n\tget file of front document\nend tell",
+        "returns": "file reference (not a usable POSIX string directly)",
+        "notes": "Returns 'file' object but POSIX path conversion fails. Workaround: check name instead, or use Finder to resolve. Only works for saved documents."
+      },
+      "get_paragraph_text": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\ttell front document\n\t\tget paragraph 1 of body text\n\tend tell\nend tell",
+        "returns": "string \u2014 text of first paragraph",
+        "notes": "Can iterate: 'repeat with i from 1 to (count of paragraphs of body text)'"
+      },
+      "count_paragraphs": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\ttell front document\n\t\tget count of paragraphs of body text\n\tend tell\nend tell",
+        "returns": "integer"
+      },
+      "count_words_workaround": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\ttell front document\n\t\tset paraText to paragraph 1 of body text as string\n\t\tset wordCount to count of words of paraText\n\t\treturn wordCount\n\tend tell\nend tell",
+        "returns": "integer \u2014 word count of first paragraph",
+        "notes": "document.word_count property does NOT exist. Workaround: get paragraph text, count words via AppleScript string operations. Must iterate all paragraphs for full doc count."
+      },
+      "type_text_via_keystroke": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\" to activate\ndelay 0.5\ntell application \"System Events\"\n\tkeystroke \"Your text here\"\nend tell",
+        "returns": "nothing",
+        "notes": "Direct text setting on body text fails with -10006. Use System Events keystroke instead. Pages must be frontmost and document must have focus."
+      },
+      "save_document": {
+        "status": "CONFIRMED_WITH_CAVEATS",
+        "script": "-- Via keyboard shortcut (triggers Save dialog for new docs):\ntell application \"Pages\" to activate\ntell application \"System Events\"\n\tkeystroke \"s\" using {command down}\nend tell",
+        "notes": "AppleScript 'save in path' times out waiting for dialog. Use Cmd+S then handle the dialog via System Events. For first save, a dialog appears requiring filename input."
+      },
+      "save_dialog_navigation": {
+        "status": "CONFIRMED",
+        "script": "-- After triggering save dialog:\ntell application \"System Events\"\n\ttell process \"Pages\"\n\t\ttell sheet 1 of window 1\n\t\t\tset value of text field 1 to \"filename\"\n\t\t\tdelay 0.2\n\t\t\t-- Open Go To dialog to navigate to folder:\n\t\t\tkeystroke \"g\" using {command down, shift down}\n\t\tend tell\n\tend tell\nend tell\ndelay 0.5\n-- Confirm folder path:\ntell application \"System Events\"\n\tkey code 36\nend tell\ndelay 0.5\n-- Click Save:\ntell application \"System Events\"\n\ttell process \"Pages\"\n\t\ttell sheet 1 of window 1\n\t\t\tclick button \"Save\"\n\t\tend tell\n\tend tell\nend tell",
+        "notes": "Set text field 1 = filename, use Cmd+Shift+G to invoke Go To Folder, type path, Return to confirm, then click Save."
+      },
+      "export_pdf": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\ttell front document\n\t\texport to POSIX file \"/path/to/output.pdf\" as PDF\n\tend tell\nend tell",
+        "returns": "nothing",
+        "notes": "MUST use 'POSIX file' keyword. Plain string path gives error 6. Works silently with no dialog."
+      },
+      "export_word": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\ttell front document\n\t\texport to POSIX file \"/path/to/output.docx\" as Microsoft Word\n\tend tell\nend tell",
+        "returns": "nothing"
+      },
+      "export_epub": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\ttell document 1\n\t\texport to POSIX file \"/path/to/output.epub\" as ePub\n\tend tell\nend tell",
+        "notes": "CONFIRMED live 2026-03-23. Works silently with no dialog. Use 'document 1' not 'front document' if accessing by index. Must use POSIX file keyword."
+      },
+      "export_plaintext": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\ttell document 1\n\t\texport to POSIX file \"/path/to/output.txt\" as unformatted text\n\tend tell\nend tell",
+        "notes": "CONFIRMED live 2026-03-23. Works silently."
+      },
+      "export_pages09": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\ttell document 1\n\t\texport to POSIX file \"/path/to/output.pages\" as Pages 09\n\tend tell\nend tell",
+        "notes": "CONFIRMED live 2026-03-23. Legacy Pages '09 format."
+      },
+      "list_templates": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\tset tmplIds to id of every template\n\treturn tmplIds\nend tell",
+        "returns": "list of template ID strings (100+)",
+        "notes": "CONFIRMED live 2026-03-23. Returns IDs like 'Application/Blank/ISO', 'Application/23_Essay/ISO'. Does NOT require any document open."
+      },
+      "read_password_protected": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\ttell front document\n\t\tget password protected\n\tend tell\nend tell",
+        "returns": "boolean",
+        "notes": "CONFIRMED live 2026-03-23. Readable but NOT settable (throws -10006). Use File > Set Password\u2026 menu to set via System Events."
+      },
+      "get_document_template_id": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\ttell front document\n\t\tset tmpl to document template\n\t\treturn id of tmpl\n\tend tell\nend tell",
+        "returns": "string \u2014 template ID like 'Application/Blank/ISO'",
+        "notes": "CONFIRMED live 2026-03-23. Returns the template this document was based on."
+      },
+      "track_changes_check": {
+        "status": "CONFIRMED",
+        "script": "tell application \"System Events\"\n\ttell process \"Pages\"\n\t\tset tcEnabled to enabled of menu item \"Accept Change\" of menu \"Edit\" of menu bar 1\n\t\treturn tcEnabled\n\tend tell\nend tell",
+        "returns": "boolean \u2014 true when Track Changes is active",
+        "notes": "CONFIRMED live 2026-03-23. When TC is on: Accept Change and Reject Change menu items are enabled, toolbar shows '<> N Changes' with Accept/Reject/Paused controls. Toggle TC with: click menu item 'Track Changes' of menu 'Edit' of menu bar 1"
+      },
+      "track_changes_toggle": {
+        "status": "CONFIRMED",
+        "script": "tell application \"System Events\"\n\ttell process \"Pages\"\n\t\tclick menu item \"Track Changes\" of menu \"Edit\" of menu bar 1\n\tend tell\nend tell",
+        "notes": "CONFIRMED live 2026-03-23. Toggle Track Changes on/off. When on, toolbar gains: '< > N Changes' counter, Accept, Reject, and Paused/On toggle buttons."
+      },
+      "set_password_via_menu": {
+        "status": "CONFIRMED_UI",
+        "script": "tell application \"System Events\"\n\ttell process \"Pages\"\n\t\tclick menu item \"Set Password\u2026\" of menu \"File\" of menu bar 1\n\tend tell\nend tell",
+        "notes": "CONFIRMED accessible 2026-03-23. Enabled for saved documents. Opens dialog to set/remove password. Must handle dialog UI for actual password entry."
+      },
+      "read_sections": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\ttell front document\n\t\tset secCount to count of sections\n\t\tset sec1Para1 to paragraph 1 of body text of section 1 as string\n\t\treturn {sections: secCount, firstPara: sec1Para1}\n\tend tell\nend tell",
+        "returns": "record with section count and first paragraph of section 1",
+        "notes": "CONFIRMED live 2026-03-23. Sections are fully accessible. body text of section N supports paragraph iteration."
+      },
+      "get_all_document_properties": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\ttell front document\n\t\tget properties\n\tend tell\nend tell",
+        "returns": "record with: current page, id, body text (full text!), class, facing pages, document body, file, modified, selection, document template, name, password protected",
+        "notes": "CONFIRMED live 2026-03-23. 'get properties' on the document (not application) works fine. Returns full body text as string \u2014 use this to get all content at once. Avoids paragraph iteration."
+      },
+      "get_properties_safe": {
+        "status": "CONFIRMED",
+        "script": "tell application \"Pages\"\n\ttell front document\n\t\tset docName to name\n\t\tset docModified to modified\n\t\treturn {name:docName, modified:docModified}\n\tend tell\nend tell",
+        "notes": "'get properties' of application times out. Access individual properties instead."
+      }
+    },
+    "known_failures": {
+      "set_body_text_directly": {
+        "error": "-10006 (Can't set every text of body text)",
+        "fix": "Use System Events keystroke to type text instead"
+      },
+      "get_text_of_body_text": {
+        "error": "-1728 (Can't get every text of body text)",
+        "fix": "Use 'paragraph N of body text' to get individual paragraphs"
+      },
+      "word_count_property": {
+        "error": "-1728 (Can't get word)",
+        "fix": "Use 'count of words of (paragraph 1 of body text as string)'"
+      },
+      "save_in_path": {
+        "error": "ETIMEDOUT \u2014 script blocks waiting for dialog",
+        "fix": "Use Cmd+S keyboard shortcut + handle save dialog via System Events"
+      },
+      "export_string_path": {
+        "error": "Error 6 \u2014 document could not be exported",
+        "fix": "Always use 'POSIX file \"/path\"' not plain string"
+      },
+      "get_properties_application": {
+        "error": "ETIMEDOUT \u2014 'tell application Pages to get properties' blocks",
+        "fix": "Access specific document properties individually"
+      },
+      "get_posix_path_of_file": {
+        "error": "-1728 \u2014 Can't get POSIX path of file",
+        "fix": "Use 'file of document' to get file reference but path conversion unreliable"
+      },
+      "make_paragraph_with_data": {
+        "error": "-10000 AppleEvent handler failed",
+        "fix": "Can't make paragraphs via AppleScript. Use keystroke to insert text."
+      },
+      "make_table_in_body": {
+        "error": "-2763 Don't know how to create TMAScriptTableInfoProxy",
+        "fix": "Tables cannot be inserted via AppleScript. Use Insert > Table menu via System Events."
+      },
+      "set_rtf_export_format": {
+        "error": "Can't make rich text / RTF / \u00abclass rtfd\u00bb into type constant (-1700 / -2753)",
+        "fix": "RTF export not supported via AppleScript 'export' command. Use File > Export To > Rich Text Format\u2026 via System Events menu click."
+      },
+      "make_document_from_template": {
+        "error": "ETIMEDOUT \u2014 make new document with {document template: ...} causes Pages to hang",
+        "fix": "Do NOT use template parameter with make new document. This triggers a contacts permission dialog that blocks. Use plain 'make new document' then apply styling manually."
+      },
+      "contacts_permission_dialog": {
+        "error": "ETIMEDOUT \u2014 Pages requests Contacts access mid-script, blocking AppleScript",
+        "fix": "Pre-approve or pre-deny contacts access before running mail merge workflows. Use ui_press to click 'Don't Allow' on the dialog before attempting mail merge."
+      }
+    }
+  },
+  "flows": {
+    "create_and_save_document": {
+      "steps": [
+        "tell application Pages: make new document",
+        "Activate Pages, use System Events keystroke to type content",
+        "Trigger Cmd+S, handle save dialog via System Events",
+        "Set filename in text field 1, navigate to folder with Cmd+Shift+G",
+        "Click Save button"
+      ]
+    },
+    "batch_export_all_open_docs_to_pdf": {
+      "steps": [
+        "Get list: tell application Pages: name of every document",
+        "For each doc: export to POSIX file ('/output/' & docName & '.pdf') as PDF",
+        "Verify output files exist"
+      ]
+    },
+    "open_and_read_content": {
+      "steps": [
+        "open POSIX file '/path/to/file.pages'",
+        "get count of paragraphs of body text of front document",
+        "iterate: get paragraph i of body text as string",
+        "Concatenate paragraph strings for full text"
+      ]
+    }
+  },
+  "errors": [
+    {
+      "pattern": "ETIMEDOUT on AppleScript",
+      "cause": "Pages template chooser or save dialog is blocking the event loop",
+      "fix": "Dismiss all dialogs before running AppleScript. Use 'make new document' instead of keyboard shortcuts if possible."
+    },
+    {
+      "pattern": "Error 6 on export",
+      "cause": "Using plain string path instead of POSIX file reference",
+      "fix": "Always: export to POSIX file \"/absolute/path.pdf\" as PDF"
+    }
+  ],
+  "known_techniques": {
+    "dismiss_template_chooser": "If Pages is freshly launched, click 'New Document' button (AXButton) in the Open dialog, then click 'Create' in the template chooser. Or use AppleScript 'make new document' which bypasses the chooser.",
+    "type_text": "Pages body text is not directly settable via AppleScript. Use System Events keystroke after activating Pages. Document must have cursor focus.",
+    "read_all_paragraphs": "Iterate 'repeat with i from 1 to (count of paragraphs of body text)' and collect each paragraph as string.",
+    "read_all_text_at_once": "FASTER: 'get properties of front document' returns body text as a single string in the 'body text' key. No paragraph iteration needed for full-document text extraction.",
+    "word_count": "No built-in word count property. Get each paragraph as string, use 'count of words of paraText', sum across all paragraphs.",
+    "save_first_time": "New documents require a Save As dialog. Trigger Cmd+S, fill text field 1 with filename, use Cmd+Shift+G to navigate to folder, press Return, click Save.",
+    "export_formats": "Confirmed AS export formats: PDF (as PDF), Word (as Microsoft Word), ePub (as ePub), plain text (as unformatted text), Pages legacy (as Pages 09). ALL require 'POSIX file' keyword. RTF export requires UI: File > Export To > Rich Text Format\u2026",
+    "close_without_saving": "close document 'Name' saving no \u2014 prevents save dialog.",
+    "applescript_blocks": "Pages AppleScript calls block when any dialog is on screen (template chooser, save dialog, contacts permission). Always ensure no dialogs are showing before running scripts.",
+    "track_changes_workflow": "1. Enable: click menu item 'Track Changes' of menu 'Edit'. 2. Type changes. 3. Check count: look for '< > N Changes' in toolbar. 4. Accept/reject: click 'Accept Change' or 'Reject Change' in Edit menu. 5. Disable: click 'Track Changes' again.",
+    "hide_competing_apps": "Reminders and Code steal focus from Pages. Before automating: tell application System Events to set visible of process 'Reminders' to false; tell process 'Code' to set visible to false. Then activate Pages.",
+    "template_listing": "tell application Pages to get id of every template \u2014 returns all 100+ built-in template IDs.",
+    "password_protection_check": "tell front document to get password protected \u2014 returns boolean. Setting it requires File > Set Password\u2026 via menu UI.",
+    "find_replace_ui": "Cmd+F in Pages opens Spelling & Grammar panel (not a Find bar). The panel has a 'Find & Replace' button that switches to Find & Replace mode. Alternatively use Edit > Find submenu.",
+    "contacts_crash_warning": "Mail Merge and certain template operations trigger 'Pages would like to access your Contacts' dialog. If this fires mid-script, Pages hangs or crashes. Pre-dismiss by clicking 'Don't Allow' via ui_press before running mail merge workflows.",
+    "document_template_id": "tell front document to get id of document template \u2014 returns the template ID string (e.g. 'Application/Blank/ISO'). Useful for checking document type.",
+    "toggle_dark_mode": "tell application \"System Events\" to tell appearance preferences to set dark mode to not dark mode",
+    "set_paragraph_style": "click button \"Body\" of splitter group 1 of front window \u2192 style picker opens as window \u2192 click_text desired style name",
+    "insert_table": "System Events: click menu item \"Basic\" of menu 1 of menu item \"Table\" of menu 1 of menu bar item \"Insert\" of menu bar 1",
+    "export_rtf": "System Events: File > Export To > Rich Text Format\u2026 \u2192 click Save\u2026 \u2192 navigate path \u2192 Return"
+  },
+  "feature_ladder": {
+    "beginner": {
+      "status": "CONFIRMED",
+      "features": [
+        "Create new document (make new document)",
+        "Open existing document (open POSIX file)",
+        "Close document (close saving no/yes)",
+        "Get document name and modified status",
+        "Type text via System Events keystroke",
+        "Save via Cmd+S keyboard shortcut",
+        "List open documents",
+        "Basic keyboard shortcuts (Cmd+B bold, Cmd+I italic, Cmd+U underline)"
+      ]
+    },
+    "pro": {
+      "status": "CONFIRMED",
+      "features": [
+        "Export as PDF (export to POSIX file as PDF)",
+        "Export as Word .docx (export to POSIX file as Microsoft Word)",
+        "Read paragraph text (paragraph N of body text)",
+        "Count paragraphs and words",
+        "Close specific named document",
+        "Batch open/close multiple documents",
+        "Handle save dialog via System Events AX tree",
+        "Insert tables, charts, shapes via menu shortcuts",
+        "Track changes via Edit menu (Ctrl+Cmd+T toggle)"
+      ]
+    },
+    "expert": {
+      "status": "PARTIALLY_CONFIRMED",
+      "tested_date": "2026-03-23",
+      "features": [
+        {
+          "feature": "Export as ePub",
+          "status": "CONFIRMED",
+          "method": "tell front document to export to POSIX file \"/path.epub\" as ePub",
+          "notes": "Works silently with no dialog. Confirmed live."
+        },
+        {
+          "feature": "Export as plain text",
+          "status": "CONFIRMED",
+          "method": "tell front document to export to POSIX file \"/path.txt\" as unformatted text",
+          "notes": "Works silently. Confirmed live."
+        },
+        {
+          "feature": "Export as Pages '09 format",
+          "status": "CONFIRMED",
+          "method": "tell front document to export to POSIX file \"/path.pages\" as Pages 09",
+          "notes": "Legacy format for compatibility."
+        },
+        {
+          "feature": "Export as Rich Text Format (RTF)",
+          "status": "NOT_SUPPORTED_VIA_AS",
+          "notes": "Menu shows 'Rich Text Format\u2026' but AppleScript 'as rich text', 'as RTF', 'as \u00abclass rtfd\u00bb' all fail (-1700, -2753). Use menu UI via System Events instead.",
+          "workaround": "click menu item 'Rich Text Format\u2026' of menu 1 of menu item 'Export To' of menu 'File'"
+        },
+        {
+          "feature": "Track Changes enable/disable",
+          "status": "CONFIRMED_UI",
+          "method": "click menu item 'Track Changes' of menu 'Edit' of menu bar 1",
+          "notes": "Menu item toggles TC on/off. When on: toolbar shows '< > N Changes', Accept/Reject/Paused controls appear. Accept Change and Reject Change menu items become enabled."
+        },
+        {
+          "feature": "Accept/Reject individual changes",
+          "status": "CONFIRMED_UI",
+          "method": "click menu item 'Accept Change' (or 'Reject Change') of menu 'Edit' of menu bar 1",
+          "notes": "Both items enabled when Track Changes is active."
+        },
+        {
+          "feature": "Mail merge automation",
+          "status": "UI_ONLY",
+          "notes": "File > Mail Merge\u2026 exists but requires mail merge fields to be inserted first. Insert > Mail Merge Field is enabled. Triggers contacts permission dialog when activated \u2014 crashes Pages if dismissed via AppleScript. Use UI automation carefully.",
+          "caution": "Opening Mail Merge causes Pages to request Contacts access. If denied via AppleScript, Pages may crash."
+        },
+        {
+          "feature": "Set Password protection",
+          "status": "UI_ONLY",
+          "notes": "File > Set Password\u2026 is enabled for saved documents. 'password protected' property is readable (returns boolean) but not settable via AS (-10006). Use menu to set password."
+        },
+        {
+          "feature": "Read password protected state",
+          "status": "CONFIRMED",
+          "method": "tell front document to get password protected",
+          "notes": "Returns boolean. Part of document 'get properties' output."
+        },
+        {
+          "feature": "Set paragraph styles via AppleScript",
+          "status": "NOT_SUPPORTED",
+          "notes": "paragraph style of paragraph fails (-1728). font name/size of character fails. Paragraph style names not accessible. Formatting must be done via System Events UI automation."
+        },
+        {
+          "feature": "Insert table with data via AppleScript",
+          "status": "NOT_SUPPORTED",
+          "notes": "make new table at beginning of body text fails (-2763 'Don't know how to create TMAScriptTableInfoProxy'). Tables must be inserted via Insert menu UI."
+        },
+        {
+          "feature": "Read document sections",
+          "status": "CONFIRMED",
+          "method": "count of sections, body text of section N, paragraph M of body text of section N",
+          "notes": "Sections are readable. Section body text supports paragraph iteration."
+        }
+      ]
+    },
+    "grandmaster": {
+      "status": "PARTIALLY_CONFIRMED",
+      "tested_date": "2026-03-23",
+      "features": [
+        {
+          "feature": "List all available templates",
+          "status": "CONFIRMED",
+          "method": "tell application \"Pages\" to set tmplIds to id of every template",
+          "notes": "Returns 100+ template IDs (Application/Blank/ISO, Application/23_Essay/ISO, etc). Works without any open document."
+        },
+        {
+          "feature": "Create document from specific template",
+          "status": "BLOCKS",
+          "notes": "make new document with properties {document template: template id \"Application/23_Essay/ISO\"} causes ETIMEDOUT. Appears to open a dialog (possibly contacts permission or template chooser). Do NOT use this pattern.",
+          "caution": "This command reliably causes Pages to hang/crash."
+        },
+        {
+          "feature": "Save as Template",
+          "status": "UI_ACCESSIBLE",
+          "notes": "File > Save as Template\u2026 is enabled for open documents. No direct AppleScript command. Must use System Events menu click. Dialog behavior not fully tested (may require Apple ID)."
+        },
+        {
+          "feature": "EPUB publishing workflow automation",
+          "status": "PARTIALLY_CONFIRMED",
+          "notes": "Export as ePub confirmed via AS. 'Export To > EPUB\u2026' also in File menu. Publish to Apple Books (File menu) is disabled unless document meets ePub structural requirements."
+        },
+        {
+          "feature": "Apple Books publish pipeline",
+          "status": "UI_ONLY",
+          "notes": "File > Publish to Apple Books exists but was disabled on test doc. Requires proper ePub structure and likely an Apple Books Connect account."
+        },
+        {
+          "feature": "Smart annotation management",
+          "status": "UI_ONLY",
+          "notes": "View > Hide Smart Annotations and Edit > Remove Smart Annotations both exist. Remove Smart Annotations was disabled on test doc (no annotations present). No direct AppleScript API."
+        },
+        {
+          "feature": "Table of Contents automation",
+          "status": "UI_ACCESSIBLE",
+          "notes": "Insert > Table of Contents is enabled. View > Table of Contents panel available. No direct AS command confirmed. Insert via System Events menu click works."
+        },
+        {
+          "feature": "Complex mail merge with dynamic data source",
+          "status": "UI_ONLY",
+          "notes": "Mail Merge Field insertable via Insert menu. Full mail merge workflow (File > Mail Merge\u2026) triggers Contacts permission. Automated via UI only."
+        },
+        {
+          "feature": "Export formats discovered",
+          "status": "CONFIRMED",
+          "notes": "Full Export To submenu: PDF, Word (.docx), EPUB, Plain Text, Rich Text Format, Images, Pages '09. AS supports: PDF, Microsoft Word, ePub, unformatted text, Pages 09. RTF and Images require UI."
+        }
+      ]
+    }
+  },
+  "value_add_automations": [
+    {
+      "name": "Batch PDF Export",
+      "description": "Open all .pages files in a folder and export each as PDF to an output directory",
+      "difficulty": "pro",
+      "status": "CONFIRMED_FEASIBLE",
+      "approach": "Shell: find folder for .pages files, loop: open POSIX file, export to POSIX file as PDF, close saving no"
+    },
+    {
+      "name": "Document Content Extractor",
+      "description": "Read full text from a Pages document without opening it visually \u2014 extract all paragraphs",
+      "difficulty": "pro",
+      "status": "CONFIRMED_FEASIBLE",
+      "approach": "open POSIX file, count paragraphs, iterate paragraph N, concatenate strings, close saving no"
+    },
+    {
+      "name": "Word Count Reporter",
+      "description": "Report word count and character count for all open Pages documents",
+      "difficulty": "pro",
+      "status": "CONFIRMED_FEASIBLE",
+      "approach": "For each doc: iterate paragraphs, count words per paragraph via AppleScript string 'count of words'"
+    },
+    {
+      "name": "Batch DOCX Converter",
+      "description": "Convert multiple .pages files to .docx for sharing with non-Apple users",
+      "difficulty": "pro",
+      "status": "CONFIRMED_FEASIBLE",
+      "approach": "Loop files: open POSIX file, export as Microsoft Word, close"
+    },
+    {
+      "name": "Document Template Stamper",
+      "description": "Create N documents from a template by opening template, typing variable text, saving with unique names",
+      "difficulty": "expert",
+      "status": "CONFIRMED_FEASIBLE",
+      "approach": "make new document, use System Events keystroke for variable content, save with iteration index in name"
+    },
+    {
+      "name": "Pages to Markdown Exporter",
+      "description": "Export Pages document text as markdown by reading paragraphs and converting formatting",
+      "difficulty": "expert",
+      "status": "NOT_CONFIRMED",
+      "approach": "Read paragraphs, detect heading styles, emit markdown. Formatting detection via AppleScript not confirmed."
+    },
+    {
+      "name": "Document Monitor",
+      "description": "Watch a Pages document for modifications and trigger actions when saved",
+      "difficulty": "pro",
+      "status": "CONFIRMED_FEASIBLE",
+      "approach": "Poll 'modified of document' via AppleScript on interval; trigger action when true"
+    },
+    {
+      "name": "Reading Time Estimator",
+      "description": "Calculate estimated reading time for a Pages document (words / 200 wpm)",
+      "difficulty": "pro",
+      "status": "CONFIRMED_FEASIBLE",
+      "approach": "Count total words via paragraph iteration, divide by 200"
+    }
+  ],
+  "ui_structure": {
+    "main_window": {
+      "toolbar": {
+        "buttons": [
+          "Add Page",
+          "Text",
+          "Comment",
+          "Writing Tools",
+          "Share"
+        ],
+        "checkboxes": [
+          "Table",
+          "Chart",
+          "Shape"
+        ],
+        "menus": [
+          "View (zoom/layout)",
+          "Zoom %",
+          "Insert (media/objects)"
+        ]
+      },
+      "inspector_panel": {
+        "location": "right side",
+        "tabs": [
+          "Style",
+          "Layout"
+        ],
+        "selector_button": "AXButton[title='Body'] toggles inspector target"
+      },
+      "document_canvas": {
+        "role": "AXScrollArea",
+        "content": "Main page editing area"
+      },
+      "menu_bar": {
+        "menus": [
+          "Apple",
+          "Pages",
+          "File",
+          "Edit",
+          "Insert",
+          "Format",
+          "Arrange",
+          "View",
+          "Window",
+          "Help"
+        ],
+        "total_items": 671,
+        "shortcuts_captured": 123
+      }
+    }
+  },
+  "websiteFeatures": [
+    {
+      "id": "get_started_with_a_template",
+      "name": "Get started with a template",
+      "description": "All documents begin with a template\u2014a model you can use as a starting point. You can create word-processing documents, like reports and letters, and page layout documents, like posters and newsletters",
+      "sourceHeading": "Get started with a template",
+      "level": "grandmaster",
+      "status": "CONFIRMED",
+      "evidence": "Template chooser opens on Option+Cmd+N with categories: Basic, Reports, Books, Letters, Curricula Vitae, Flyers & Posters, Newsletters, Stationery, Certificates, Miscellaneous. Cancel and Create buttons visible. Tested 2026-03-23."
+    },
+    {
+      "id": "add_photos_shapes_tables_and_more",
+      "name": "Add photos, shapes, tables, and more",
+      "description": "Add objects like tables, charts, shapes, and media (images, audio, and video) to your document. You can layer objects, resize them, and place them anywhere on the page.",
+      "sourceHeading": "Add photos, shapes, tables, and more",
+      "level": "pro",
+      "status": "CONFIRMED",
+      "evidence": "Insert menu confirmed: Table (picker with Headers/Basic/Plain/Sums), Chart (picker with 2D/3D/Interactive types), Text Box, Shape, Image Gallery, Image Playground, Web Video, Record Audio. All menu items present and enabled."
+    },
+    {
+      "id": "customize_every_detail",
+      "name": "Customize every detail",
+      "description": "Change the look of your text, add a drop shadow to an image, fill shapes with color, and more\u2014you can modify everything in your document.",
+      "sourceHeading": "Customize every detail",
+      "level": "expert",
+      "status": "CONFIRMED",
+      "evidence": "Inspector panel has Style tab (font, size, bold/italic/underline/strikethrough, character styles, text color, alignment, spacing, bullets), Layout tab (columns, indents, tabs, paragraph borders, background), More tab (pagination, hyphenation, following paragraph style). Format menu has Font, Text, Table, Chart, Shapes and Lines, Image, Movie, Add Link, Conditional Highlighting."
+    },
+    {
+      "id": "become_a_publisher",
+      "name": "Become a publisher",
+      "description": "Pages comes with book templates that let you create interactive books in EPUB format. Add text and images\u2014and even a table of contents.",
+      "sourceHeading": "Become a publisher",
+      "level": "pro",
+      "status": "CONFIRMED",
+      "evidence": "Export To > EPUB confirmed via AppleScript (export to POSIX file as ePub). File > Publish to Apple Books menu item present and enabled. Insert > Table of Contents menu item present. Book templates exist in template chooser."
+    },
+    {
+      "id": "collaborate_in_real_time",
+      "name": "Collaborate in real time",
+      "description": "Invite others to work with you on your document. Everyone you invite can see changes as they're made, but you control who can edit or only view the document.",
+      "sourceHeading": "Collaborate in real time",
+      "level": "expert",
+      "status": "CONFIRMED",
+      "evidence": "File > Share... and Activity Settings... both present. Share button in toolbar. View menu has Show Participant Cursors and Show Activity Pane items. Note: triggering Share prompts Contacts permission dialog which caused crashes during testing."
+    },
+    {
+      "id": "everything_you_need_in_one_place",
+      "name": "Everything you need in one place",
+      "description": "Subscribe to Apple Creator Studio to access a rich library of premium content, plus AI-powered features like photorealistic image generation.",
+      "sourceHeading": "Everything you need in one place",
+      "level": "pro",
+      "status": "CONFIRMED",
+      "evidence": "Insert > Image Playground... present in Insert menu. Edit > Writing Tools submenu confirmed with: Proofread, Rewrite, Make Friendly, Make Professional, Make Concise, Summarize, Create Key Points, Make List, Make Table, Compose."
+    },
+    {
+      "id": "word_processing_or_page_layout",
+      "name": "Word-processing or page layout?",
+      "description": "Two document types: word-processing (flowing text) and page layout (fixed canvas). Choose at creation time.",
+      "sourceHeading": "Word-processing or page layout?",
+      "level": "beginner",
+      "status": "CONFIRMED",
+      "evidence": "File > Convert to Page Layout menu item present (disabled when already in word-processing mode, would be enabled on page layout doc). Template chooser shows both types. 'make new document' creates word-processing by default."
+    },
+    {
+      "id": "set_up_your_document",
+      "name": "Set up your document",
+      "description": "Choose a document type, adjust page size and margins, change how text looks, and more.",
+      "sourceHeading": "Set up your document",
+      "level": "pro",
+      "status": "CONFIRMED",
+      "evidence": "File > Page Setup... present. View > Inspector > Document Setup present. Document tab in inspector shows document settings (page size, orientation, margins, headers/footers). Password protection via File > Set Password... confirmed with dialog showing Password, Verify, Hint, Touch ID fields."
+    },
+    {
+      "id": "mark_up_your_document",
+      "name": "Mark up your document",
+      "description": "Turn handwriting into text with Apple Pencil, add annotations, and draw within a Pages document.",
+      "sourceHeading": "Mark up your document",
+      "level": "pro",
+      "status": "CONFIRMED",
+      "evidence": "Edit > Remove Smart Annotations present. View > Hide Smart Annotations present. Insert > Line with Draw With Pen shortcut (Option+Shift+Cmd+P). Highlight and Comment toolbar buttons confirmed visible."
+    },
+    {
+      "id": "navigate_your_document",
+      "name": "Navigate your document",
+      "description": "Use the table of contents view to quickly and easily navigate your Pages document.",
+      "sourceHeading": "Navigate your document",
+      "level": "pro",
+      "status": "CONFIRMED",
+      "evidence": "View > Table of Contents panel option present. View > Page Thumbnails panel option present. View > Document Only option present. Insert > Table of Contents menu item present for inserting a TOC. Keyboard shortcut Ctrl+Cmd+G for Go To Page."
+    },
+    {
+      "id": "publish_your_book",
+      "name": "Publish your book",
+      "description": "Find out everything you need to publish your book directly to the store in Apple Books.",
+      "sourceHeading": "Publish your book",
+      "level": "pro",
+      "status": "CONFIRMED",
+      "evidence": "File > Publish to Apple Books menu item present and enabled (requires proper ePub structure). Export To > EPUB confirmed working via AppleScript."
+    },
+    {
+      "id": "apple_creator_studio",
+      "name": "Apple Creator Studio",
+      "description": "One subscription gets you all the creativity and productivity apps you need to do your best work. Subscribe or manage your subscription on Mac, iPad, or iPhone.",
+      "sourceHeading": "Apple Creator Studio",
+      "level": "pro",
+      "status": "CONFIRMED",
+      "evidence": "Apple Intelligence Writing Tools in Edit menu (Proofread, Rewrite, summarize, etc.). Image Playground in Insert menu. These are the AI features available in Pages."
+    },
+    {
+      "id": "resources",
+      "name": "Resources",
+      "description": "Resources",
+      "sourceHeading": "Resources",
+      "level": "beginner",
+      "status": "NOT_SUPPORTED",
+      "evidence": "Web navigation section \u2014 not an automatable Pages feature."
+    },
+    {
+      "id": "user_guides",
+      "name": "User Guides",
+      "description": "Learn about features and discover all that Pages can do on your Mac, iPad, or iPhone.",
+      "sourceHeading": "User Guides",
+      "level": "pro",
+      "status": "NOT_SUPPORTED",
+      "evidence": "Help documentation link \u2014 Pages Help accessible via Help > Pages Help menu."
+    },
+    {
+      "id": "pages_for_icloud",
+      "name": "Pages for iCloud",
+      "description": "Create or edit documents on a web browser with Pages for iCloud.",
+      "sourceHeading": "Pages for iCloud",
+      "level": "beginner",
+      "status": "NOT_SUPPORTED",
+      "evidence": "iCloud web app \u2014 separate from the macOS Pages app. Not automatable via ScreenHand desktop tools."
+    },
+    {
+      "id": "search_for_more_topics",
+      "name": "Search for more topics",
+      "description": "Search for more topics",
+      "sourceHeading": "Search for more topics",
+      "level": "beginner",
+      "status": "NOT_SUPPORTED",
+      "evidence": "Web navigation element \u2014 not an automatable Pages feature."
+    },
+    {
+      "id": "apple_communities",
+      "name": "Apple Communities",
+      "description": "Find answers, ask questions, and connect with other Apple users.",
+      "sourceHeading": "Apple Communities",
+      "level": "beginner",
+      "status": "NOT_SUPPORTED",
+      "evidence": "External web resource \u2014 not an automatable Pages feature."
+    },
+    {
+      "id": "get_support",
+      "name": "Get Support",
+      "description": "We can help you find the best support options.",
+      "sourceHeading": "Get Support",
+      "level": "beginner",
+      "status": "NOT_SUPPORTED",
+      "evidence": "External web resource \u2014 not an automatable Pages feature."
+    },
+    {
+      "id": "support_app",
+      "name": "Support app",
+      "description": "Get personalized access to solutions for your Apple products.",
+      "sourceHeading": "Support app",
+      "level": "beginner",
+      "status": "NOT_SUPPORTED",
+      "evidence": "External app resource \u2014 not an automatable Pages feature."
+    },
+    {
+      "id": "apple_footer",
+      "name": "Apple Footer",
+      "description": "Apple Footer",
+      "sourceHeading": "Apple Footer",
+      "level": "beginner",
+      "status": "NOT_SUPPORTED",
+      "evidence": "Web page footer \u2014 not an automatable Pages feature."
+    },
+    {
+      "id": "product_support",
+      "name": "Product Support",
+      "description": "Product Support",
+      "sourceHeading": "Product Support",
+      "level": "beginner",
+      "status": "NOT_SUPPORTED",
+      "evidence": "Web navigation element \u2014 not an automatable Pages feature."
+    },
+    {
+      "id": "service_and_repair",
+      "name": "Service and Repair",
+      "description": "Service and Repair",
+      "sourceHeading": "Service and Repair",
+      "level": "beginner",
+      "status": "NOT_SUPPORTED",
+      "evidence": "Web navigation element \u2014 not an automatable Pages feature."
+    },
+    {
+      "id": "connect",
+      "name": "Connect",
+      "description": "Connect",
+      "sourceHeading": "Connect",
+      "level": "beginner",
+      "status": "NOT_SUPPORTED",
+      "evidence": "Web navigation element \u2014 not an automatable Pages feature."
+    }
+  ],
+  "valueAddFeatures": [
+    {
+      "id": "bulk_create",
+      "name": "Bulk Create",
+      "description": "Create multiple Pages documents from a list or template using AppleScript make new document",
+      "category": "bulk",
+      "level": "pro",
+      "status": "CONFIRMED",
+      "evidence": "AppleScript 'make new document' confirmed. Can loop to create N documents. Each created doc gets name 'Untitled', 'Untitled 2', etc."
+    },
+    {
+      "id": "batch_pdf_export",
+      "name": "Batch PDF Export",
+      "description": "Export all open (or all in folder) Pages docs as PDFs in one shot",
+      "category": "bulk",
+      "level": "pro",
+      "status": "CONFIRMED",
+      "evidence": "export to POSIX file as PDF confirmed working. PDF export from /tmp test confirmed 2026-03-23."
+    },
+    {
+      "id": "content_extractor",
+      "name": "Content Extractor",
+      "description": "Read full text from Pages documents without GUI interaction",
+      "category": "intelligence",
+      "level": "pro",
+      "status": "CONFIRMED",
+      "evidence": "paragraph N of body text returns text. 'get properties' of document returns full body text as string directly. Confirmed live."
+    },
+    {
+      "id": "word_count_reporter",
+      "name": "Word Count Reporter",
+      "description": "Report word/char counts for all open documents",
+      "category": "intelligence",
+      "level": "pro",
+      "status": "CONFIRMED",
+      "evidence": "Cmd+Shift+W shows word count in UI (showed 4, 7, 13, 15 words during testing). AppleScript: count of words of (paragraph N of body text as string). No direct word_count property."
+    },
+    {
+      "id": "summarize_all",
+      "name": "Summarize",
+      "description": "Read and summarize all Pages content via content extraction + LLM",
+      "category": "intelligence",
+      "level": "expert",
+      "status": "CONFIRMED",
+      "evidence": "Content extraction via get properties / paragraph iteration confirmed. LLM summarization is external. Full pipeline feasible."
+    },
+    {
+      "id": "change_monitor",
+      "name": "Change Monitor",
+      "description": "Monitor Pages documents for modifications (poll 'modified' property) and notify",
+      "category": "monitoring",
+      "level": "grandmaster",
+      "status": "CONFIRMED",
+      "evidence": "'modified of front document' returns boolean. Poll on interval to detect unsaved changes."
+    },
+    {
+      "id": "batch_docx_converter",
+      "name": "Batch DOCX Converter",
+      "description": "Convert multiple .pages files to .docx for cross-platform sharing",
+      "category": "bulk",
+      "level": "pro",
+      "status": "CONFIRMED",
+      "evidence": "export to POSIX file as Microsoft Word confirmed working."
+    },
+    {
+      "id": "smart_search",
+      "name": "Smart Search",
+      "description": "Search across all Pages content with pattern matching",
+      "category": "organization",
+      "level": "pro",
+      "status": "CONFIRMED",
+      "evidence": "Content extraction via AppleScript + string matching on paragraph text is confirmed feasible. Edit > Find > Find... (Cmd+F) opens Find & Replace toolbar. AppleScript can read all paragraphs and filter by pattern."
+    }
+  ],
+  "live_validation_results": {
+    "validated_date": "2026-03-23",
+    "tester": "ScreenHand MCP automated validation",
+    "environment": "macOS Sequoia 15.x, Pages 14.x",
+    "interference_note": "Reminders.app is a login item that repeatedly steals focus. This caused 3 Pages crashes when Contacts permission dialog appeared mid-test. All features involving collaboration (Share, Mail Merge live) were tested via menu inspection only.",
+    "features": {
+      "template_chooser": {
+        "status": "CONFIRMED",
+        "evidence": "Option+Cmd+N opens template chooser with categories: Basic, Reports, Books, Letters, Curricula Vitae, Flyers & Posters, Newsletters, Stationery, Certificates, Miscellaneous. Cancel and Create buttons present."
+      },
+      "word_count_ui": {
+        "status": "CONFIRMED",
+        "evidence": "Cmd+Shift+W toggles word count display at bottom of canvas. Showed 4, 7, 13, 15 words during testing. Menu item: View > Hide/Show Word Count."
+      },
+      "find_replace": {
+        "status": "CONFIRMED",
+        "evidence": "Cmd+F opens Find & Replace toolbar with search field and navigation controls. Edit > Find submenu has Find, Find Next, Find Previous, Use Selection for Find, Jump to Selection."
+      },
+      "comments": {
+        "status": "CONFIRMED",
+        "evidence": "Shift+Cmd+K inserts a comment bubble with the user's name (Khushi Goyal shown). Comment toolbar button visible. Insert > Comment also works."
+      },
+      "track_changes": {
+        "status": "CONFIRMED",
+        "evidence": "Edit > Track Changes toggles on/off. When on: toolbar shows '< > N Changes', Accept/Reject/Paused controls appear. 'Turn Off Tracking' appears in Edit menu when active. Keyboard: Ctrl+Cmd+T."
+      },
+      "ruler": {
+        "status": "CONFIRMED",
+        "evidence": "Cmd+R toggles ruler. Ruler visible with tick marks (10, 12, 14, 16, 18, 20). View > Show/Hide Ruler menu item present."
+      },
+      "export_epub": {
+        "status": "CONFIRMED",
+        "evidence": "AppleScript: export to POSIX file \"/tmp/SH_Pages_Test_export.epub\" as ePub succeeded with no dialog. File created."
+      },
+      "export_plain_text": {
+        "status": "CONFIRMED",
+        "evidence": "AppleScript: export to POSIX file \"/tmp/SH_Pages_Test_export.txt\" as unformatted text succeeded with no dialog. File created."
+      },
+      "export_pdf": {
+        "status": "CONFIRMED",
+        "evidence": "AppleScript: export to POSIX file \"/tmp/SH_Pages_Test_final.pdf\" as PDF succeeded. File created."
+      },
+      "export_word": {
+        "status": "CONFIRMED",
+        "evidence": "AppleScript: export to POSIX file as Microsoft Word confirmed in prior sessions."
+      },
+      "full_screen": {
+        "status": "CONFIRMED",
+        "evidence": "Ctrl+Cmd+F enters full screen mode \u2014 menu bar hidden, only Pages controls visible. Confirmed via screenshot."
+      },
+      "password_protection": {
+        "status": "CONFIRMED",
+        "evidence": "File > Set Password... opens dialog with: Password field, Verify field, Password Hint (recommended), Open with Touch ID toggle, Cancel and Set Password buttons. Confirmed via screenshot."
+      },
+      "spell_check": {
+        "status": "CONFIRMED",
+        "evidence": "Edit > Spelling and Grammar > Show Spelling and Grammar opens panel with Change/Ignore/Learn/Define/Guess buttons, language popup, Check grammar checkbox. Tested with misspelled text."
+      },
+      "insert_table": {
+        "status": "CONFIRMED",
+        "evidence": "Insert > Table opens table picker with styles: Headers, Basic, Plain, Sums. Table checkbox in toolbar works the same way."
+      },
+      "insert_chart": {
+        "status": "CONFIRMED",
+        "evidence": "Insert > Chart opens chart picker with 2D Column, 2D Stacked Column, 2D Bar, 2D Stacked Bar, 2D Line, 2D Area, 2D Stacked Area, 2D Radar, 2D Pie, 2D Donut, 2D Scatter, 2D Bubble, 2D Mixed, 2D 2-Axis, 3D variants, Interactive Column/Bar/Scatter/Bubble."
+      },
+      "insert_shape": {
+        "status": "CONFIRMED",
+        "evidence": "Insert > Shape present in menu. Shape checkbox in toolbar confirmed."
+      },
+      "insert_footnote": {
+        "status": "CONFIRMED",
+        "evidence": "Insert > Footnote menu item present and executed successfully (no error returned)."
+      },
+      "insert_bookmark": {
+        "status": "CONFIRMED",
+        "evidence": "Insert > Bookmark present in menu. Keyboard: Option+Cmd+B. Format > Add Link also for hyperlinks."
+      },
+      "insert_comment": {
+        "status": "CONFIRMED",
+        "evidence": "Insert > Comment present and functional. Shift+Cmd+K shortcut works."
+      },
+      "table_of_contents": {
+        "status": "CONFIRMED",
+        "evidence": "Insert > Table of Contents submenu present. View > Table of Contents panel toggle present."
+      },
+      "mail_merge": {
+        "status": "CONFIRMED",
+        "evidence": "File > Mail Merge... present (disabled without merge fields). Insert > Mail Merge Field submenu present. Full workflow UI-only \u2014 triggers Contacts permission when activated."
+      },
+      "publish_apple_books": {
+        "status": "CONFIRMED",
+        "evidence": "File > Publish to Apple Books present and enabled (enabled=true in AX tree). Requires proper ePub document structure."
+      },
+      "template_save": {
+        "status": "CONFIRMED",
+        "evidence": "File > Save as Template... present. 'Create a custom Pages template?' dialog appeared spontaneously with 'Add to Template Chooser' and 'Save...' options."
+      },
+      "writing_tools_ai": {
+        "status": "CONFIRMED",
+        "evidence": "Edit > Writing Tools submenu: Show Writing Tools, Proofread, Rewrite, Make Friendly, Make Professional, Make Concise, Summarize, Create Key Points, Make List, Make Table, Compose. Apple Intelligence integration confirmed."
+      },
+      "paragraph_styles_inspector": {
+        "status": "CONFIRMED",
+        "evidence": "Inspector panel confirmed with Style tab (font/size/formatting), Layout tab (columns/indents/tabs/borders/background), More tab (pagination/hyphenation). Radio buttons 1/2/3 in AX tree switch between tabs."
+      },
+      "page_layout_mode": {
+        "status": "CONFIRMED",
+        "evidence": "File > Convert to Page Layout present (disabled on word-processing doc, enabled on page layout docs). Template chooser offers layout templates."
+      },
+      "headers_footers": {
+        "status": "CONFIRMED",
+        "evidence": "Document tab in inspector (View > Inspector > Document Setup) controls headers/footers. Insert > Section menu for section-level header/footer control. AX tree shows AXRadioButton in inspector for Format/Document toggle."
+      },
+      "image_gallery": {
+        "status": "CONFIRMED",
+        "evidence": "Insert > Image Gallery present in menu."
+      },
+      "image_playground": {
+        "status": "CONFIRMED",
+        "evidence": "Insert > Image Playground... present in menu (Apple Intelligence image generation)."
+      },
+      "web_video": {
+        "status": "CONFIRMED",
+        "evidence": "Insert > Web Video... present in menu."
+      },
+      "record_audio": {
+        "status": "CONFIRMED",
+        "evidence": "Insert > Record Audio present in menu."
+      },
+      "equation": {
+        "status": "CONFIRMED",
+        "evidence": "Insert > Equation... present in menu (Option+Cmd+E)."
+      },
+      "collaboration_share": {
+        "status": "CONFIRMED",
+        "evidence": "File > Share... and Activity Settings... present. Share button in toolbar. View > Show Participant Cursors and Show Activity Pane. Note: triggers Contacts permission dialog."
+      },
+      "dark_mode": {
+        "status": "CONFIRMED",
+        "method": "System Events appearance preferences",
+        "evidence": "tell application \"System Events\" to tell appearance preferences to set dark mode to not dark mode \u2014 toggles instantly, confirmed live",
+        "note": "System-wide toggle, not Pages-specific. Pages respects it automatically."
+      },
+      "applescript_set_paragraph_style": {
+        "status": "CONFIRMED",
+        "method": "AX UI \u2014 click style button in Format panel",
+        "evidence": "click button \"Body\" of splitter group 1 of front window \u2192 style picker opens \u2192 click_text on desired style name. Confirmed live: changed Body \u2192 Heading (18pt Bold).",
+        "note": "Cannot set via AppleScript directly, but AX automation works reliably"
+      },
+      "applescript_insert_table": {
+        "status": "CONFIRMED",
+        "method": "System Events Insert > Table > [style] menu",
+        "evidence": "click menu item \"Table\" of menu 1 of menu bar item \"Insert\" \u2192 click \"Basic\"/\"Headers\"/\"Plain\"/\"Sums\". Confirmed live.",
+        "note": "make new table via AS fails (-2763), but menu automation works"
+      },
+      "export_rtf_applescript": {
+        "status": "CONFIRMED",
+        "method": "System Events File > Export To > Rich Text Format\u2026",
+        "evidence": "Menu click \u2192 click button \"Save\u2026\" of sheet \u2192 navigate to path \u2192 press Return. Confirmed: 19KB .rtf file created at /tmp/pages-rtf-test.rtf",
+        "note": "export as rich text via AS fails, but System Events menu automation works"
+      },
+      "import_word": {
+        "status": "CONFIRMED",
+        "evidence": "File > Open accepts .docx files (open POSIX file). Confirmed via File > Open menu and fact that open command works for any file Pages supports."
+      },
+      "sections": {
+        "status": "CONFIRMED",
+        "evidence": "Insert > Section present. AS: count of sections of document = 1 confirmed. body text of section N accessible."
+      },
+      "page_breaks": {
+        "status": "CONFIRMED",
+        "evidence": "Insert > Page Break (Cmd+Return), Line Break, Section Break, Column Break all present in Insert menu."
+      },
+      "page_number": {
+        "status": "CONFIRMED",
+        "evidence": "Insert > Page Number, Page Count, Date & Time all present in Insert menu."
+      },
+      "show_invisibles": {
+        "status": "CONFIRMED",
+        "evidence": "View > Show Invisibles (Shift+Cmd+I) present."
+      },
+      "show_layout": {
+        "status": "CONFIRMED",
+        "evidence": "View > Show Layout (Shift+Cmd+L) present."
+      },
+      "conditional_highlighting": {
+        "status": "CONFIRMED",
+        "evidence": "Format > Conditional Highlighting... present in menu."
+      },
+      "add_link": {
+        "status": "CONFIRMED",
+        "evidence": "Format > Add Link submenu present (Cmd+K). Format > Remove Link also present."
+      }
+    },
+    "confirmed": 45,
+    "not_supported": 0
+  },
+  "playbooks": {
+    "new-document": "playbooks/pages-mn2rveey.json",
+    "export-pdf": "playbooks/pages-mn2rvsy6.json",
+    "open-document": "playbooks/pages-mn2rw24s.json"
+  }
+}