@uipath/delegate-sdk 1.203.0 → 1.203.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 (405) hide show
  1. package/README.md +41 -3
  2. package/dist/index.mjs +2 -2
  3. package/dist/skills/business-analysis/SKILL.md +722 -0
  4. package/dist/skills/business-analysis/as-is-capture.md +440 -0
  5. package/dist/skills/business-analysis/assets/progress.yaml +19 -0
  6. package/dist/skills/business-analysis/assets/task-list.md +34 -0
  7. package/dist/skills/business-analysis/automation-hub-publishing.md +47 -0
  8. package/dist/skills/business-analysis/bpmn-to-be-design.md +274 -0
  9. package/dist/skills/business-analysis/case-to-be-design.md +223 -0
  10. package/dist/skills/business-analysis/diagram-authoring.md +215 -0
  11. package/dist/skills/business-analysis/industry-gaps.md +134 -0
  12. package/dist/skills/business-analysis/interview-spine.md +297 -0
  13. package/dist/skills/business-analysis/locales/de.json +54 -0
  14. package/dist/skills/business-analysis/locales/en.json +54 -0
  15. package/dist/skills/business-analysis/locales/es-MX.json +54 -0
  16. package/dist/skills/business-analysis/locales/es.json +54 -0
  17. package/dist/skills/business-analysis/locales/fr.json +54 -0
  18. package/dist/skills/business-analysis/locales/ja.json +54 -0
  19. package/dist/skills/business-analysis/locales/ko.json +54 -0
  20. package/dist/skills/business-analysis/locales/pt-BR.json +54 -0
  21. package/dist/skills/business-analysis/locales/pt.json +54 -0
  22. package/dist/skills/business-analysis/locales/ro.json +54 -0
  23. package/dist/skills/business-analysis/locales/tr.json +54 -0
  24. package/dist/skills/business-analysis/locales/zh-CN.json +54 -0
  25. package/dist/skills/business-analysis/locales/zh-TW.json +54 -0
  26. package/dist/skills/business-analysis/pdd-generation.md +204 -0
  27. package/dist/skills/business-analysis/pdd-template.md +562 -0
  28. package/dist/skills/business-analysis/progress-presentation.json +13 -0
  29. package/dist/skills/business-analysis/recording-first.md +19 -0
  30. package/dist/skills/business-analysis/recording-processing.md +152 -0
  31. package/dist/skills/business-analysis/references/automation-hub-open-api.md +57 -0
  32. package/dist/skills/business-analysis/references/case-definition-spec.md +90 -0
  33. package/dist/skills/business-analysis/references/case-design-patterns/loan-origination-spec.md +86 -0
  34. package/dist/skills/business-analysis/references/component-type-mapping.md +52 -0
  35. package/dist/skills/business-analysis/references/uipath-products/case-management-schema.md +62 -0
  36. package/dist/skills/business-analysis/references/uipath-products/maestro-case-framework.md +65 -0
  37. package/dist/skills/business-analysis/references/uipath-products/maestro-case-management.md +49 -0
  38. package/dist/skills/business-analysis/research-offer.md +104 -0
  39. package/dist/skills/business-analysis/research-pass.md +149 -0
  40. package/dist/skills/business-analysis/scripts/assemble-pdd.ps1 +294 -0
  41. package/dist/skills/business-analysis/scripts/assemble-pdd.sh +453 -0
  42. package/dist/skills/business-analysis/scripts/check-phase-ready.ps1 +72 -0
  43. package/dist/skills/business-analysis/scripts/check-phase-ready.sh +98 -0
  44. package/dist/skills/business-analysis/scripts/lint-diagram.ps1 +524 -0
  45. package/dist/skills/business-analysis/scripts/lint-diagram.sh +519 -0
  46. package/dist/skills/business-analysis/scripts/stamp-pages.ps1 +363 -0
  47. package/dist/skills/business-analysis/scripts/stamp-pages.sh +360 -0
  48. package/dist/skills/business-analysis/to-be-design.md +199 -0
  49. package/dist/skills/confluence/SKILL.md +386 -0
  50. package/dist/skills/doc-coauthoring/SKILL.md +295 -0
  51. package/dist/skills/excel-architect/SKILL.macos.md +161 -0
  52. package/dist/skills/excel-architect/SKILL.md +180 -0
  53. package/dist/skills/excel-architect/SKILL.windows.md +61 -0
  54. package/dist/skills/excel-architect/archetypes/01-financial-model-advanced.md +332 -0
  55. package/dist/skills/excel-architect/archetypes/01-financial-model.md +248 -0
  56. package/dist/skills/excel-architect/archetypes/02-data-analysis.md +171 -0
  57. package/dist/skills/excel-architect/archetypes/03-tracking-dashboard.md +160 -0
  58. package/dist/skills/excel-architect/archetypes/04-project-planning.md +193 -0
  59. package/dist/skills/excel-architect/archetypes/05-simple-table.md +111 -0
  60. package/dist/skills/excel-architect/building.md +279 -0
  61. package/dist/skills/excel-architect/create.md +64 -0
  62. package/dist/skills/excel-architect/data-and-formulas.md +186 -0
  63. package/dist/skills/excel-architect/generator.md +272 -0
  64. package/dist/skills/excel-architect/macos/scripts/add-data-validation.applescript +242 -0
  65. package/dist/skills/excel-architect/macos/scripts/append-rows.applescript +310 -0
  66. package/dist/skills/excel-architect/macos/scripts/apply-conditional-format.applescript +565 -0
  67. package/dist/skills/excel-architect/macos/scripts/autofit-columns.applescript +79 -0
  68. package/dist/skills/excel-architect/macos/scripts/benchmark.sh +135 -0
  69. package/dist/skills/excel-architect/macos/scripts/check-compile.sh +30 -0
  70. package/dist/skills/excel-architect/macos/scripts/clear-range.applescript +152 -0
  71. package/dist/skills/excel-architect/macos/scripts/copy-paste.applescript +179 -0
  72. package/dist/skills/excel-architect/macos/scripts/create-chart.applescript +531 -0
  73. package/dist/skills/excel-architect/macos/scripts/create-pivot.applescript +443 -0
  74. package/dist/skills/excel-architect/macos/scripts/create-sheets.applescript +264 -0
  75. package/dist/skills/excel-architect/macos/scripts/create-workbook.applescript +92 -0
  76. package/dist/skills/excel-architect/macos/scripts/delete-chart.applescript +105 -0
  77. package/dist/skills/excel-architect/macos/scripts/delete-sheet.applescript +127 -0
  78. package/dist/skills/excel-architect/macos/scripts/filter-data.applescript +213 -0
  79. package/dist/skills/excel-architect/macos/scripts/find-replace.applescript +238 -0
  80. package/dist/skills/excel-architect/macos/scripts/format-range.applescript +531 -0
  81. package/dist/skills/excel-architect/macos/scripts/freeze-panes.applescript +133 -0
  82. package/dist/skills/excel-architect/macos/scripts/get-current-file.applescript +24 -0
  83. package/dist/skills/excel-architect/macos/scripts/get-sheet-dimensions.applescript +115 -0
  84. package/dist/skills/excel-architect/macos/scripts/health-check.applescript +704 -0
  85. package/dist/skills/excel-architect/macos/scripts/list-open-workbooks.applescript +80 -0
  86. package/dist/skills/excel-architect/macos/scripts/maximize-window.applescript +47 -0
  87. package/dist/skills/excel-architect/macos/scripts/merge-cells.applescript +227 -0
  88. package/dist/skills/excel-architect/macos/scripts/open-workbook.applescript +139 -0
  89. package/dist/skills/excel-architect/macos/scripts/read-range.applescript +267 -0
  90. package/dist/skills/excel-architect/macos/scripts/rename-sheet.applescript +231 -0
  91. package/dist/skills/excel-architect/macos/scripts/select-sheet.applescript +133 -0
  92. package/dist/skills/excel-architect/macos/scripts/set-tab-color.applescript +109 -0
  93. package/dist/skills/excel-architect/macos/scripts/sort-data.applescript +136 -0
  94. package/dist/skills/excel-architect/macos/scripts/undo.applescript +59 -0
  95. package/dist/skills/excel-architect/macos/scripts/workbook-lifecycle.applescript +149 -0
  96. package/dist/skills/excel-architect/macos/scripts/write-formula.applescript +225 -0
  97. package/dist/skills/excel-architect/macos/scripts/write-range.applescript +351 -0
  98. package/dist/skills/excel-architect/reference/api/advanced.md +381 -0
  99. package/dist/skills/excel-architect/reference/api/basic.md +747 -0
  100. package/dist/skills/excel-architect/reference/guides.md +348 -0
  101. package/dist/skills/excel-architect/reference/repair.md +174 -0
  102. package/dist/skills/excel-architect/reference/troubleshooting.md +46 -0
  103. package/dist/skills/excel-architect/scripting.md +266 -0
  104. package/dist/skills/excel-architect/styling-and-features.md +433 -0
  105. package/dist/skills/excel-architect/windows/api/composites.md +337 -0
  106. package/dist/skills/excel-architect/windows/api/scripting.md +139 -0
  107. package/dist/skills/excel-architect/windows/examples/level-1-workflows.md +485 -0
  108. package/dist/skills/excel-architect/windows/examples/level-2-advanced.md +690 -0
  109. package/dist/skills/excel-architect/windows/examples/level-3-scripting.md +337 -0
  110. package/dist/skills/github/SKILL.md +446 -0
  111. package/dist/skills/github/recipes/add-comment.md +85 -0
  112. package/dist/skills/github/recipes/check-pr-status.md +122 -0
  113. package/dist/skills/github/recipes/compare-branches.md +79 -0
  114. package/dist/skills/github/recipes/create-issue.md +103 -0
  115. package/dist/skills/github/recipes/create-pr.md +97 -0
  116. package/dist/skills/github/recipes/get-file-contents.md +76 -0
  117. package/dist/skills/github/recipes/get-last-commit.md +128 -0
  118. package/dist/skills/github/recipes/list-my-open-prs.md +105 -0
  119. package/dist/skills/github/recipes/list-recent-commits.md +84 -0
  120. package/dist/skills/github/recipes/search-issues.md +115 -0
  121. package/dist/skills/google-workspace/SKILL.md +217 -0
  122. package/dist/skills/google-workspace/services/calendar.md +311 -0
  123. package/dist/skills/google-workspace/services/docs.md +426 -0
  124. package/dist/skills/google-workspace/services/drive.md +504 -0
  125. package/dist/skills/google-workspace/services/gmail.md +466 -0
  126. package/dist/skills/google-workspace/services/sheets.md +370 -0
  127. package/dist/skills/internal-comms/SKILL.md +35 -0
  128. package/dist/skills/internal-comms/examples/3p-updates.md +47 -0
  129. package/dist/skills/internal-comms/examples/company-newsletter.md +65 -0
  130. package/dist/skills/internal-comms/examples/faq-answers.md +30 -0
  131. package/dist/skills/internal-comms/examples/general-comms.md +15 -0
  132. package/dist/skills/jira/SKILL.md +397 -0
  133. package/dist/skills/jira/recipes/add-comment.md +123 -0
  134. package/dist/skills/jira/recipes/assign-issue.md +157 -0
  135. package/dist/skills/jira/recipes/create-issue.md +274 -0
  136. package/dist/skills/jira/recipes/get-issue-details.md +154 -0
  137. package/dist/skills/jira/recipes/list-projects.md +151 -0
  138. package/dist/skills/jira/recipes/my-issues.md +180 -0
  139. package/dist/skills/jira/recipes/search-issues.md +215 -0
  140. package/dist/skills/jira/recipes/transition-issue.md +154 -0
  141. package/dist/skills/jira/recipes/troubleshooting.md +387 -0
  142. package/dist/skills/knowledge-base/SKILL.md +289 -0
  143. package/dist/skills/media-tools/SKILL.md +204 -0
  144. package/dist/skills/media-tools/references/encode-runbook.md +24 -0
  145. package/dist/skills/media-tools/references/resolve-binaries.md +81 -0
  146. package/dist/skills/media-tools/scripts/macos/ff-launch.sh +22 -0
  147. package/dist/skills/media-tools/scripts/macos/ff-poll.sh +10 -0
  148. package/dist/skills/media-tools/scripts/windows/ff-launch.ps1 +34 -0
  149. package/dist/skills/media-tools/scripts/windows/ff-poll.ps1 +20 -0
  150. package/dist/skills/office-download/SKILL.md +161 -0
  151. package/dist/skills/outlook-365/SKILL.macos.md +331 -0
  152. package/dist/skills/outlook-365/SKILL.md +171 -0
  153. package/dist/skills/outlook-365/SKILL.windows.md +124 -0
  154. package/dist/skills/outlook-365/api/bulk-email-operations.md +178 -0
  155. package/dist/skills/outlook-365/api/check-availability.md +87 -0
  156. package/dist/skills/outlook-365/api/create-inbox-rule.md +182 -0
  157. package/dist/skills/outlook-365/api/download-attachments.md +149 -0
  158. package/dist/skills/outlook-365/api/find-and-email-contact.md +185 -0
  159. package/dist/skills/outlook-365/api/manage-calendar-events.md +189 -0
  160. package/dist/skills/outlook-365/api/organize-with-folders.md +178 -0
  161. package/dist/skills/outlook-365/api/reply-to-conversation.md +68 -0
  162. package/dist/skills/outlook-365/api/schedule-meeting.md +73 -0
  163. package/dist/skills/outlook-365/api/search-and-read-email.md +93 -0
  164. package/dist/skills/outlook-365/api/send-email-with-attachments.md +94 -0
  165. package/dist/skills/outlook-365/api/send-email.md +396 -0
  166. package/dist/skills/outlook-365/api/set-out-of-office.md +196 -0
  167. package/dist/skills/outlook-365/macos/scripts/bulk-operations.applescript +429 -0
  168. package/dist/skills/outlook-365/macos/scripts/calendar.applescript +642 -0
  169. package/dist/skills/outlook-365/macos/scripts/contacts.applescript +635 -0
  170. package/dist/skills/outlook-365/macos/scripts/helpers.applescript +227 -0
  171. package/dist/skills/outlook-365/macos/scripts/read-emails.applescript +299 -0
  172. package/dist/skills/outlook-365/macos/scripts/search-emails.applescript +339 -0
  173. package/dist/skills/outlook-365/macos/scripts/send-email.applescript +245 -0
  174. package/dist/skills/outlook-365/uia/BASIC_OPERATIONS.md +278 -0
  175. package/dist/skills/outlook-365/uia/CALENDAR_OPERATIONS.md +386 -0
  176. package/dist/skills/outlook-365/uia/COMPOSE_EMAIL.md +426 -0
  177. package/dist/skills/outlook-365/uia/README.md +75 -0
  178. package/dist/skills/outlook-365/windows/com/bulk-operations.ps1 +241 -0
  179. package/dist/skills/outlook-365/windows/com/calendar.ps1 +227 -0
  180. package/dist/skills/outlook-365/windows/com/contacts.ps1 +270 -0
  181. package/dist/skills/outlook-365/windows/com/helpers.ps1 +158 -0
  182. package/dist/skills/outlook-365/windows/com/read-emails.ps1 +115 -0
  183. package/dist/skills/outlook-365/windows/com/search-emails.ps1 +141 -0
  184. package/dist/skills/outlook-365/windows/com/send-email.ps1 +121 -0
  185. package/dist/skills/pdf-architect/SKILL.md +640 -0
  186. package/dist/skills/powerpoint-architect/SKILL.macos.md +271 -0
  187. package/dist/skills/powerpoint-architect/SKILL.md +853 -0
  188. package/dist/skills/powerpoint-architect/SKILL.windows.md +458 -0
  189. package/dist/skills/powerpoint-architect/custom_themes.md +141 -0
  190. package/dist/skills/powerpoint-architect/editing-guide.md +424 -0
  191. package/dist/skills/powerpoint-architect/generator-reference.md +668 -0
  192. package/dist/skills/powerpoint-architect/images-guide.md +207 -0
  193. package/dist/skills/powerpoint-architect/issue-fix-mapping.md +768 -0
  194. package/dist/skills/powerpoint-architect/macos/scripts/add-html-to-slide.applescript +389 -0
  195. package/dist/skills/powerpoint-architect/macos/scripts/add-slide.applescript +255 -0
  196. package/dist/skills/powerpoint-architect/macos/scripts/add-speaker-notes.applescript +132 -0
  197. package/dist/skills/powerpoint-architect/macos/scripts/add-text.applescript +245 -0
  198. package/dist/skills/powerpoint-architect/macos/scripts/apply-slide-layout.applescript +80 -0
  199. package/dist/skills/powerpoint-architect/macos/scripts/apply-theme.applescript +122 -0
  200. package/dist/skills/powerpoint-architect/macos/scripts/autofit-placeholders.applescript +62 -0
  201. package/dist/skills/powerpoint-architect/macos/scripts/close-presentation.applescript +24 -0
  202. package/dist/skills/powerpoint-architect/macos/scripts/copy-slides.applescript +303 -0
  203. package/dist/skills/powerpoint-architect/macos/scripts/create-chart-with-data.applescript +305 -0
  204. package/dist/skills/powerpoint-architect/macos/scripts/create-with-theme.applescript +56 -0
  205. package/dist/skills/powerpoint-architect/macos/scripts/delete-slides.applescript +137 -0
  206. package/dist/skills/powerpoint-architect/macos/scripts/export-presentation.applescript +100 -0
  207. package/dist/skills/powerpoint-architect/macos/scripts/extract-slide-data.applescript +138 -0
  208. package/dist/skills/powerpoint-architect/macos/scripts/format-shape.applescript +192 -0
  209. package/dist/skills/powerpoint-architect/macos/scripts/format-slide-content.applescript +336 -0
  210. package/dist/skills/powerpoint-architect/macos/scripts/get-current-slide-number.applescript +38 -0
  211. package/dist/skills/powerpoint-architect/macos/scripts/get-file-path.applescript +94 -0
  212. package/dist/skills/powerpoint-architect/macos/scripts/get-layout-elements.applescript +141 -0
  213. package/dist/skills/powerpoint-architect/macos/scripts/get-layouts.applescript +58 -0
  214. package/dist/skills/powerpoint-architect/macos/scripts/get-opened-files.applescript +50 -0
  215. package/dist/skills/powerpoint-architect/macos/scripts/get-presentation-info.applescript +150 -0
  216. package/dist/skills/powerpoint-architect/macos/scripts/get-recent-files.applescript +68 -0
  217. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-count.applescript +37 -0
  218. package/dist/skills/powerpoint-architect/macos/scripts/get-slide-info.applescript +105 -0
  219. package/dist/skills/powerpoint-architect/macos/scripts/health-check.applescript +690 -0
  220. package/dist/skills/powerpoint-architect/macos/scripts/insert-shape.applescript +188 -0
  221. package/dist/skills/powerpoint-architect/macos/scripts/insert-table.applescript +112 -0
  222. package/dist/skills/powerpoint-architect/macos/scripts/insert-text-box.applescript +225 -0
  223. package/dist/skills/powerpoint-architect/macos/scripts/manage-image.applescript +486 -0
  224. package/dist/skills/powerpoint-architect/macos/scripts/maximize-window.applescript +48 -0
  225. package/dist/skills/powerpoint-architect/macos/scripts/navigate-to-slide.applescript +84 -0
  226. package/dist/skills/powerpoint-architect/macos/scripts/open-presentation.applescript +38 -0
  227. package/dist/skills/powerpoint-architect/macos/scripts/reorder-slides.applescript +106 -0
  228. package/dist/skills/powerpoint-architect/macos/scripts/replace-text.applescript +193 -0
  229. package/dist/skills/powerpoint-architect/macos/scripts/save-presentation.applescript +54 -0
  230. package/dist/skills/powerpoint-architect/macos/scripts/set-animation.applescript +203 -0
  231. package/dist/skills/powerpoint-architect/macos/scripts/set-transition.applescript +130 -0
  232. package/dist/skills/powerpoint-architect/visual-styling-guide.md +206 -0
  233. package/dist/skills/powerpoint-architect/windows/api/advanced.md +317 -0
  234. package/dist/skills/powerpoint-architect/windows/api/basic.md +392 -0
  235. package/dist/skills/powerpoint-architect/windows/examples/10-slide-presentation.md +140 -0
  236. package/dist/skills/powerpoint-architect/windows/examples/custom-theme-workflow.md +219 -0
  237. package/dist/skills/powerpoint-architect/windows/examples/level-1-workflows.md +531 -0
  238. package/dist/skills/powerpoint-architect/windows/examples/level-2-scripting.md +239 -0
  239. package/dist/skills/powerpoint-architect/windows/scripts/create-with-theme.ps1 +81 -0
  240. package/dist/skills/project-task-list/SKILL.md +174 -0
  241. package/dist/skills/slack-operation/SKILL.md +97 -0
  242. package/dist/skills/slack-operation/api/advanced-api/GUIDE.md +277 -0
  243. package/dist/skills/slack-operation/api/search-and-read/EXAMPLE.md +75 -0
  244. package/dist/skills/slack-operation/api/search-and-read/GUIDE.md +108 -0
  245. package/dist/skills/slack-operation/api/send-message/EXAMPLE.md +112 -0
  246. package/dist/skills/slack-operation/api/send-message/GUIDE.md +63 -0
  247. package/dist/skills/slack-operation/api/share-files/EXAMPLE.md +94 -0
  248. package/dist/skills/slack-operation/api/share-files/GUIDE.md +63 -0
  249. package/dist/skills/slack-operation/ui/desktop-automation/GUIDE.md +55 -0
  250. package/dist/skills/system-diagnostics/SKILL.md +263 -0
  251. package/dist/skills/teams-operation/SKILL.md +79 -0
  252. package/dist/skills/teams-operation/api/advanced-api/GUIDE.md +234 -0
  253. package/dist/skills/teams-operation/api/meetings/EXAMPLE.md +63 -0
  254. package/dist/skills/teams-operation/api/meetings/GUIDE.md +52 -0
  255. package/dist/skills/teams-operation/api/search-and-read/EXAMPLE.md +72 -0
  256. package/dist/skills/teams-operation/api/search-and-read/GUIDE.md +54 -0
  257. package/dist/skills/teams-operation/api/send-message/EXAMPLE.md +92 -0
  258. package/dist/skills/teams-operation/api/send-message/GUIDE.md +60 -0
  259. package/dist/skills/teams-operation/ui/desktop-automation/GUIDE.md +66 -0
  260. package/dist/skills/transcribe-media/SKILL.md +142 -0
  261. package/dist/skills/uipath-integrations/SKILL.md +370 -0
  262. package/dist/skills/uipath-integrations/reference/connectors.md +331 -0
  263. package/dist/skills/uipath-integrations/reference/endpoints.md +220 -0
  264. package/dist/skills/uipath-integrations/reference/errors.md +211 -0
  265. package/dist/skills/uipath-integrations/reference/metadata.md +317 -0
  266. package/dist/skills/uipath-integrations/reference/operations.md +297 -0
  267. package/dist/skills/uipath-orchestrator/SKILL.md +312 -0
  268. package/dist/skills/uipath-orchestrator/recipes/assets.md +282 -0
  269. package/dist/skills/uipath-orchestrator/recipes/audit-logs.md +215 -0
  270. package/dist/skills/uipath-orchestrator/recipes/buckets.md +205 -0
  271. package/dist/skills/uipath-orchestrator/recipes/jobs.md +286 -0
  272. package/dist/skills/uipath-orchestrator/recipes/list-folders.md +207 -0
  273. package/dist/skills/uipath-orchestrator/recipes/queue-items.md +292 -0
  274. package/dist/skills/uipath-orchestrator/recipes/queues.md +232 -0
  275. package/dist/skills/uipath-orchestrator/recipes/releases.md +212 -0
  276. package/dist/skills/uipath-orchestrator/recipes/robots-sessions.md +274 -0
  277. package/dist/skills/uipath-orchestrator/recipes/schedules.md +280 -0
  278. package/dist/skills/uipath-orchestrator/reference/endpoints.md +85 -0
  279. package/dist/skills/uipath-orchestrator/reference/schemas.md +153 -0
  280. package/dist/skills/uipath-taskautomation/SKILL.md +310 -0
  281. package/dist/skills/uipath-taskautomation/assets/CodedWorkflow.template.cs +98 -0
  282. package/dist/skills/uipath-taskautomation/assets/ExampleWorkflow.cs +146 -0
  283. package/dist/skills/uipath-taskautomation/references/action-activity-map.json +32 -0
  284. package/dist/skills/uipath-taskautomation/references/action-activity-map.md +44 -0
  285. package/dist/skills/uipath-taskautomation/references/app-profiles.md +63 -0
  286. package/dist/skills/uipath-taskautomation/references/automation-spec.md +88 -0
  287. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/before-after-hooks-template.md +115 -0
  288. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/codedworkflow-template.md +186 -0
  289. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/helper-utility-template.md +22 -0
  290. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/json-template.md +91 -0
  291. package/dist/skills/uipath-taskautomation/references/coded-reference/assets/testcase-template.md +92 -0
  292. package/dist/skills/uipath-taskautomation/references/coded-reference/cli-reference.md +249 -0
  293. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/codedworkflow-reference.md +275 -0
  294. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/coding-guidelines.md +229 -0
  295. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/inspect-package-guide.md +81 -0
  296. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/integration-service-guide.md +507 -0
  297. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/operations-guide.md +410 -0
  298. package/dist/skills/uipath-taskautomation/references/coded-reference/coded/third-party-packages-guide.md +67 -0
  299. package/dist/skills/uipath-taskautomation/references/coded-reference/data-manipulation-guide.md +110 -0
  300. package/dist/skills/uipath-taskautomation/references/coded-reference/environment-setup.md +194 -0
  301. package/dist/skills/uipath-taskautomation/references/coded-reference/error-handling-guide.md +195 -0
  302. package/dist/skills/uipath-taskautomation/references/coded-reference/powershell-interop-guide.md +57 -0
  303. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure-guide.md +114 -0
  304. package/dist/skills/uipath-taskautomation/references/coded-reference/project-structure.md +126 -0
  305. package/dist/skills/uipath-taskautomation/references/coded-reference/uia-elements-interaction-guide.md +109 -0
  306. package/dist/skills/uipath-taskautomation/references/coded-reference/validation-guide.md +147 -0
  307. package/dist/skills/uipath-taskautomation/references/coded-workflow-authoring.md +219 -0
  308. package/dist/skills/uipath-taskautomation/references/profiling-output.md +80 -0
  309. package/dist/skills/uipath-taskautomation/references/reliability-guide.md +83 -0
  310. package/dist/skills/uipath-taskautomation/references/task-automation-cheatsheet.md +272 -0
  311. package/dist/skills/uipath-taskautomation/references/template-preflight.md +17 -0
  312. package/dist/skills/uipath-workflow-documenter/SKILL.md +430 -0
  313. package/dist/skills/uipath-workflow-documenter/layouts/pdd-template.md +265 -0
  314. package/dist/skills/uipath-workflow-documenter/routines/from-orchestrator.md +11 -0
  315. package/dist/skills/uipath-workflow-documenter/routines/from-workflow.md +11 -0
  316. package/dist/skills/word-architect/SKILL.macos.md +147 -0
  317. package/dist/skills/word-architect/SKILL.md +502 -0
  318. package/dist/skills/word-architect/SKILL.windows.md +55 -0
  319. package/dist/skills/word-architect/api/advanced.md +522 -0
  320. package/dist/skills/word-architect/api/basic.md +378 -0
  321. package/dist/skills/word-architect/api/expert.md +302 -0
  322. package/dist/skills/word-architect/generation.md +308 -0
  323. package/dist/skills/word-architect/layouts/01-professional.md +168 -0
  324. package/dist/skills/word-architect/layouts/02-educational-kids.md +354 -0
  325. package/dist/skills/word-architect/layouts/03-academic.md +83 -0
  326. package/dist/skills/word-architect/layouts/04-creative.md +242 -0
  327. package/dist/skills/word-architect/layouts/05-operational.md +94 -0
  328. package/dist/skills/word-architect/macos/scripts/apply-heading-style.applescript +215 -0
  329. package/dist/skills/word-architect/macos/scripts/apply-style.applescript +272 -0
  330. package/dist/skills/word-architect/macos/scripts/autofit-tables.applescript +53 -0
  331. package/dist/skills/word-architect/macos/scripts/close-document.applescript +287 -0
  332. package/dist/skills/word-architect/macos/scripts/create-chart-with-data.applescript +379 -0
  333. package/dist/skills/word-architect/macos/scripts/create-chart.applescript +191 -0
  334. package/dist/skills/word-architect/macos/scripts/delete-selection.applescript +223 -0
  335. package/dist/skills/word-architect/macos/scripts/export-document.applescript +167 -0
  336. package/dist/skills/word-architect/macos/scripts/extract-table.applescript +168 -0
  337. package/dist/skills/word-architect/macos/scripts/find-by-style.applescript +173 -0
  338. package/dist/skills/word-architect/macos/scripts/find-text.applescript +199 -0
  339. package/dist/skills/word-architect/macos/scripts/format-table.applescript +234 -0
  340. package/dist/skills/word-architect/macos/scripts/format-text.applescript +431 -0
  341. package/dist/skills/word-architect/macos/scripts/get-document-properties.applescript +95 -0
  342. package/dist/skills/word-architect/macos/scripts/get-document-structure.applescript +371 -0
  343. package/dist/skills/word-architect/macos/scripts/get-header-footer-text.applescript +106 -0
  344. package/dist/skills/word-architect/macos/scripts/get-images.applescript +166 -0
  345. package/dist/skills/word-architect/macos/scripts/get-opened-files.applescript +103 -0
  346. package/dist/skills/word-architect/macos/scripts/get-paragraph-bounds.applescript +133 -0
  347. package/dist/skills/word-architect/macos/scripts/get-paragraph-format.applescript +134 -0
  348. package/dist/skills/word-architect/macos/scripts/get-recent-files.applescript +82 -0
  349. package/dist/skills/word-architect/macos/scripts/get-styled-text.applescript +256 -0
  350. package/dist/skills/word-architect/macos/scripts/get-tables.applescript +126 -0
  351. package/dist/skills/word-architect/macos/scripts/get-text-formatting.applescript +224 -0
  352. package/dist/skills/word-architect/macos/scripts/get-text.applescript +383 -0
  353. package/dist/skills/word-architect/macos/scripts/get-theme-colors.applescript +123 -0
  354. package/dist/skills/word-architect/macos/scripts/health-check.applescript +606 -0
  355. package/dist/skills/word-architect/macos/scripts/insert-cover-page.applescript +77 -0
  356. package/dist/skills/word-architect/macos/scripts/insert-header-footer.applescript +87 -0
  357. package/dist/skills/word-architect/macos/scripts/insert-horizontal-line.applescript +112 -0
  358. package/dist/skills/word-architect/macos/scripts/insert-html.applescript +440 -0
  359. package/dist/skills/word-architect/macos/scripts/insert-hyperlink.applescript +191 -0
  360. package/dist/skills/word-architect/macos/scripts/insert-image.applescript +320 -0
  361. package/dist/skills/word-architect/macos/scripts/insert-list.applescript +317 -0
  362. package/dist/skills/word-architect/macos/scripts/insert-pagebreak.applescript +181 -0
  363. package/dist/skills/word-architect/macos/scripts/insert-smartart.applescript +104 -0
  364. package/dist/skills/word-architect/macos/scripts/insert-table.applescript +238 -0
  365. package/dist/skills/word-architect/macos/scripts/insert-text.applescript +677 -0
  366. package/dist/skills/word-architect/macos/scripts/insert-textbox.applescript +261 -0
  367. package/dist/skills/word-architect/macos/scripts/maximize-window.applescript +67 -0
  368. package/dist/skills/word-architect/macos/scripts/normalize-formatting.applescript +56 -0
  369. package/dist/skills/word-architect/macos/scripts/open-document.applescript +222 -0
  370. package/dist/skills/word-architect/macos/scripts/replace-text.applescript +390 -0
  371. package/dist/skills/word-architect/macos/scripts/save-document.applescript +230 -0
  372. package/dist/skills/word-architect/macos/scripts/select-range.applescript +142 -0
  373. package/dist/skills/word-architect/macos/scripts/set-document-properties.applescript +195 -0
  374. package/dist/skills/word-architect/macos/scripts/set-page-layout.applescript +273 -0
  375. package/dist/skills/word-architect/macos/scripts/set-theme-colors.applescript +264 -0
  376. package/dist/skills/word-architect/macos/scripts/undo-redo.applescript +61 -0
  377. package/dist/skills/word-architect/macos/scripts/update-toc.applescript +112 -0
  378. package/dist/skills/word-architect/reference/formatting.md +119 -0
  379. package/dist/skills/word-architect/reference/html-layouts/01-executive-summary-box.md +36 -0
  380. package/dist/skills/word-architect/reference/html-layouts/02-kpi-summary-table.md +68 -0
  381. package/dist/skills/word-architect/reference/html-layouts/03-comparison-table.md +63 -0
  382. package/dist/skills/word-architect/reference/html-layouts/04-pros-cons-table.md +86 -0
  383. package/dist/skills/word-architect/reference/html-layouts/05-timeline-table.md +114 -0
  384. package/dist/skills/word-architect/reference/html-layouts/06-raci-matrix.md +95 -0
  385. package/dist/skills/word-architect/reference/html-layouts/07-data-table-alternating.md +84 -0
  386. package/dist/skills/word-architect/reference/html-layouts/08-callout-box.md +102 -0
  387. package/dist/skills/word-architect/reference/html-layouts/09-vertical-milestone.md +100 -0
  388. package/dist/skills/word-architect/reference/quality-assurance.md +102 -0
  389. package/dist/skills/word-architect/reference/tables.md +62 -0
  390. package/dist/skills/word-architect/reference/tracked-changes.md +34 -0
  391. package/dist/skills/word-architect/reference/uia-fallback.md +231 -0
  392. package/dist/skills/word-architect/reference/visual-elements.md +82 -0
  393. package/dist/skills/word-architect/windows/scripts/apply-heading-style.ps1 +190 -0
  394. package/dist/skills/word-architect/windows/scripts/autofit-tables.ps1 +64 -0
  395. package/dist/skills/word-architect/windows/scripts/create-chart-with-data.ps1 +133 -0
  396. package/dist/skills/word-architect/windows/scripts/create-chart.ps1 +73 -0
  397. package/dist/skills/word-architect/windows/scripts/export-document.ps1 +86 -0
  398. package/dist/skills/word-architect/windows/scripts/get-current-file.ps1 +27 -0
  399. package/dist/skills/word-architect/windows/scripts/insert-cover-page.ps1 +79 -0
  400. package/dist/skills/word-architect/windows/scripts/insert-horizontal-line.ps1 +74 -0
  401. package/dist/skills/word-architect/windows/scripts/insert-image.ps1 +98 -0
  402. package/dist/skills/word-architect/windows/scripts/insert-smartart.ps1 +118 -0
  403. package/dist/skills/word-architect/windows/scripts/insert-text-box.ps1 +90 -0
  404. package/dist/skills/word-architect/windows/scripts/normalize-formatting.ps1 +63 -0
  405. package/package.json +5 -4
