@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,524 @@
1
+ # lint-diagram.ps1 — deterministic authoring lint for business-analysis Mermaid
2
+ # diagram fragments. Behavioral twin of lint-diagram.sh; keep the two in sync.
3
+ #
4
+ # It also audits the sibling `attachments.md` evidence sidecar
5
+ # (caseStageKeys.ts): a ref filed under a key nothing on the map answers to
6
+ # renders nothing and raises no error, so a restructure that redraws the map
7
+ # without re-keying the sidecar silently orphans the user's evidence. On a
8
+ # case-design map keys target a stage (subgraph id or label slug) or one work
9
+ # item (node id); on a generic map, one step (node id).
10
+ #
11
+ # Usage: pwsh -File lint-diagram.ps1 --file "<absolute path to diagram.md>"
12
+ # Output: DIAGRAMLINT:error|warn <code> line=<N> <detail>
13
+ # DIAGRAMLINT:info band nodes=<N> edges=<M> (reported, never judged)
14
+ # DIAGRAMLINT:ok warnings=<m> / DIAGRAMLINT:fail errors=<n> warnings=<m>
15
+ # Exit: 0 = no errors, 1 = errors found, 2 = usage/file problem.
16
+
17
+ $ErrorActionPreference = 'Stop'
18
+
19
+ $File = ''
20
+ for ($argumentIndex = 0; $argumentIndex -lt $args.Count; $argumentIndex++) {
21
+ $argument = [string]($args[$argumentIndex])
22
+ if ($argument -ceq '--file' -or $argument -ceq '-File') {
23
+ if (($argumentIndex + 1) -ge $args.Count) {
24
+ Write-Output "DIAGRAMLINT:error usage line=0 $argument requires a path"
25
+ exit 2
26
+ }
27
+ $argumentIndex++
28
+ $File = [string]($args[$argumentIndex])
29
+ continue
30
+ }
31
+ Write-Output "DIAGRAMLINT:error usage line=0 unknown argument: $argument"
32
+ exit 2
33
+ }
34
+
35
+ if (-not $File -or -not (Test-Path -LiteralPath $File -PathType Leaf)) {
36
+ Write-Output "DIAGRAMLINT:error file line=0 diagram file not found: $(if ($File) { $File } else { '<missing --file>' })"
37
+ exit 2
38
+ }
39
+
40
+ # The evidence sidecar the case renderer reads, in the diagram's own directory
41
+ # (attachmentsSiblingPath: `as-is/diagram.md` -> `as-is/attachments.md`).
42
+ # String arithmetic, twinning the shell parameter expansion: Split-Path/Join-Path
43
+ # would normalize a path the operator gave us verbatim.
44
+ $separatorIndex = $File.LastIndexOfAny([char[]]@('/', '\'))
45
+ $attachmentsPath = if ($separatorIndex -ge 0) { $File.Substring(0, $separatorIndex + 1) + 'attachments.md' } else { './attachments.md' }
46
+
47
+ $script:errs = 0
48
+ $script:warns = 0
49
+
50
+ # [Console]::WriteLine, NOT Write-Output: these run inside functions whose
51
+ # return values are consumed (Test-ClassToken), and Write-Output would leak
52
+ # the message into the return stream instead of stdout.
53
+ function Emit-Error([string]$code, [int]$line, [string]$msg) {
54
+ [Console]::WriteLine("DIAGRAMLINT:error $code line=$line $msg")
55
+ $script:errs++
56
+ }
57
+ function Emit-Warn([string]$code, [int]$line, [string]$msg) {
58
+ [Console]::WriteLine("DIAGRAMLINT:warn $code line=$line $msg")
59
+ $script:warns++
60
+ }
61
+
62
+ $RESERVED = @('end', 'subgraph', 'flowchart', 'graph', 'class', 'classDef', 'style', 'linkStyle', 'click', 'direction')
63
+ $MODES = @('automated', 'assisted', 'agent', 'review', 'manual')
64
+ $KINDS = @('task', 'decision', 'event', 'wait', 'subprocess', 'control', 'evidence', 'data-store')
65
+ $CASETASKS = @('process', 'action', 'agent', 'api-workflow', 'rpa', 'wait-for-timer', 'wait-for-connector', 'execute-connector-activity', 'case-management')
66
+
67
+ function Test-Slug([string]$s) { return $s -cmatch '^[a-z0-9]+(-[a-z0-9]+)*$' }
68
+ function Test-NodeId([string]$id) { return $id -cmatch '^[A-Za-z][A-Za-z0-9_]*$' }
69
+
70
+ $decl = [System.Collections.Hashtable]::new([System.StringComparer]::Ordinal)
71
+ $subgraphIds = [System.Collections.Hashtable]::new([System.StringComparer]::Ordinal)
72
+ $covered = [System.Collections.Hashtable]::new([System.StringComparer]::Ordinal)
73
+ $refAt = [System.Collections.Hashtable]::new([System.StringComparer]::Ordinal)
74
+ $classedAt = [System.Collections.Hashtable]::new([System.StringComparer]::Ordinal)
75
+ $declGroup = [System.Collections.Hashtable]::new([System.StringComparer]::Ordinal)
76
+ $subgraphLabel = [System.Collections.Hashtable]::new([System.StringComparer]::Ordinal)
77
+ $nodeKind = [System.Collections.Hashtable]::new([System.StringComparer]::Ordinal)
78
+ $nodeCaseTaskCount = [System.Collections.Hashtable]::new([System.StringComparer]::Ordinal)
79
+ $nodeCaseEnds = [System.Collections.Hashtable]::new([System.StringComparer]::Ordinal)
80
+ $incoming = [System.Collections.Hashtable]::new([System.StringComparer]::Ordinal)
81
+ $outgoing = [System.Collections.Hashtable]::new([System.StringComparer]::Ordinal)
82
+ $subgraphStack = @{}
83
+
84
+ $inFence = $false
85
+ $fenceOpens = 0
86
+ $family = ''
87
+ $flowcharts = 0
88
+ $nodes = 0
89
+ $edgeCount = 0
90
+ $total = 0
91
+ $inSub = 0
92
+ $currentGroup = ''
93
+ $script:sgCount = 0
94
+
95
+ function Mark-Decl([string]$id, [int]$line) {
96
+ if ($RESERVED -ccontains $id) {
97
+ Emit-Error 'reserved-id' $line "Mermaid keyword used as a node ID: $id (rename it, e.g. ${id}Node)"
98
+ return
99
+ }
100
+ if ($subgraphIds.ContainsKey($id)) {
101
+ Emit-Error 'duplicate-id' $line "ID is used by both a node and a subgraph: $id"
102
+ return
103
+ }
104
+ if ($decl.ContainsKey($id)) {
105
+ Emit-Error 'duplicate-id' $line "node ID declared more than once: $id"
106
+ return
107
+ }
108
+ $decl[$id] = $line
109
+ $declGroup[$id] = $currentGroup
110
+ $script:nodes++
111
+ }
112
+
113
+ function Mark-Subgraph([string]$id, [string]$label, [int]$line) {
114
+ if ($RESERVED -ccontains $id) {
115
+ Emit-Error 'reserved-id' $line "Mermaid keyword used as a subgraph ID: $id"
116
+ return
117
+ }
118
+ if ($decl.ContainsKey($id)) {
119
+ Emit-Error 'duplicate-id' $line "ID is used by both a node and a subgraph: $id"
120
+ return
121
+ }
122
+ if ($subgraphIds.ContainsKey($id)) {
123
+ Emit-Error 'duplicate-id' $line "subgraph ID declared more than once: $id"
124
+ return
125
+ }
126
+ $subgraphIds[$id] = $line
127
+ $subgraphLabel[$id] = $label
128
+ $script:sgCount++
129
+ }
130
+
131
+ # Stage label -> sidecar key slug, per slugifyStageLabel in caseStageKeys.ts.
132
+ function Get-StageSlug([string]$label) {
133
+ $slug = $label.ToLowerInvariant() -creplace '[^a-z0-9]+', '-'
134
+ return ($slug -creplace '^-+|-+$', '')
135
+ }
136
+
137
+ # One key line of the sidecar frontmatter, quoted either way; '' when the line
138
+ # is not a plain key (an exotic spelling is skipped, never guessed at).
139
+ function Get-SidecarKey([string]$body) {
140
+ if ($body.Length -eq 0) { return '' }
141
+ $quote = $body[0]
142
+ if ($quote -ceq '"' -or $quote -ceq "'") {
143
+ $end = $body.IndexOf($quote, 1)
144
+ if ($end -lt 0) { return '' }
145
+ if ($body.Substring($end + 1) -cnotmatch '^[ \t]*:') { return '' }
146
+ return $body.Substring(1, $end - 1)
147
+ }
148
+ if ($body -cmatch '^([A-Za-z0-9_][A-Za-z0-9_.-]*):([ \t]|$)') { return $Matches[1] }
149
+ return ''
150
+ }
151
+
152
+ function Test-ClassToken([string]$tok, [int]$line) {
153
+ if ($tok -ceq 'case-ends-case') {
154
+ if ($family -ceq 'generic') { Emit-Error 'case-class-in-generic' $line 'case-ends-case is a case-design class' }
155
+ return $true
156
+ }
157
+ if ($tok -clike 'mode-*') {
158
+ if ($family -ceq 'case-design') { Emit-Error 'mode-in-case-map' $line "mode-* classes are not allowed on case-design maps: $tok"; return $true }
159
+ if ($MODES -ccontains $tok.Substring(5)) { return $true }
160
+ if ($tok -ceq 'mode-current' -or $tok -ceq 'mode-future') { Emit-Error 'unknown-class' $line "$tok does not exist — the wiki folder carries current-vs-future; class how the step runs (mode-manual, mode-automated, ...)"; return $false }
161
+ Emit-Error 'unknown-class' $line "not a supported mode: $tok"
162
+ return $false
163
+ }
164
+ if ($tok -clike 'kind-*') {
165
+ if ($KINDS -ccontains $tok.Substring(5)) { return $true }
166
+ if ($tok -ceq 'kind-stage') { Emit-Error 'unknown-class' $line 'kind-stage is not a class — stages are subgraphs, not classes'; return $false }
167
+ Emit-Error 'unknown-class' $line "not a supported kind: $tok"
168
+ return $false
169
+ }
170
+ if ($tok -clike 'case-task-*') {
171
+ if ($family -ceq 'generic') { Emit-Error 'case-class-in-generic' $line "case-task-* classes belong on case-design maps: $tok"; return $true }
172
+ if ($CASETASKS -ccontains $tok.Substring(10)) { return $true }
173
+ Emit-Error 'unknown-class' $line "not a supported case task type: $tok"
174
+ return $false
175
+ }
176
+ if ($tok -clike 'owner-*') { if (Test-Slug $tok.Substring(6)) { return $true }; Emit-Error 'bad-slug' $line "owner slug must be lowercase-hyphen: $tok"; return $false }
177
+ if ($tok -clike 'system-*') { if (Test-Slug $tok.Substring(7)) { return $true }; Emit-Error 'bad-slug' $line "system slug must be lowercase-hyphen: $tok"; return $false }
178
+ if ($tok -clike 'icon-*') { if (Test-Slug $tok.Substring(5)) { return $true }; Emit-Error 'bad-slug' $line "icon slug must be lowercase-hyphen: $tok"; return $false }
179
+ if ($MODES -ccontains $tok) { Emit-Warn 'legacy-mode' $line "legacy mode alias, use mode-$tok"; return $true }
180
+ Emit-Error 'unknown-class' $line "unrecognized class token (styling classes are not semantic): $tok"
181
+ return $false
182
+ }
183
+
184
+ $lines = Get-Content -LiteralPath $File
185
+ $nr = 0
186
+ foreach ($raw in $lines) {
187
+ $nr++
188
+ $line = $raw
189
+
190
+ if (-not $inFence) {
191
+ if ($line -cmatch '^[ \t]*$') { continue }
192
+ if ($line -cmatch '^```mermaid') {
193
+ $fenceOpens++
194
+ if ($fenceOpens -gt 1) { Emit-Error 'multiple-fences' $nr 'only one fenced Mermaid block is allowed'; continue }
195
+ $inFence = $true
196
+ if ($line -cmatch '^```mermaid[ \t]+diagramFamily=(generic|case-design)[ \t]*$') {
197
+ $family = $Matches[1]
198
+ }
199
+ elseif ($line -cmatch 'diagramFamily=([^ \t]*)') {
200
+ Emit-Error 'bad-family' $nr "diagramFamily must be generic or case-design, got: $($Matches[1])"
201
+ $family = 'generic'
202
+ }
203
+ else {
204
+ Emit-Error 'missing-family' $nr 'opening fence needs diagramFamily=generic or diagramFamily=case-design'
205
+ $family = 'generic'
206
+ }
207
+ continue
208
+ }
209
+ Emit-Error 'outside-fence' $nr 'content outside the fenced Mermaid block (prose belongs in overview.md)'
210
+ continue
211
+ }
212
+
213
+ if ($line -cmatch '^```[ \t]*$') { $inFence = $false; continue }
214
+
215
+ $total += $line.Length + 1
216
+
217
+ if ($line -cmatch '<br' -or $line -cmatch '</?[A-Za-z][A-Za-z0-9]*[^>]*>') {
218
+ Emit-Error 'html-in-label' $nr 'HTML is not allowed; keep labels single-line plain text'
219
+ }
220
+ if ($line -cmatch ':::') {
221
+ Emit-Error 'triple-colon' $nr ':::class shorthand is not allowed; use explicit class statements'
222
+ }
223
+
224
+ $source = $line -replace '^[ \t]+', ''
225
+ $stripped = [regex]::Replace($source, '"[^"]*"', '""')
226
+
227
+ if ($source -cmatch '^[ \t]*$') { continue }
228
+ if ($stripped -cmatch '^%%') { Emit-Warn 'comment' $nr 'avoid %% comments in canonical fragments'; continue }
229
+ if ($stripped -cmatch '^(style|linkStyle|click)[ \t]') { Emit-Error 'forbidden-directive' $nr 'style/linkStyle/click are not allowed'; continue }
230
+
231
+ if ($stripped -cmatch '^flowchart') {
232
+ $flowcharts++
233
+ $fields = $stripped -split '[ \t]+'
234
+ if ($fields.Count -ne 2 -or $fields[0] -cne 'flowchart') {
235
+ Emit-Error 'malformed-flowchart' $nr 'flowchart must be exactly: flowchart TB or flowchart LR'
236
+ continue
237
+ }
238
+ $dir = $fields[1]
239
+ if ($family -ceq 'generic' -and $dir -cne 'TB') { Emit-Error 'wrong-direction' $nr "generic maps must be flowchart TB, got: $dir" }
240
+ if ($family -ceq 'case-design' -and $dir -cne 'LR') { Emit-Error 'wrong-direction' $nr "case-design maps must be flowchart LR, got: $dir" }
241
+ continue
242
+ }
243
+
244
+ if ($stripped -cmatch '^classDef[ \t]+(\S+)') {
245
+ $cdName = $Matches[1]
246
+ if ($family -ceq 'case-design') {
247
+ Emit-Error 'classdef-in-case-map' $nr 'case-design maps never carry classDef declarations'
248
+ }
249
+ else { Emit-Warn 'classdef-nonsemantic' $nr "classDef $cdName is styling-only; do not author classDef declarations" }
250
+ continue
251
+ }
252
+
253
+ if ($stripped -cmatch '^class[ \t]') {
254
+ $fields = $stripped -split '[ \t]+'
255
+ if ($fields.Count -gt 3) {
256
+ # Space-separated class tokens are a hard Mermaid parse error
257
+ # ("got SPACE"); join and validate every token so none escape.
258
+ Emit-Error 'class-form' $nr 'class tokens must be comma-separated, not space-separated: join them (class <nodeId> <class1>,<class2>)'
259
+ }
260
+ elseif ($fields.Count -ne 3) { Emit-Warn 'class-form' $nr 'class statement should be: class <nodeId> <class1>,<class2>' }
261
+ $idPart = if ($fields.Count -ge 2) { $fields[1] } else { '' }
262
+ $clsPart = if ($fields.Count -ge 3) { ($fields[2..($fields.Count - 1)] -join ',') } else { '' }
263
+ if ($idPart -cmatch ',') { Emit-Error 'multi-node-class' $nr "one class statement per node is required: $idPart" }
264
+ if (-not (Test-NodeId $idPart)) { Emit-Error 'class-form' $nr 'class statement needs one node ID: class <nodeId> <class1>,<class2>' }
265
+ if ($classedAt.ContainsKey($idPart)) { Emit-Error 'duplicate-class-statement' $nr "node $idPart has more than one class statement" }
266
+ $recognized = $false
267
+ $hasKindTask = $false
268
+ $kindCount = 0
269
+ $modeCount = 0
270
+ $caseTaskCount = 0
271
+ $kindValue = ''
272
+ $caseEnds = $false
273
+ foreach ($tok in ($clsPart -split ',')) {
274
+ if ($tok -ceq '') { continue }
275
+ if (Test-ClassToken $tok $nr) { $recognized = $true }
276
+ if ($tok -clike 'mode-*' -and $MODES -ccontains $tok.Substring(5)) { $modeCount++ }
277
+ if ($tok -clike 'kind-*' -and $KINDS -ccontains $tok.Substring(5)) {
278
+ $kindCount++
279
+ $kindValue = $tok.Substring(5)
280
+ if ($tok -ceq 'kind-task') { $hasKindTask = $true }
281
+ }
282
+ if ($tok -clike 'case-task-*' -and $CASETASKS -ccontains $tok.Substring(10)) { $caseTaskCount++ }
283
+ if ($tok -ceq 'case-ends-case') { $caseEnds = $true }
284
+ }
285
+ if ($family -ceq 'generic') {
286
+ if ($kindCount -eq 0) { Emit-Error 'missing-kind' $nr "generic node $idPart needs exactly one kind-* class" }
287
+ if ($kindCount -gt 1) { Emit-Error 'conflicting-semantics' $nr "generic node $idPart carries more than one kind-* class" }
288
+ if ($modeCount -eq 0) { Emit-Error 'missing-mode' $nr "generic node $idPart needs exactly one mode-* class" }
289
+ if ($modeCount -gt 1) { Emit-Error 'conflicting-semantics' $nr "generic node $idPart carries more than one mode-* class" }
290
+ }
291
+ if ($family -ceq 'case-design') {
292
+ if ($kindCount -eq 0) { Emit-Error 'missing-kind' $nr "case-design node $idPart needs exactly one kind-* class" }
293
+ if ($kindCount -gt 1) { Emit-Error 'conflicting-semantics' $nr "case-design node $idPart carries more than one kind-* class" }
294
+ if ($hasKindTask -and $caseTaskCount -eq 0) { Emit-Error 'missing-case-task' $nr "work step $idPart needs exactly one case-task-* class" }
295
+ if ($hasKindTask -and $caseTaskCount -gt 1) { Emit-Error 'conflicting-semantics' $nr "work step $idPart carries more than one case-task-* class" }
296
+ if (-not $hasKindTask -and $caseTaskCount -gt 0) { Emit-Error 'conflicting-semantics' $nr "only kind-task nodes may carry case-task-* classes: $idPart" }
297
+ }
298
+ $classedAt[$idPart] = $nr
299
+ if ($kindCount -eq 1) { $nodeKind[$idPart] = $kindValue }
300
+ $nodeCaseTaskCount[$idPart] = $caseTaskCount
301
+ $nodeCaseEnds[$idPart] = $caseEnds
302
+ if ($recognized) { $covered[$idPart] = $true }
303
+ continue
304
+ }
305
+
306
+ if ($stripped -cmatch '^subgraph[ \t]+(.*)$') {
307
+ if ($family -ceq 'generic') { Emit-Warn 'subgraph-in-generic' $nr 'subgraphs are a case-design construct' }
308
+ $rest = $Matches[1]
309
+ if ($rest -cmatch '^([A-Za-z][A-Za-z0-9_]*)\["[^"]*"\][ \t]*$') {
310
+ $sid = $Matches[1]
311
+ # The sidecar may key a stage by its label slug, so keep the label.
312
+ # It reads off $source: $stripped has every quoted string blanked.
313
+ $sgLabel = ''
314
+ if (($source -creplace '[ \t]+$', '') -cmatch '\["([^"]*)"\]$') { $sgLabel = $Matches[1] }
315
+ Mark-Subgraph $sid $sgLabel $nr
316
+ $inSub++
317
+ $subgraphStack[$inSub] = $sid
318
+ $currentGroup = $sid
319
+ }
320
+ else {
321
+ Emit-Error 'malformed-subgraph' $nr 'subgraph must be: subgraph stageId["Stage name"]'
322
+ }
323
+ continue
324
+ }
325
+ if ($stripped -cmatch '^end[ \t]*$') {
326
+ if ($inSub -gt 0) {
327
+ $subgraphStack.Remove($inSub)
328
+ $inSub--
329
+ $currentGroup = if ($inSub -gt 0) { $subgraphStack[$inSub] } else { '' }
330
+ if ($family -ceq 'generic') { Emit-Warn 'subgraph-in-generic' $nr 'subgraph end in a generic map' }
331
+ }
332
+ else { Emit-Error 'stray-end' $nr 'end without an open subgraph' }
333
+ continue
334
+ }
335
+
336
+ $hasEdge = ($stripped -cmatch '-->' -or $stripped -cmatch '-\.->' -or $stripped -cmatch '==>' -or $stripped -cmatch '-\.[^>]*\.->' -or $stripped -cmatch '--[^>-][^>]*-->')
337
+ $isNode = $source -cmatch '^[A-Za-z][A-Za-z0-9_]*(\["[^"]*"\]|\{"[^"]*"\}|\(\("[^"]*"\)\))[ \t]*$'
338
+
339
+ # Inline node declarations: id immediately followed by [ { or ((
340
+ foreach ($m in [regex]::Matches($stripped, '([A-Za-z][A-Za-z0-9_]*)(\[|\{|\(\()')) {
341
+ $id = $m.Groups[1].Value
342
+ $afterIdx = $m.Index + $m.Length
343
+ $after = if ($afterIdx -lt $stripped.Length) { $stripped[$afterIdx] } else { ' ' }
344
+ Mark-Decl $id $nr
345
+ if ($hasEdge) { Emit-Warn 'inline-decl' $nr "declare node $id on its own line before any edge references it" }
346
+ if ($after -cne '"') { Emit-Error 'unquoted-label' $nr "label for node $id must be double-quoted inside its shape" }
347
+ }
348
+ # Unsupported shapes: id followed by ([
349
+ foreach ($m in [regex]::Matches($stripped, '([A-Za-z][A-Za-z0-9_]*)\(\[')) {
350
+ $id = $m.Groups[1].Value
351
+ Emit-Error 'unsupported-shape' $nr "shape ([ ... ]) is outside the subset for node $id; use [`"...`"], {`"...`"}, or ((`"...`"))"
352
+ Mark-Decl $id $nr
353
+ }
354
+
355
+ if ($hasEdge) {
356
+ if ($stripped -cnotmatch '^[A-Za-z][A-Za-z0-9_]*[ \t]*(-->\|[^|]*\||-->|==>|-\.[^>]*\.->|--[^>-][^>]*-->)[ \t]*[A-Za-z][A-Za-z0-9_]*[ \t]*$') {
357
+ Emit-Error 'malformed-edge' $nr 'edge must connect exactly two declared node IDs'
358
+ }
359
+ $edgeCount++
360
+ $e = $stripped
361
+ if ($e -cmatch '--[ \t]+[^>-][^>]*[ \t]+-->') { Emit-Warn 'edge-text-style' $nr 'prefer -->|Outcome| over -- text --> edge labels' }
362
+ $e = [regex]::Replace($e, '\|[^|]*\|', ' ')
363
+ $e = [regex]::Replace($e, '--[^>-][^>]*-->', ' --> ')
364
+ $e = [regex]::Replace($e, '-\.[^>]*\.->', ' --> ')
365
+ $e = [regex]::Replace($e, '\[[^\]]*\]', ' '); $e = [regex]::Replace($e, '\[[^\]]*\]', ' ')
366
+ $e = [regex]::Replace($e, '\{[^}]*\}', ' ')
367
+ $e = [regex]::Replace($e, '\([^()]*\)', ' '); $e = [regex]::Replace($e, '\([^()]*\)', ' ')
368
+ $e = [regex]::Replace($e, '-->|==>|-\.->|&', ' ')
369
+ $edgeIds = @()
370
+ foreach ($tok in ($e -split '[^A-Za-z0-9_]+')) {
371
+ if ($tok -ceq '' -or $tok -cmatch '^[0-9]') { continue }
372
+ if ($RESERVED -ccontains $tok) { Emit-Error 'reserved-id' $nr "Mermaid keyword used as an edge endpoint: $tok"; continue }
373
+ $edgeIds += $tok
374
+ $refAt[$tok] = $nr
375
+ }
376
+ if ($edgeIds.Count -ge 2) {
377
+ $sourceId = $edgeIds[0]
378
+ $target = $edgeIds[1]
379
+ $outgoing[$sourceId] = if ($outgoing.ContainsKey($sourceId)) { $outgoing[$sourceId] + 1 } else { 1 }
380
+ $incoming[$target] = if ($incoming.ContainsKey($target)) { $incoming[$target] + 1 } else { 1 }
381
+ }
382
+ }
383
+ elseif (-not $isNode) { Emit-Error 'unknown-statement' $nr "unsupported structural statement: $source" }
384
+ }
385
+
386
+ # Collect the stage/item keys the sidecar files evidence and notes under. Only
387
+ # the `attachments:` and `notes:` maps of the leading frontmatter are read —
388
+ # the same block parseDiagramAttachments reads, by the same rules. Both Mermaid
389
+ # families read the sidecar: case stages and items, generic steps (their
390
+ # UI-level detail opens from the node).
391
+ $sidecarKeys = [System.Collections.Generic.List[object]]::new()
392
+ $sidecarClosed = $false
393
+ if (($family -ceq 'case-design' -or $family -ceq 'generic') -and (Test-Path -LiteralPath $attachmentsPath -PathType Leaf)) {
394
+ $sidecarSection = ''
395
+ $sidecarChildIndent = -1
396
+ $sidecarState = 0
397
+ $sidecarNr = 0
398
+ foreach ($rawSidecar in (Get-Content -LiteralPath $attachmentsPath)) {
399
+ $sidecarNr++
400
+ $sidecarLine = [string]$rawSidecar
401
+ if ($sidecarState -eq 2) { break }
402
+ if ($sidecarState -eq 0) {
403
+ # extractFrontmatter anchors on the very first line; anything else
404
+ # means the file has no frontmatter and the renderer reads nothing.
405
+ if ($sidecarNr -eq 1 -and $sidecarLine -ceq '---') { $sidecarState = 1 } else { $sidecarState = 2 }
406
+ continue
407
+ }
408
+ if ($sidecarLine -ceq '---') { $sidecarState = 2; $sidecarClosed = $true; continue }
409
+ if ($sidecarLine -cmatch '^[ \t]*$' -or $sidecarLine -cmatch '^[ \t]*#' -or $sidecarLine -cmatch '^\t') { continue }
410
+ $indent = 0
411
+ while ($indent -lt $sidecarLine.Length -and $sidecarLine[$indent] -ceq ' ') { $indent++ }
412
+ $body = $sidecarLine.Substring($indent)
413
+ if ($indent -eq 0) {
414
+ $sidecarChildIndent = -1
415
+ if ($body -cmatch '^attachments:[ \t]*$') { $sidecarSection = 'attachments' }
416
+ elseif ($body -cmatch '^notes:[ \t]*$') { $sidecarSection = 'notes' }
417
+ else { $sidecarSection = '' }
418
+ continue
419
+ }
420
+ if ($sidecarSection -ceq '') { continue }
421
+ if ($sidecarChildIndent -lt 0) { $sidecarChildIndent = $indent }
422
+ if ($indent -ne $sidecarChildIndent) { continue }
423
+ # A map whose direct children are list items is not the documented
424
+ # key-per-stage shape; leave it to the renderer rather than guess at it.
425
+ if ($body[0] -ceq '-') { $sidecarSection = ''; continue }
426
+ $sidecarKey = Get-SidecarKey $body
427
+ if ($sidecarKey -ceq '') { continue }
428
+ $sidecarKeys.Add([pscustomobject]@{ Key = $sidecarKey; Line = $sidecarNr; Map = $sidecarSection })
429
+ }
430
+ }
431
+
432
+ if ($fenceOpens -eq 0) { Emit-Error 'no-fence' 0 'no ```mermaid fence found' }
433
+ if ($inFence) { Emit-Error 'unclosed-fence' $nr 'the Mermaid fence is never closed' }
434
+ if ($inSub -gt 0) { Emit-Error 'unclosed-subgraph' $nr 'subgraph is never closed with end' }
435
+ if ($fenceOpens -le 1) {
436
+ if ($flowcharts -eq 0) { Emit-Error 'missing-flowchart' 0 'the fragment must start with a flowchart declaration' }
437
+ if ($flowcharts -gt 1) { Emit-Error 'multiple-flowchart' 0 'only one flowchart declaration is allowed' }
438
+ if ($nodes -lt 2 -or $edgeCount -eq 0) { Emit-Error 'sparse-graph' 0 "renderer needs at least 2 nodes and 1 edge (nodes=$nodes, edges=$edgeCount)" }
439
+ if ($family -ceq 'case-design' -and $script:sgCount -eq 0) { Emit-Error 'missing-stages' 0 'case-design maps group work into stage subgraphs; found none (stages are subgraphs, not classes)' }
440
+ foreach ($id in $refAt.Keys) {
441
+ if (-not $decl.ContainsKey($id) -and -not $subgraphIds.ContainsKey($id)) {
442
+ Emit-Error 'undeclared-endpoint' $refAt[$id] "edge references undeclared node: $id"
443
+ }
444
+ }
445
+ foreach ($id in $classedAt.Keys) {
446
+ if (-not $decl.ContainsKey($id)) { Emit-Error 'undeclared-class-node' $classedAt[$id] "class statement references undeclared node: $id" }
447
+ }
448
+ $coveredCount = 0
449
+ foreach ($id in $decl.Keys) {
450
+ if ($covered.ContainsKey($id)) { $coveredCount++; continue }
451
+ Emit-Error 'uncovered-node' $decl[$id] "node $id has no recognized semantic class (renderer requires 100% coverage for supported status)"
452
+ }
453
+ if ($family -ceq 'case-design') {
454
+ $caseTerminalCount = 0
455
+ foreach ($id in $decl.Keys) {
456
+ $group = if ($declGroup.ContainsKey($id)) { $declGroup[$id] } else { '' }
457
+ $kind = if ($nodeKind.ContainsKey($id)) { $nodeKind[$id] } else { '' }
458
+ $incomingCount = if ($incoming.ContainsKey($id)) { $incoming[$id] } else { 0 }
459
+ $outgoingCount = if ($outgoing.ContainsKey($id)) { $outgoing[$id] } else { 0 }
460
+ if ($group -ceq '' -and $kind -ceq 'task') {
461
+ Emit-Error 'case-task-outside-stage' $decl[$id] "Case work task must be inside a stage subgraph: $id"
462
+ }
463
+ elseif ($group -ceq '' -and ($kind -cne 'event' -or $incomingCount -gt 0 -or $outgoingCount -eq 0)) {
464
+ Emit-Error 'case-node-outside-stage' $decl[$id] "only start kind-event nodes with an outgoing edge and no incoming edge may be outside Case stage subgraphs: $id"
465
+ }
466
+ $endsCase = $nodeCaseEnds.ContainsKey($id) -and $nodeCaseEnds[$id]
467
+ $caseTaskCount = if ($nodeCaseTaskCount.ContainsKey($id)) { $nodeCaseTaskCount[$id] } else { 0 }
468
+ if ($endsCase) {
469
+ $caseTerminalCount++
470
+ if ($kind -cne 'task' -or $caseTaskCount -ne 1 -or $outgoingCount -gt 0) {
471
+ Emit-Error 'conflicting-semantics' $decl[$id] "case-ends-case requires kind-task with exactly one case-task-* class and no outgoing edge: $id"
472
+ }
473
+ }
474
+ }
475
+ if ($caseTerminalCount -eq 0) {
476
+ Emit-Error 'missing-case-terminal' 0 'case-design maps require at least one case-ends-case terminal task'
477
+ }
478
+ }
479
+ # A ref or note under a key no stage or step answers to renders nothing and
480
+ # raises no error (findOrphanedSidecarKeys): the evidence is silently lost,
481
+ # so fail. A stageless Case map already failed missing-stages; auditing
482
+ # against an empty stage set would only add noise.
483
+ if ($sidecarClosed -and $sidecarKeys.Count -gt 0 -and ($family -ceq 'generic' -or ($family -ceq 'case-design' -and $script:sgCount -gt 0))) {
484
+ # Only case subgraphs are stages; a generic map answers to node ids alone.
485
+ $stageKeys = [System.Collections.Hashtable]::new([System.StringComparer]::Ordinal)
486
+ $reKey = 'a step node id'
487
+ if ($family -ceq 'case-design') {
488
+ foreach ($id in $subgraphIds.Keys) {
489
+ $stageKeys[$id] = $true
490
+ $stageLabel = [string]$subgraphLabel[$id]
491
+ if ($stageLabel -cne '') {
492
+ $slug = Get-StageSlug $stageLabel
493
+ if ($slug -cne '') { $stageKeys[$slug] = $true }
494
+ }
495
+ }
496
+ $reKey = 'a stage subgraph id, its label slug, or a work item node id'
497
+ }
498
+ # Both maps resolve the same way: a stage answers to its subgraph id and
499
+ # to its label slug, a work item or step to its node id. Evidence and
500
+ # notes are filed per stage OR per work item.
501
+ foreach ($entry in $sidecarKeys) {
502
+ if ($stageKeys.ContainsKey($entry.Key) -or $decl.ContainsKey($entry.Key)) { continue }
503
+ if ($entry.Map -ceq 'notes') {
504
+ Emit-Error 'orphaned-note-key' 0 "attachments.md:$($entry.Line) note key `"$($entry.Key)`" answers to nothing on this map (re-key it to $reKey, or drop it)"
505
+ }
506
+ else {
507
+ Emit-Error 'orphaned-attachment-key' 0 "attachments.md:$($entry.Line) evidence key `"$($entry.Key)`" answers to nothing on this map (re-key it to $reKey, or drop it)"
508
+ }
509
+ }
510
+ }
511
+ if ($nodes -gt 0 -and $coveredCount -eq 0) { Emit-Error 'missing-semantics' 0 'zero nodes carry a recognized semantic class; the rich view falls back' }
512
+ if ($total -gt 10000) { Emit-Error 'source-too-large' 0 "fenced source is $total chars; renderer caps at 10000" }
513
+ elseif ($total -gt 9000) { Emit-Warn 'source-size' 0 "fenced source is $total chars; renderer caps at 10000" }
514
+ }
515
+
516
+ if ($script:errs -gt 0) {
517
+ Write-Output "DIAGRAMLINT:fail errors=$($script:errs) warnings=$($script:warns)"
518
+ exit 1
519
+ }
520
+ # the agent was aimed at the 2-node renderer minimum instead. Printing the real
521
+ # band closes that gap without making it a refusal.
522
+ Write-Output "DIAGRAMLINT:info band nodes=$nodes edges=$edgeCount"
523
+ Write-Output "DIAGRAMLINT:ok warnings=$($script:warns)"
524
+ exit 0