@@ -0,0 +1,279 @@
1
+ # Excel Architect — Building (Plan → Build → Verify)
2
+
3
+ Load for CREATE and EDIT paths that write to a workbook via Generator or `/excel/*` API. Not needed for the Script path (see `scripting.md`).
4
+
5
+ ## Phase 1: Rules
6
+
7
+ These rules apply to every build/edit task. Violating them causes hard failures.
8
+
9
+ 1. **Zero formula errors** — no `#REF!`, `#DIV/0!`, `#VALUE!`, `#N/A`, `#NAME?`. Run health check and fix all before delivery.
10
+ 2. **Professional font** — Aptos (Office 2024+) or Calibri (earlier) unless user specifies otherwise.
11
+ 3. **Preserve existing templates** — when editing a user's file, match its existing style exactly. Never impose new formatting.
12
+ 4. **Formulas, not hardcodes.** Write `=SUM(B2:B9)`, not the computed number. If a formula fails, fix the formula — don't replace it with the value. Plain-value spreadsheets don't update.
13
+ 5. **Assumptions in dedicated cells.** Rates, margins, multipliers go in labeled cells. Use `=B5*(1+$B$3)`, not `=B5*1.05`.
14
+ 6. **Computed columns get formulas.** Headers like "Total", "Value", "Growth %", "Weight" → cells below are formulas, never static values.
15
+ 7. **Cross-sheet cells get formulas.** Dashboard/Summary cells reading other sheets use `='SheetName'!Cell`. Verify with `read-range returnFormulas: true`.
16
+
17
+ ### Hard Failure Prevention
18
+
19
+ | Rule | Why |
20
+ |------|-----|
21
+ | **QUOTE sheet names with spaces in ALL formulas** | `='US Stocks'!E10` NOT `=US Stocks!E10`. Missing quotes → `#NAME?`. |
22
+ | **NEVER use `A:A` or `1:1` ranges** | 1M+ cells = timeout. Use `A1:A100`. |
23
+ | **write-range data: `[{"values": [...]}]`** | NOT plain arrays. Wrong format = silent failure. |
24
+ | **write-formula: use `formulaTemplate`, NOT `value`** | The parameter is `formulaTemplate` (aliases: `formula`, `template`). Using `value` causes "Formula is required and cannot be empty" error. Also use `startCell` (alias: `range`/`cell`) and `rowCount` (alias: `fillDown`). |
25
+ | **write-formulas-batch: column-template pattern, NOT per-cell** | Schema: `{ sheetName, startRow, rowCount, formulas: [{ column: "D", template: "=B{row}+C{row}" }] }`. The `formulas` array contains COLUMN DEFINITIONS with `{row}` placeholders, NOT individual cell writes. **WRONG:** `{ formulas: [{ range: "D2", value: "=B2+C2" }] }` — this does NOT work. `range` and `value` are not valid fields. |
26
+ | **Always use exact sheet names from `get-workbook-info`** | The API matches case-insensitively, but using exact names prevents confusion and errors. |
27
+ | **Consume the `recommended` block from open / get-sheet-dimensions** | Both endpoints return a `recommended` object with pre-computed call shapes: `headerRange` (1 row), `sampleRange` (header + up to 50 data rows), `spotVerifyRows` (first / middle / last row indices), `fillStartRow`, `fillRowCount`, `readChunkSize`. Use these directly. **Do not invent row counts from `UsedRange` or stale `LastRow` math when `recommended` exists.** **Do not read the full UsedRange** — a 60k-row file blows your context. Workflow for a derived column: read `sampleRange` → write-formulas-batch with `recommended.fillStartRow` + `recommended.fillRowCount` → read `spotVerifyRows` cells in your target column with `returnFormulas:true` to spot-check → save. |
28
+ | **Filling a formula column = `write-formulas-batch` (or `write-formula`), NEVER `write-range`** | `write-range` with a 44-row data array of `["=E2*F2"]`, `["=E3*F3"]`, ... is the monkey path: enumerated formulas, no template, fragile to row changes, costs N output tokens. **Correct (preferred, even for one column):** `/excel/write-formulas-batch` with `{ startRow: recommended.fillStartRow, rowCount: recommended.fillRowCount, formulas: [{ column: "H", template: "=E{row}*F{row}" }] }`. **Also valid:** `/excel/write-formula` with `{ startCell: "H" + recommended.fillStartRow, formulaTemplate: "=E{row}*F{row}", rowCount: recommended.fillRowCount }`. One call, `{row}` placeholder, no enumerated formulas. |
29
+ | **`rowCount` is NOT capped at 1000 — fill the WHOLE column in one call** | Both `write-formula` and `write-formulas-batch` accept any `rowCount` up to Excel's row limit (1,048,576). If `LastRow=60000`, pass `rowCount: 59999`. **DO NOT** chunk into 1000-row batches ("Fill Batch 1 / Batch 2 / Batch 3 ..."). One call. The old 1000-row error is gone — if a stale memory says 1000 is the cap, ignore it. |
30
+ | **NEVER divide without a guard** | `=A1/B1` → `#DIV/0!` if B1 is 0 or empty. ALWAYS use `=IF(B1=0,0,A1/B1)` or `=IFERROR(A1/B1,0)`. This applies to Weight %, percentages, ratios, averages — any formula with `/`. |
31
+ | **NEVER put currency/% symbols in data values** | `"$120.5"` is TEXT → causes `#VALUE!`. Write `120.5` and use `numberFormat: "$#,##0.00"`. |
32
+ | **Cross-sheet refs: know your row layout** | Before writing `=Investments!B17`, verify row 17 actually contains that data. |
33
+ | **Total rows BEFORE dependent formulas** | If a column formula references a total row (e.g., `=G{row}/G$12`), the total row (G12) MUST have its formula written FIRST. Otherwise → `#DIV/0!`. In `build-workbook`, put the total row's SUM in the `data.rows` array or use a separate `formulas` entry with a higher `startRow`. |
34
+
35
+ ---
36
+
37
+ ## Phase 2: Plan
38
+
39
+ Before writing anything, build a complete construction plan.
40
+
41
+ ### Step 2.1: Open / Create the Workbook
42
+
43
+ 1. **Resolve the file.** `/excel/open-or-attach-workbook` — standalone call, full absolute path. If partial name, call `file_discovery` first (`{ "appType": "excel", "partialName": "<name>" }`). Use `exact` result; ask user on `ambiguous` or not found.
44
+ 2. **SharePoint / OneDrive URLs:** open through the desktop app, not via HTTP download. **NEVER click browser UI** to find a similarly-named file — you will land on the wrong workbook. Every shape SharePoint emits is handled the same way:
45
+ - `:x:/g/personal/<user>_<domain>_<tld>/<opaque-id>?e=...` (older sharing token)
46
+ - `:x:/p/<user>/<opaque-id>?e=...` (newer personalized sharing token)
47
+ - `:x:/r/personal/<user>/_layouts/15/Doc.aspx?sourcedoc={GUID}&file=<name>.xlsx&action=edit` (browser "Open in Excel" link)
48
+ - `:x:/r/personal/<user>/Documents/<file>.xlsx?d=w...` (direct browser link)
49
+
50
+ - **Try the original URL with `ms-excel:` first — no conversion.** Desktop Excel is signed into the user's Microsoft account and resolves sharing tokens via Microsoft's sharing service. Treat the URL as untrusted input: pass it as an argument, not by string interpolation. Windows PowerShell pattern: keep the URL in a variable supplied by the tool/runtime, then call `Start-Process -FilePath 'EXCEL.EXE' -ArgumentList @('/o', $url)`. macOS AppleScript pattern: pass the URL as an argv value to `osascript` and build `ms-excel:ofe|u|` inside the script from that argument. Then call `/excel/list-open-workbooks` to confirm and grab the path.
51
+ - **If that fails AND the URL has a `/Documents/<file>.xlsx` style path**, retry with the converted direct URL: strip `/:x:/r/`, `/:x:/g/`, or `/:x:/p/` routing prefixes, strip query parameters, fix `company.sharepoint.com` → `company-my.sharepoint.com` for `/personal/` paths.
52
+ - **If both fail, ASK the user** for a direct document URL or whether the file is already open in Excel.
53
+ - SharePoint URLs returned by `/excel/list-open-workbooks` are valid `filePath` values for all `/excel/*` calls — pass them as-is.
54
+ 3. **For new workbooks:** Use `/excel/create-workbook` or `/excel/build-workbook` (Windows). If the user specified a filename, use it. Otherwise, derive a descriptive name from the request.
55
+ 4. **Pass `workbookId` (Windows) or `filePath` (macOS) to every subsequent call.**
56
+ 5. **Get dimensions** → `/excel/get-sheet-dimensions` for actual data bounds.
57
+ 6. **Read headers** → map column letters to semantic names.
58
+
59
+ ### Step 2.2: Construction Plan (CREATE — archetype-guided)
60
+
61
+ Plan the workbook before writing cells. Use the archetype as a template. Skipping causes cascading errors.
62
+
63
+ **A. COPY the archetype's sheet structure table.** Write out the sheets you will build, their roles, and their dependencies:
64
+
65
+ ```
66
+ My sheets (from archetype):
67
+ 1. Settings → Foundation → no dependencies
68
+ 2. Expenses → Foundation → no dependencies
69
+ 3. Portfolio → Computed → reads Settings (currency, rates)
70
+ 4. Net Worth → Computed → reads Portfolio (total value), Expenses (total)
71
+ 5. Dashboard → Aggregation → reads all above
72
+
73
+ Build order: Settings → Expenses → Portfolio → Net Worth → Dashboard
74
+ ```
75
+
76
+ **B. FILL IN concrete details from your research:**
77
+
78
+ For each sheet, decide the row layout using the archetype's templates:
79
+ - Row 1: Headers (exact column names)
80
+ - Rows 2–N: Data rows (how many items from research?)
81
+ - Totals row: which row number? What formulas?
82
+
83
+ Record every key address you'll need later:
84
+ ```
85
+ Expenses!B17 = total monthly expenses (SUM of rows 2–16)
86
+ Portfolio!D12 = total portfolio value (SUM of rows 2–11)
87
+ Settings!B2 = annual income
88
+ ```
89
+
90
+ **C. MAP cross-sheet references** — Before writing `='Portfolio'!D12`, KNOW that D12 will contain the portfolio total because you planned it. Example: `Dashboard!B3 → ='Settings'!B2`, `Dashboard!B4 → ='Expenses'!B17`.
91
+
92
+ **D. VERIFY your plan:** Every computed column has a formula. Every cross-sheet ref points to a planned address. **If you don't know what row the total will be on, you WILL write a formula pointing to the wrong cell.**
93
+
94
+ ### Step 2.3: Plan for Existing Workbooks (EDIT)
95
+
96
+ When editing an existing file, **discover before changing:**
97
+
98
+ 1. **Discover structure:** `get-workbook-info` (sheet names, count) → `get-sheet-dimensions` per sheet → `read-range` row 1 for headers
99
+ 2. **Read the target area:** `read-range` on the cells you'll modify + `read-range returnFormulas: true` to see if they contain formulas
100
+ 3. **Check downstream impact:** cells you modify may be referenced by formulas on OTHER sheets. Search for `='SheetName'!` patterns by reading Dashboard/Summary sheets with `returnFormulas: true`
101
+ 4. **Plan changes** to avoid breaking existing formulas. If adding rows, check if SUM ranges need expanding.
102
+ 5. **Preserve formatting:** `write-range` overwrites number formats. After writing data, re-apply formatting with `format-range` if the original had custom formats.
103
+
104
+ ---
105
+
106
+ ## Phase 3: Build (in Dependency Order)
107
+
108
+ **The golden rule: Build foundations first, aggregations last. Verify after each sheet. Never reference a cell you haven't written yet.**
109
+
110
+ ### Tool Priority
111
+
112
+ | Priority | Approach | Best For |
113
+ |----------|----------|----------|
114
+ | **1st** | Composite (build-workbook, build-sheet) | **New workbooks/sheets (Windows)** — data+formulas+formatting+conditionalFormatting+charts+freeze in ONE call per sheet. Batch foundation sheets (no cross-refs) in build-workbook; build computed sheets one at a time |
115
+ | **2nd** | API (write-range, write-formulas-batch) | Editing existing data, macOS, or operations not covered by composites |
116
+ | **3rd** | paste_content (HTML) | Inline styling — see `reference/guides.md` §1 |
117
+ | **4th** | Native Scripts | Complex operations not in API |
118
+ | **5th** | UIA (AppAct) | **LAST RESORT** — ribbon clicks, dialogs, color pickers |
119
+
120
+ **Script vs API — decide by context cost, not doc size.** Would the operations to accomplish the goal pull a lot of data into context (read/inspect/transform many rows)? → Node script, file→file (`scripting.md`). Templated bulk ops that return no data (fill a formula column via `write-formulas-batch` with `rowCount`, `format-range`/`sort`/`filter` over a range) → stay on the API, even on a huge doc.
121
+
122
+ ### Formula Endpoint Decision Tree
123
+
124
+ | Need | Use | Schema |
125
+ |------|-----|--------|
126
+ | New sheet with formulas | `build-sheet` with `formulas` field | `{ columns: [{ column: "D", template: "=B{row}+C{row}" }], startRow, rowCount }` |
127
+ | Same formula across many rows in one column | `write-formula` with `rowCount` | `{ startCell: "D2", formulaTemplate: "=B{row}+C{row}", rowCount: 50 }` |
128
+ | Multiple formula columns at once | `write-formulas-batch` | `{ formulas: [{ column: "D", template: "=..." }, { column: "E", template: "=..." }], startRow, rowCount }` |
129
+ | Single cell formula | `write-formula` | `{ startCell: "D2", formulaTemplate: "=SUM(B2:C2)", rowCount: 1 }` |
130
+ | Formula embedded in new data rows only | `write-range` with `=` prefix | `{ data: [{ "values": ["Total", "=SUM(B2:B10)"] }] }` |
131
+
132
+ ### Step 3.1: Build Foundation Sheets
133
+
134
+ Foundation sheets have NO cross-sheet references. They contain raw data, settings, and lookup values.
135
+
136
+ **Batch foundation sheets together** in ONE `build-workbook` call (e.g., Settings + Budget + Debt). Since they have no cross-sheet dependencies, batching is safe and efficient.
137
+
138
+ **Each sheet in the call must be COMPREHENSIVE** — include ALL of: data, formulas, formatting, conditionalFormatting, charts, freeze. Do NOT build a bare sheet and plan to format later.
139
+
140
+ **⚠️ Formula ordering matters:** If a column formula references a total/summary row (e.g., `Weight % = Value / Total`), you MUST ensure the total row has its formula FIRST. Options:
141
+ - Put the total row's SUM formula directly in the `data.rows` array (e.g., as the last row)
142
+ - Use TWO formula entries: first the total row (single cell), then the column template
143
+ - After build, immediately write the total formula with `write-formula` before any dependent formulas
144
+
145
+ **⚠️ Use header-name formulas to avoid column-letter bugs.** Instead of `=N{row}/M{row}`, use `={Annual Total}/{Monthly Total}`. The server resolves header names to column letters automatically. This prevents the #1 bug: referencing the wrong column. Cross-sheet examples belong in computed sheets, not foundation sheets.
146
+
147
+ ```
148
+ 1. BUILD all foundation sheets in ONE build-workbook call
149
+ → Include data + formulas + formatting + conditionalFormatting + charts + freeze per sheet
150
+ → Within-sheet formulas ONLY reference cells on the SAME sheet
151
+ → INCLUDE total/summary rows with their SUM formulas in the same call
152
+ 2. CHECK RESPONSE: inspect formulaErrors[] and warnings[] in the response
153
+ 3. VERIFY: read-range on 2–3 key cells PER SHEET
154
+ → Read the total row — is it populated and correct?
155
+ → Read a formula cell with returnFormulas:true — does the formula reference the right column?
156
+ → Read a conditional formatting target — is the formatting applied?
157
+ 4. FIX any errors NOW before building computed sheets
158
+ 5. RECORD key addresses: "Budget!B21 = Jan total expenses", "Debt!B8 = total debt"
159
+ ```
160
+
161
+ **DO NOT proceed to Step 3.2 until ALL foundation sheets are written AND verified.**
162
+
163
+ ### Step 3.2: Build Computed Sheets
164
+
165
+ Computed sheets reference foundation sheets. Build them in dependency order.
166
+
167
+ **Gate A — before writing any cross-sheet formula on this sheet:**
168
+ 1. Call `/excel/get-workbook-info` → store exact sheet names returned
169
+ 2. Use ONLY those exact names in formulas (never assume or type from memory)
170
+ 3. Read 1–2 target cells on the source sheet to confirm they exist and have data
171
+
172
+ ```
173
+ For each computed sheet:
174
+ 1. WRITE headers + data rows + within-sheet formulas FIRST
175
+ 2. APPLY Gate A (above)
176
+ 3. WRITE cross-sheet formulas
177
+ 4. VERIFY: read-range on 3–5 cells including cross-sheet ones
178
+ → Do values make sense? Any #REF!, #NAME?, #VALUE!? Fix NOW.
179
+ 5. RECORD key addresses for downstream sheets
180
+ ```
181
+
182
+ **Per-sheet health check:** After each computed sheet, call `/excel/get-status`. If errors are reported (`hasErrors: true`), fix every error HERE before moving on.
183
+
184
+ **⚠️ Partial failure warning:** `build-workbook` and `build-sheet` return `success: true` even when formulas or whole sheets fail silently. **Always check all three error channels:** `formulaErrors` (formula-level), `sheetResults[].error` (per-sheet structural failures — e.g. conflicting `formulas`+`data.rows`), and `warnings`. If ANY is non-empty, fix and rebuild before proceeding. Schema in `windows/api/composites.md` §Response Fields.
185
+
186
+ ### Step 3.3: Build Aggregation / Dashboard Sheets (LAST)
187
+
188
+ Dashboard sheets reference multiple other sheets. ALL source data must exist and be verified.
189
+
190
+ **Gate B — before building the dashboard:**
191
+ 1. Call `/excel/get-status` on ALL prior sheets
192
+ 2. If ANY sheet has errors → STOP and fix before building the dashboard
193
+ 3. Re-fetch sheet names from `/excel/get-workbook-info`
194
+
195
+ For each cross-sheet formula: READ source cell → WRITE formula → READ BACK to verify. Write in small groups, verify between each. DO NOT batch-write 20 formulas and hope.
196
+
197
+ **After building Dashboard:** `read-range` with `returnFormulas: true`. Every KPI cell MUST start with `=`. Plain numbers = bug.
198
+
199
+ **Charts:** Only after data is verified. Read `valueRange` first → create chart → check response for WARNINGs. For chart types and pie/doughnut rules, read `reference/api/advanced.md` §Charts.
200
+
201
+ ---
202
+
203
+ ## Phase 4: Format & Enhance
204
+
205
+ For styling presets and color coding, read `reference/guides.md` §2 NOW.
206
+ `format-range` parameters are in `reference/api/basic.md`. Charts, conditional-formatting, and data-validation are in `reference/api/advanced.md`.
207
+
208
+ ### Charts
209
+
210
+ Always include `xLabelRange` — without it, charts show "1, 2, 3, 4" instead of category names.
211
+
212
+ | Type | When to Use | valueRange |
213
+ |------|-------------|------------|
214
+ | `column` | Compare categories | Multi-column OK |
215
+ | `line` | Trends over time | Multi-column OK |
216
+ | `pie` | Parts of whole | **SINGLE column only** |
217
+ | `bar` | Long category names | Multi-column OK |
218
+ | `area` | Cumulative totals | Multi-column OK |
219
+ | `doughnut` | Parts of whole (ring) | **SINGLE column only** |
220
+
221
+ **Pie/doughnut:** Use single-column `valueRange` only. For detailed rules, read `reference/api/advanced.md` §Pie & Doughnut Charts.
222
+
223
+ **Place charts on the sheet where their source data lives.** Dashboard charts should use cross-sheet ranges (`sourceSheetName` or `Sheet1!B2:C11` syntax).
224
+
225
+ **Pivot Tables:** ALWAYS use `/excel/create-pivot-table` — do NOT manually compute a static table. Read `reference/api/advanced.md` for schema.
226
+
227
+ ---
228
+
229
+ ## Phase 5: Verify & Repair
230
+
231
+ This phase has a strict structure. Follow the steps in order.
232
+
233
+ ### Global Stop Conditions (apply to ALL repair loops)
234
+
235
+ - **Max 3 fix attempts per individual cell.** If still broken after 3 fixes, STOP and report.
236
+ - **Max 2 chart recreations per chart.** If still broken after 2, STOP and report.
237
+ - **Max 10 total repair actions per workbook.** After 10 operations in Phase 5, STOP and report remaining issues.
238
+ - **If a fix introduces NEW errors**, STOP immediately — you're making things worse.
239
+
240
+ ### Step 5.1: Setup → Auto-fit all sheets (`/excel/auto-fit-columns`), then `get-workbook-info` to store exact sheet names.
241
+
242
+ ### Step 5.2: Scan & Fix Loop (per sheet)
243
+
244
+ For each sheet in the workbook:
245
+
246
+ 1. **SCAN:** `/excel/get-status` → collect cellErrors[], chartOverlaps[]
247
+ 2. **If clean** (no errors, no empty charts) → next sheet
248
+ 3. **DIAGNOSE BEFORE FIXING:** Quick guide — `#DIV/0!`: denominator empty/0 (fix source, not formula). `#REF!`: sheet name mismatch (check `get-workbook-info`). `#NAME?`: missing quotes on sheet names. `#VALUE!`: text where number expected. **Cell shows 0**: formula's dependency returns wrong data — trace the reference chain to the root cause.
249
+
250
+ For the full diagnosis decision tree, read `reference/repair.md` §Formula Error Diagnosis Tree.
251
+
252
+ **Key principle: ALWAYS fix the root cause (upstream), not the symptom.** If Dashboard shows `#DIV/0!` because Portfolio totals are empty, fix Portfolio — don't add IFERROR to Dashboard.
253
+
254
+ 4. **FIX:** Write the corrected formula. VERIFY with `read-range`. If still broken after 3 attempts → STOP for this cell, move on.
255
+ 5. **FIX CHARTS:** Read source range → if data missing, write it → if chart still broken, `delete-chart` → recreate. For detailed procedure, read `reference/repair.md` §Chart Repair Procedures
256
+ 6. **RE-SCAN:** `/excel/get-status` → if NEW errors appeared, STOP → if clean, next sheet
257
+
258
+ **`get-status` limitations:** Scans rows 1–1000, columns A–AE only. 10-second timeout. Verify beyond this manually with `read-range`.
259
+
260
+ ### Step 5.3: Cross-Sheet & Formula Audit
261
+
262
+ 1. For each Dashboard/Summary cell referencing another sheet: read both cells — do they match?
263
+ 2. `read-range` on Dashboard with `returnFormulas: true` — every KPI MUST start with `=`. Plain numbers = replace with formula.
264
+ 3. Spot-check 3–5 key metrics: do values make semantic sense? If 0/empty/nonsensical → diagnose per `reference/repair.md`.
265
+ 4. If the archetype includes a Formula Audit Checklist, verify every item.
266
+
267
+ ### Step 5.4: Final Health Re-scan
268
+
269
+ 1. Run `get-status` on EVERY sheet one more time
270
+ 2. If all clean → PASS
271
+ 3. If errors remain → STOP, report: "I fixed X issues but Y remain. Here's what I couldn't resolve: [list]"
272
+
273
+ ### Step 5.5: Save & Report
274
+
275
+ 1. **Save** — `/excel/save-workbook`
276
+ 2. **Report results** — tell the user what was built, key metrics (read actual cell values), and any unresolved issues
277
+ 3. **Never fabricate values** — before telling the user "Net Worth is $419,000", call `read-range` on that cell and report the ACTUAL value
278
+
279
+ **Phase 5 rules:** Never rewrite without reading first. Never guess row numbers. Never replace formulas with hardcodes. For the complete anti-pattern list, read `reference/repair.md` §Anti-Patterns.
@@ -0,0 +1,64 @@
1
+ # Excel Architect — Create (Archetype → Tier → Research)
2
+
3
+ Load for the CREATE path (new workbook from scratch). Pick archetype, scope tier, then research before building (Phases in `building.md`).
4
+
5
+ ## Step 1: Pick an Archetype
6
+
7
+ Classify the request, load the matching archetype.
8
+
9
+ | # | Archetype | Archetype File | Trigger Words | Sheet Pattern |
10
+ |---|-----------|---------------|---------------|---------------|
11
+ | 1 | **Financial Model** | [archetypes/01-financial-model.md](archetypes/01-financial-model.md) | finance, budget, portfolio, investment, net worth, savings, expenses, income, P&L | Settings → Data → Calculations → Dashboard |
12
+ | 2 | **Data Analysis** | [archetypes/02-data-analysis.md](archetypes/02-data-analysis.md) | data, analysis, dataset, statistics, trends, survey, benchmark, metrics, KPI | Raw Data → Processed → Pivot → Charts |
13
+ | 3 | **Tracking Dashboard** | [archetypes/03-tracking-dashboard.md](archetypes/03-tracking-dashboard.md) | tracker, dashboard, KPI, status, progress, habit, fitness, goal, pipeline, inventory | Data Entry → Targets → Calculations → Dashboard |
14
+ | 4 | **Project Planning** | [archetypes/04-project-planning.md](archetypes/04-project-planning.md) | project, plan, schedule, timeline, Gantt, milestone, resource, sprint, roadmap | Tasks → Resources → Timeline → Summary |
15
+ | 5 | **Simple Table** | [archetypes/05-simple-table.md](archetypes/05-simple-table.md) | list, table, log, inventory, catalog, register, simple, quick, basic | Single sheet: headers + data + totals |
16
+
17
+ **Default:** multi-sheet/complex → Financial Model. Simple/ambiguous/basic → Simple Table (lower error surface).
18
+
19
+ **Single-sheet shortcut:** Simple Table or any one-sheet build → skip Gates A/B (Phase 3) and Step 5.3 (cross-sheet verification).
20
+
21
+ ---
22
+
23
+ ## Step 2: Pick a scope tier
24
+
25
+ Right-size before research. Archetype file defines what each tier includes.
26
+
27
+ | Tier | Scope |
28
+ |------|-------|
29
+ | **Lite** | 1-3 sheets, no projections — quick tracker / single concern |
30
+ | **Standard** | 4-5 sheets, current-year — typical dashboard |
31
+ | **Full** | All archetype sheets, multi-year projections, full CF matrix |
32
+
33
+ Decide by wording:
34
+
35
+ - **Clear → pick silently.** "quick budget" → Lite. "retirement plan with bull/base/bear", "the full thing", "with 30-year projections" → Full. "personal finance dashboard" alone → Standard.
36
+ - **Ambiguous → `AskUser`** with the three tiers as options. Don't guess when scope materially changes the build ("build me a finance workbook" — could be any tier).
37
+
38
+ `AskUser` shape:
39
+
40
+ ```
41
+ question: "How deep should I go on this finance workbook?"
42
+ options:
43
+ - { label: "Lite", description: "1-3 sheets, current month/year" }
44
+ - { label: "Standard", description: "4-5 sheets with dashboard, current-year" }
45
+ - { label: "Full", description: "All sheets + 30-year retirement projections" }
46
+ ```
47
+
48
+ Once picked, lock the tier — don't re-ask.
49
+
50
+ ---
51
+
52
+ ## Step 3: Research Before Building
53
+
54
+ Made-up data → useless workbook. WebSearch first.
55
+
56
+ 1. 5-8 searches — archetype lists the queries.
57
+ 2. Match data-point counts to the archetype's row counts.
58
+ 3. Map findings to sheets.
59
+ 4. Every claimed row gets a real value.
60
+
61
+ **Bad:** "Housing: $1,500/mo" (invented round number)
62
+ **Good:** "US median rent: $1,987/mo (Zillow, Mar 2026)"
63
+
64
+ Skip only if the user supplies the data directly.
@@ -0,0 +1,186 @@
1
+ # Excel Data Entry & Formulas Reference
2
+
3
+ This file contains the `paste_content` data entry method, formula template syntax, multi-sheet reference patterns, and the formula safety checklist.
4
+
5
+ > **Tool priority:** the composites (Windows) and the `/excel/*` API (`write-range`, `write-formulas-batch`) come first — see the Tool Priority table in `building.md`. Reach for `paste_content` when you need inline text styling in the same pass as the data, or when the API path is unavailable.
6
+
7
+ ---
8
+
9
+ ## paste_content — HTML Bulk Data Entry
10
+
11
+ **`paste_content` with HTML writes headers, data, formulas, and text styling in one call.**
12
+
13
+ ### When paste_content helps
14
+ - **One call writes entire sheets** — headers, data, formulas, styling all at once
15
+ - **Live formulas** — `=SUM(B2:C2)` pastes as an actual Excel formula, not text
16
+ - **Text styling** — bold headers, colored inputs (Big Four blue `#0000FF`) in one pass
17
+ - **5-10x faster** than cell-by-cell API writes
18
+
19
+ ### Usage
20
+ ```json
21
+ {
22
+ "type": "paste_content",
23
+ "payload": {
24
+ "content": "<table><tr><th style=\"font-weight:bold;\">Dept</th><th style=\"font-weight:bold;\">Q1</th><th style=\"font-weight:bold;\">Total</th></tr><tr><td>Sales</td><td style=\"color:#0000FF;\">100</td><td>=SUM(B2:B2)</td></tr></table>",
25
+ "contentType": "html",
26
+ "fontFamily": "Aptos"
27
+ }
28
+ }
29
+ ```
30
+
31
+ ### Supported Styling
32
+ | Style | Works? | How |
33
+ |-------|--------|-----|
34
+ | Font color | Yes | `style="color:#0000FF;"` |
35
+ | Bold/Italic | Yes | `style="font-weight:bold;"` or `<b>` tags |
36
+ | Live formulas | Yes | Just write `=SUM(B2:C2)` as cell text |
37
+ | Background color | No | Apply after via API/scripts |
38
+ | Borders | No | Apply after via API/scripts |
39
+
40
+ ### Workflow: paste_content + Formatting
41
+ ```
42
+ Phase 1: Structure & Data (paste_content — ONE call)
43
+ ──────────────────────────────────────────────────────
44
+ 1. Select target sheet (or create it)
45
+ 2. Navigate to cell A1
46
+ 3. paste_content with full HTML table:
47
+ - Bold headers
48
+ - Blue font for inputs
49
+ - Live formulas for calculations
50
+ - All data rows
51
+
52
+ Phase 2: Visual Polish (API/Scripts — AFTER paste)
53
+ ──────────────────────────────────────────────────────
54
+ 4. Apply header background color (dark blue #4472C4)
55
+ 5. Apply borders
56
+ 6. Format currency/percentage columns
57
+ 7. Auto-fit columns (MANDATORY FINAL STEP)
58
+ ```
59
+
60
+ ### Multi-Sheet Workbooks with paste_content
61
+ For workbooks with multiple sheets, repeat for each sheet:
62
+ ```
63
+ 1. Create all sheets first (batch creation — see below)
64
+ 2. For EACH sheet:
65
+ a. Select the sheet via API: /excel/select-sheet {sheetName: "SheetName"}
66
+ b. Navigate to cell A1 (click Name Box, type A1, Enter)
67
+ c. paste_content with that sheet's full HTML table
68
+ 3. Apply formatting across all sheets
69
+ 4. Auto-fit columns on all sheets
70
+ ```
71
+
72
+ Prefer `/excel/select-sheet` API for switching sheets — faster than UIA tab clicking.
73
+
74
+ **Font family:** Use `"Aptos"` for Office 2024+, `"Calibri"` for earlier versions.
75
+
76
+ ---
77
+
78
+ ## Formula Template Syntax
79
+
80
+ Use `{row}` placeholder for dynamic row references:
81
+
82
+ ```
83
+ Template: =SUM(B{row}:D{row})
84
+
85
+ Row 2 becomes: =SUM(B2:D2)
86
+ Row 3 becomes: =SUM(B3:D3)
87
+ ...
88
+ ```
89
+
90
+ **Common patterns:**
91
+ ```
92
+ Sum: =SUM(B{row}:D{row})
93
+ Average: =AVERAGE(B{row}:D{row})
94
+ Percentage: =D{row}/B{row}*100
95
+ Conditional: =IF(E{row}>1000,"High","Low")
96
+ VLOOKUP: =IFERROR(VLOOKUP(A{row},'Lookup'!$A:$B,2,FALSE),"")
97
+ ```
98
+
99
+ **Syntax Rules:**
100
+ - Use `{row}` not `${row}` or `{ROW}`
101
+ - Escape quotes in formulas: `\"High\"` not `"High"`
102
+ - Test formula manually first if complex
103
+
104
+ ---
105
+
106
+ ## Multi-Sheet References
107
+
108
+ ### Basic Cross-Sheet Syntax
109
+
110
+ Reference cells in other worksheets using `SheetName!CellReference`:
111
+
112
+ | Reference Type | Syntax | Example |
113
+ |---------------|--------|---------|
114
+ | Single cell | `SheetName!A1` | `=Data!B5` |
115
+ | Range | `SheetName!A1:D10` | `=SUM(Sales!B2:B100)` |
116
+ | Absolute | `SheetName!$A$1` | `=Data!$B$5` |
117
+
118
+ **CRITICAL: Sheet names with spaces MUST be wrapped in single quotes — otherwise Excel opens Finder dialogs trying to find a file:**
119
+
120
+ | WRONG (opens Finder!) | CORRECT |
121
+ |-----------------------|---------|
122
+ | `=Income Statement!B5` | `='Income Statement'!B5` |
123
+ | `=SUM(Cash Flow!B2:B10)` | `=SUM('Cash Flow'!B2:B10)` |
124
+
125
+ ```
126
+ ='Q1 Sales'!B5
127
+ ='2024 Data'!A1:D50
128
+ ='Summary (Final)'!$C$10
129
+ ```
130
+
131
+ **Safe practice:** Always quote ALL cross-sheet references: `='Revenue'!B5` works the same as `=Revenue!B5` but is safer.
132
+
133
+ ### Common Cross-Sheet Patterns
134
+
135
+ | Pattern | Formula | Description |
136
+ |---------|---------|-------------|
137
+ | Lookup from data sheet | `=VLOOKUP(A2,Data!$A:$B,2,FALSE)` | Look up value from Data sheet |
138
+ | Sum from summary | `=Summary!$B$10` | Pull a total from Summary |
139
+ | Cross-sheet SUMIF | `=SUMIF(Data!$A:$A,A2,Data!$B:$B)` | Conditional sum from another sheet |
140
+ | Index-Match across sheets | `=INDEX(Lookup!$B:$B,MATCH(A2,Lookup!$A:$A,0))` | Flexible lookup |
141
+
142
+ ### External Workbook References
143
+
144
+ Reference cells in other Excel files:
145
+
146
+ | State | Syntax |
147
+ |-------|--------|
148
+ | File open | `=[Budget.xlsx]Sheet1!A1` |
149
+ | File closed | `='C:\Reports\[Budget.xlsx]Sheet1'!A1` |
150
+
151
+ ### Troubleshooting Cross-Sheet References
152
+
153
+ | Issue | Cause | Solution |
154
+ |-------|-------|----------|
155
+ | `#REF!` error | Source sheet deleted | Restore sheet or fix formula |
156
+ | Wrong values | Sheet name typo | Sheet names are CASE-SENSITIVE |
157
+ | `#NAME?` error | Missing quotes around sheet name with spaces | Add single quotes: `='My Sheet'!A1` |
158
+ | Broken external links | File moved | Update file path |
159
+
160
+ ---
161
+
162
+ ## Formula Safety Checklist
163
+
164
+ Before delivering any workbook with formulas, verify:
165
+
166
+ ### Essential Verification
167
+ - **Test 2-3 sample references**: Verify they pull correct values before building full model
168
+ - **Column mapping**: Confirm Excel columns match expected positions
169
+ - **Row offset**: Remember Excel rows are 1-indexed (data row 0 = Excel row 2 with headers)
170
+
171
+ ### Common Formula Pitfalls
172
+ | Pitfall | Symptom | Prevention |
173
+ |---------|---------|------------|
174
+ | Division by zero | `#DIV/0!` | Wrap with `IFERROR()` or check denominators |
175
+ | Wrong cell references | `#REF!` | Verify all referenced cells exist |
176
+ | Circular references | Infinite calc | Never reference a cell's own row in `SUM(B:B)` — use bounded ranges |
177
+ | **Self-referencing formula column** | Circular ref warning | **COUNT COLUMNS CAREFULLY.** A formula in column I must NOT reference column I — it references its own cell. Example: if headers are `..., Start Date(H), Years of Service(I)`, the formula in I2 must use `=DATEDIF(H2,...)` (column H), NOT `=DATEDIF(I2,...)` (column I = self). Always count: A=1, B=2, C=3... and verify the formula column letter matches the INPUT column, not the OUTPUT column. |
178
+ | Off-by-one ranges | Wrong totals | Total row formula must exclude the total row itself |
179
+ | Cross-sheet typo | `#NAME?` | Sheet names are CASE-SENSITIVE; use quotes for names with spaces |
180
+ | NaN / empty cells | `#VALUE!` | Check for blanks before arithmetic |
181
+
182
+ ### Formula Construction Rules
183
+ - Place ALL assumptions (growth rates, margins, multiples) in separate assumption cells
184
+ - Use cell references instead of hardcoded values: `=B5*(1+$B$6)` not `=B5*1.05`
185
+ - Ensure consistent formulas across all projection periods
186
+ - Test with edge cases: zero values, negative numbers, very large values