alran 0.0.0-stage → 1.0.1

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 (505) hide show
  1. package/ALRAN_TOOLS_NOTICES.md +75 -0
  2. package/LICENSE +27 -0
  3. package/LICENSE-STATUS.md +21 -0
  4. package/NOTICE +6 -0
  5. package/README.md +284 -2
  6. package/THIRD_PARTY_NOTICES.md +113 -0
  7. package/alran-tools.js +3 -0
  8. package/assets/agents/_default/prompt-auto_classifier.md +185 -0
  9. package/assets/agents/_default/prompt-auto_classifier_extras.md +17 -0
  10. package/assets/agents/_default/prompt-base-all.md +133 -0
  11. package/assets/agents/_default/prompt-base-all.md.hbs +228 -0
  12. package/assets/agents/_default/prompt-base-windows.md +5 -0
  13. package/assets/agents/_default/prompt-base-windows.md.hbs +5 -0
  14. package/assets/agents/_default/prompt-base-worker.md +10 -0
  15. package/assets/agents/_default/prompt-base-worker.md.hbs +27 -0
  16. package/assets/agents/_default/prompt-compact.md +76 -0
  17. package/assets/agents/_default/prompt-compact_continue.md +9 -0
  18. package/assets/agents/_default/prompt-git.md +8 -0
  19. package/assets/agents/_default/prompt-goal.md +13 -0
  20. package/assets/agents/_default/prompt-session-branch.md +3 -0
  21. package/assets/agents/_default/prompt-session-branch.md.hbs +30 -0
  22. package/assets/agents/_default/prompt-session-root.md +3 -0
  23. package/assets/agents/_default/prompt-session-root.md.hbs +32 -0
  24. package/assets/agents/_default/prompt-title.md +11 -0
  25. package/assets/agents/_default/prompt-tool_agent.md +22 -0
  26. package/assets/agents/_migration/README.md +20 -0
  27. package/assets/agents/_migration/coder/PERSONA.md +11 -0
  28. package/assets/agents/_migration/coder/system-prompt.md.hbs +42 -0
  29. package/assets/agents/_migration/general/PERSONA.md +11 -0
  30. package/assets/agents/_migration/general/system-prompt.md.hbs +49 -0
  31. package/assets/agents/_v2/AGENT_CONTEXT.md.hbs +245 -0
  32. package/assets/agents/_v2/PTC_TOOL_CALLS.md.hbs +35 -0
  33. package/assets/agents/_v2/coding/SYSTEM.md.hbs +173 -0
  34. package/assets/agents/_v2/explore.md.hbs +38 -0
  35. package/assets/agents/_v2/tui/SYSTEM.md.hbs +211 -0
  36. package/assets/agents/_v2/verifier.md.hbs +32 -0
  37. package/assets/agents/_v2/work/SYSTEM.md.hbs +186 -0
  38. package/assets/agents/_v2/worker.md.hbs +27 -0
  39. package/assets/agents/alran/PERSONA.md +7 -0
  40. package/assets/agents/alran/features/cron.md.hbs +0 -0
  41. package/assets/agents/alran/features/delegation.md.hbs +56 -0
  42. package/assets/agents/alran/features/memory.md.hbs +61 -0
  43. package/assets/agents/alran/features/recoverable-deletion.md.hbs +10 -0
  44. package/assets/agents/alran/features/task-management.md.hbs +11 -0
  45. package/assets/agents/alran/features/web-search.md.hbs +11 -0
  46. package/assets/agents/alran/modes/coding/online/PERSONA.md.hbs +20 -0
  47. package/assets/agents/alran/modes/coding/online/SYSTEM.md.hbs +158 -0
  48. package/assets/agents/alran/modes/work/online/PERSONA.md.hbs +20 -0
  49. package/assets/agents/alran/modes/work/online/SYSTEM.md.hbs +160 -0
  50. package/assets/agents/alran/prompt-session-root.md +4 -0
  51. package/assets/agents/alran/prompt-session-root.md.hbs +4 -0
  52. package/assets/agents/alran/skills/alran-code-product/SKILL.md +72 -0
  53. package/assets/agents/alran/skills/alran-code-product/references/account-models.md +64 -0
  54. package/assets/agents/alran/skills/alran-code-product/references/agents.md +34 -0
  55. package/assets/agents/alran/skills/alran-code-product/references/extensions.md +46 -0
  56. package/assets/agents/alran/skills/alran-code-product/references/workflows.md +56 -0
  57. package/assets/agents/alran/skills/control-in-app-browser/SKILL.md +590 -0
  58. package/assets/agents/alran/system-prompt.md.hbs +97 -0
  59. package/assets/agents/builtin-agents.json +1 -0
  60. package/assets/agents/desktop-task/archive-title/system-en.md +1 -0
  61. package/assets/agents/desktop-task/checkpoint/system.md +19 -0
  62. package/assets/agents/desktop-task/output-revision/system.md +1 -0
  63. package/assets/agents/desktop-task/retry/continuation.md +4 -0
  64. package/assets/agents/desktop-task/session-title/system.md +41 -0
  65. package/assets/agents/explore/PERSONA.md +8 -0
  66. package/assets/agents/explore/agent.md +14 -0
  67. package/assets/agents/explore/system-prompt.md.hbs +35 -0
  68. package/assets/agents/greeting.md +61 -0
  69. package/assets/agents/managed-prompts.json +47 -0
  70. package/assets/agents/prompt-exemptions.json +36 -0
  71. package/assets/agents/verifier/PERSONA.md +8 -0
  72. package/assets/agents/verifier/agent.md +17 -0
  73. package/assets/agents/verifier/system-prompt.md.hbs +28 -0
  74. package/assets/agents/worker/PERSONA.md +8 -0
  75. package/assets/agents/worker/agent.md +18 -0
  76. package/assets/agents/worker/system-prompt.md.hbs +22 -0
  77. package/assets/agents/workflow/code-review/review-candidates.md +120 -0
  78. package/assets/agents/workflow/code-review/reviewer-system.md +75 -0
  79. package/assets/agents/workflow/goal/budget-limit.md +16 -0
  80. package/assets/agents/workflow/goal/continuation.md +62 -0
  81. package/assets/agents/workflow/goal/objective-updated.md +16 -0
  82. package/assets/agents/workflow/goal/recovery-terminal-audit.md +13 -0
  83. package/assets/agents/workflow/goal/recovery.md +11 -0
  84. package/assets/agents/workflow/goal/terminal-audit.md +10 -0
  85. package/assets/agents/workflow/plan-mode/agent-entry.md +72 -0
  86. package/assets/agents/workflow/prompt-hook/system.md +0 -0
  87. package/assets/models-dev-catalog.json.gz +0 -0
  88. package/assets/prompts/code-review/review-candidates.md +120 -0
  89. package/assets/prompts/code-review/reviewer-system.md +75 -0
  90. package/assets/skills/alran-tools-master/SKILL.md +127 -0
  91. package/assets/skills/code-review/SKILL.md +51 -0
  92. package/assets/skills/cu-desktop/SKILL.md +255 -0
  93. package/assets/skills/deep-research/SKILL.md +30 -0
  94. package/assets/skills/deploy-website/SKILL.md +52 -0
  95. package/assets/skills/docx/LICENSE +21 -0
  96. package/assets/skills/docx/SKILL.md +259 -0
  97. package/assets/skills/docx/assets/styles/academic_styles.xml +250 -0
  98. package/assets/skills/docx/assets/styles/corporate_styles.xml +284 -0
  99. package/assets/skills/docx/assets/styles/default_styles.xml +449 -0
  100. package/assets/skills/docx/assets/xsd/aesthetic-rules.xsd +470 -0
  101. package/assets/skills/docx/assets/xsd/business-rules.xsd +130 -0
  102. package/assets/skills/docx/assets/xsd/common-types.xsd +159 -0
  103. package/assets/skills/docx/assets/xsd/wml-subset.xsd +589 -0
  104. package/assets/skills/docx/docs/acceptance-checklists/create.md +7 -0
  105. package/assets/skills/docx/docs/acceptance-checklists/edit.md +6 -0
  106. package/assets/skills/docx/docs/acceptance-checklists/layout-repair.md +7 -0
  107. package/assets/skills/docx/docs/acceptance-checklists/template.md +6 -0
  108. package/assets/skills/docx/docs/acceptance.md +139 -0
  109. package/assets/skills/docx/docs/anti-patterns.md +14 -0
  110. package/assets/skills/docx/docs/backends.md +116 -0
  111. package/assets/skills/docx/docs/evidence.md +73 -0
  112. package/assets/skills/docx/docs/failure-taxonomy.md +71 -0
  113. package/assets/skills/docx/docs/index.md +50 -0
  114. package/assets/skills/docx/docs/rendered-delivery.md +125 -0
  115. package/assets/skills/docx/docs/router.md +122 -0
  116. package/assets/skills/docx/docs/tables-and-numbering.md +27 -0
  117. package/assets/skills/docx/docs/task-apply-template.md +141 -0
  118. package/assets/skills/docx/docs/task-compare-two-docx.md +48 -0
  119. package/assets/skills/docx/docs/task-create.md +124 -0
  120. package/assets/skills/docx/docs/task-edit-fill.md +69 -0
  121. package/assets/skills/docx/docs/task-read-content.md +148 -0
  122. package/assets/skills/docx/docs/task-read-rendered.md +78 -0
  123. package/assets/skills/docx/docs/task-read-structure.md +93 -0
  124. package/assets/skills/docx/docs/task-repair-layout.md +70 -0
  125. package/assets/skills/docx/docs/template-dsl.md +32 -0
  126. package/assets/skills/docx/docs/track-changes.md +15 -0
  127. package/assets/skills/docx/docs/xml-patch-dsl.md +33 -0
  128. package/assets/skills/docx/references/cjk_typography.md +357 -0
  129. package/assets/skills/docx/references/cjk_university_template_guide.md +184 -0
  130. package/assets/skills/docx/references/comments_guide.md +191 -0
  131. package/assets/skills/docx/references/design_good_bad_examples.md +829 -0
  132. package/assets/skills/docx/references/design_principles.md +819 -0
  133. package/assets/skills/docx/references/openxml_element_order.md +308 -0
  134. package/assets/skills/docx/references/openxml_encyclopedia_part1.md +4061 -0
  135. package/assets/skills/docx/references/openxml_encyclopedia_part2.md +2820 -0
  136. package/assets/skills/docx/references/openxml_encyclopedia_part3.md +3381 -0
  137. package/assets/skills/docx/references/openxml_namespaces.md +82 -0
  138. package/assets/skills/docx/references/openxml_units.md +72 -0
  139. package/assets/skills/docx/references/sample-patch-plans.json +22 -0
  140. package/assets/skills/docx/references/sample-task-intents.json +5 -0
  141. package/assets/skills/docx/references/sample-template-manifests.json +21 -0
  142. package/assets/skills/docx/references/scenario_a_create.md +284 -0
  143. package/assets/skills/docx/references/scenario_b_edit_content.md +295 -0
  144. package/assets/skills/docx/references/scenario_c_apply_template.md +456 -0
  145. package/assets/skills/docx/references/track_changes_guide.md +200 -0
  146. package/assets/skills/docx/references/troubleshooting.md +506 -0
  147. package/assets/skills/docx/references/typography_guide.md +294 -0
  148. package/assets/skills/docx/references/xsd_validation_guide.md +158 -0
  149. package/assets/skills/docx/scripts/build_patch_plan.py +29 -0
  150. package/assets/skills/docx/scripts/diff_docx_structure.py +61 -0
  151. package/assets/skills/docx/scripts/doc_to_docx.ps1 +85 -0
  152. package/assets/skills/docx/scripts/doc_to_docx.sh +40 -0
  153. package/assets/skills/docx/scripts/docx_preview.ps1 +76 -0
  154. package/assets/skills/docx/scripts/docx_preview.sh +37 -0
  155. package/assets/skills/docx/scripts/docx_to_pdf.py +87 -0
  156. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/AlranAIDocx.Cli.csproj +19 -0
  157. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/Program.cs +18 -0
  158. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/AlranAIDocx.Core.csproj +15 -0
  159. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/AnalyzeCommand.cs +147 -0
  160. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ApplyTemplateCommand.cs +322 -0
  161. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/CreateCommand.cs +324 -0
  162. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/DiffCommand.cs +155 -0
  163. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/EditContentCommand.cs +487 -0
  164. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/FixOrderCommand.cs +108 -0
  165. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/MergeRunsCommand.cs +122 -0
  166. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ValidateCommand.cs +107 -0
  167. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/CommentSynchronizer.cs +169 -0
  168. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/ElementOrder.cs +80 -0
  169. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/NamespaceConstants.cs +42 -0
  170. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/RunMerger.cs +81 -0
  171. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/StyleAnalyzer.cs +81 -0
  172. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/TrackChangesHelper.cs +99 -0
  173. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/UnitConverter.cs +23 -0
  174. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples.cs +1832 -0
  175. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch1.cs +910 -0
  176. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch2.cs +999 -0
  177. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch3.cs +1048 -0
  178. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch4.cs +1038 -0
  179. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/CharacterFormattingSamples.cs +1020 -0
  180. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/DocumentCreationSamples.cs +1121 -0
  181. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FieldAndTocSamples.cs +624 -0
  182. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FootnoteAndCommentSamples.cs +675 -0
  183. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/HeaderFooterSamples.cs +838 -0
  184. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ImageSamples.cs +917 -0
  185. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ListAndNumberingSamples.cs +826 -0
  186. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ParagraphFormattingSamples.cs +1199 -0
  187. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/StyleSystemSamples.cs +1487 -0
  188. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TableSamples.cs +1163 -0
  189. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TrackChangesSamples.cs +595 -0
  190. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/CjkHelper.cs +39 -0
  191. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/FontDefaults.cs +24 -0
  192. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/PageSizes.cs +20 -0
  193. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/BusinessRuleValidator.cs +224 -0
  194. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/GateCheckValidator.cs +148 -0
  195. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/ValidationResult.cs +23 -0
  196. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/XsdValidator.cs +69 -0
  197. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.slnx +4 -0
  198. package/assets/skills/docx/scripts/env_check.ps1 +327 -0
  199. package/assets/skills/docx/scripts/env_check.sh +340 -0
  200. package/assets/skills/docx/scripts/extract_docx_text.py +1075 -0
  201. package/assets/skills/docx/scripts/pack_docx.py +31 -0
  202. package/assets/skills/docx/scripts/read_docx_structure.py +1032 -0
  203. package/assets/skills/docx/scripts/render_docx_pages.py +147 -0
  204. package/assets/skills/docx/scripts/rendered_report.py +609 -0
  205. package/assets/skills/docx/scripts/setup.ps1 +542 -0
  206. package/assets/skills/docx/scripts/setup.sh +537 -0
  207. package/assets/skills/docx/scripts/unpack_docx.py +29 -0
  208. package/assets/skills/docx/scripts/validate_template_manifest.py +60 -0
  209. package/assets/skills/docx/scripts/verify_anchor_atomicity.py +87 -0
  210. package/assets/skills/edit-deployed-website/SKILL.md +27 -0
  211. package/assets/skills/init/SKILL.md +135 -0
  212. package/assets/skills/llm-call/SKILL.md +48 -0
  213. package/assets/skills/llm-call/scripts/llm_call.py +458 -0
  214. package/assets/skills/pdf/SKILL.md +280 -0
  215. package/assets/skills/pdf/docs/advanced-reference.md +711 -0
  216. package/assets/skills/pdf/docs/create-guide.md +437 -0
  217. package/assets/skills/pdf/docs/design-guide.md +204 -0
  218. package/assets/skills/pdf/docs/forms-guide.md +462 -0
  219. package/assets/skills/pdf/docs/html-pdf-spec.md +500 -0
  220. package/assets/skills/pdf/docs/latex-academic-thesis-guide.md +233 -0
  221. package/assets/skills/pdf/docs/latex-technical-book-guide.md +112 -0
  222. package/assets/skills/pdf/docs/pitfalls-index.md +792 -0
  223. package/assets/skills/pdf/docs/read-guide.md +358 -0
  224. package/assets/skills/pdf/docs/reformat-guide.md +238 -0
  225. package/assets/skills/pdf/docs/skill-readme-archive.md +151 -0
  226. package/assets/skills/pdf/docs/troubleshooting.md +86 -0
  227. package/assets/skills/pdf/docs/vision-guide.md +188 -0
  228. package/assets/skills/pdf/scripts/__init__.py +0 -0
  229. package/assets/skills/pdf/scripts/_pdf_read_lib.py +284 -0
  230. package/assets/skills/pdf/scripts/fill/__init__.py +0 -0
  231. package/assets/skills/pdf/scripts/fill/acroform_apply.py +153 -0
  232. package/assets/skills/pdf/scripts/fill/overlay_apply.py +109 -0
  233. package/assets/skills/pdf/scripts/lib/__init__.py +0 -0
  234. package/assets/skills/pdf/scripts/lib/acroform_io.py +170 -0
  235. package/assets/skills/pdf/scripts/lib/cli_utils.py +41 -0
  236. package/assets/skills/pdf/scripts/lib/geometry.py +79 -0
  237. package/assets/skills/pdf/scripts/make.sh +388 -0
  238. package/assets/skills/pdf/scripts/merge.py +112 -0
  239. package/assets/skills/pdf/scripts/pdf_inspect/__init__.py +0 -0
  240. package/assets/skills/pdf/scripts/pdf_inspect/acroform_inspect.py +52 -0
  241. package/assets/skills/pdf/scripts/pdf_inspect/acroform_probe.py +57 -0
  242. package/assets/skills/pdf/scripts/pdf_inspect/layout_scan.py +164 -0
  243. package/assets/skills/pdf/scripts/read_pdf_vision.py +473 -0
  244. package/assets/skills/pdf/scripts/reformat_parse.py +181 -0
  245. package/assets/skills/pdf/scripts/render/__init__.py +0 -0
  246. package/assets/skills/pdf/scripts/render/overlay_preview.py +86 -0
  247. package/assets/skills/pdf/scripts/render/page_rasterize.py +85 -0
  248. package/assets/skills/pdf/scripts/render_html.cjs +205 -0
  249. package/assets/skills/pdf/scripts/validate/__init__.py +0 -0
  250. package/assets/skills/pdf/scripts/validate/geometry_lint.py +124 -0
  251. package/assets/skills/pdf/templates/INDEX.md +90 -0
  252. package/assets/skills/pdf/templates/bilingual-menu-premium/README.md +175 -0
  253. package/assets/skills/pdf/templates/bilingual-menu-premium/skeleton.html +343 -0
  254. package/assets/skills/pdf/templates/brand-guide-2page/README.md +140 -0
  255. package/assets/skills/pdf/templates/brand-guide-2page/skeleton.html +264 -0
  256. package/assets/skills/pdf/templates/data-viz-report/README.md +234 -0
  257. package/assets/skills/pdf/templates/data-viz-report/skeleton.html +835 -0
  258. package/assets/skills/pdf/templates/form-fill-acroform/README.md +195 -0
  259. package/assets/skills/pdf/templates/form-fill-acroform/field_values.template.json +118 -0
  260. package/assets/skills/pdf/templates/latex-academic-thesis/README.md +146 -0
  261. package/assets/skills/pdf/templates/latex-academic-thesis/source.tex +334 -0
  262. package/assets/skills/pdf/templates/latex-technical-book/README.md +130 -0
  263. package/assets/skills/pdf/templates/latex-technical-book/README.template-source.md +62 -0
  264. package/assets/skills/pdf/templates/latex-technical-book/source.tex +439 -0
  265. package/assets/skills/pdf/templates/multi-article-aggregator/README.md +148 -0
  266. package/assets/skills/pdf/templates/multi-article-aggregator/pipeline.md +223 -0
  267. package/assets/skills/pdf/templates/multilang-research-report/README.md +136 -0
  268. package/assets/skills/pdf/templates/multilang-research-report/skeleton.html +242 -0
  269. package/assets/skills/pdf/templates/reformat-default/README.md +136 -0
  270. package/assets/skills/pdf/templates/reformat-default/skeleton.html +204 -0
  271. package/assets/skills/pdf/templates/translate-preserve-layout/README.md +136 -0
  272. package/assets/skills/pdf/templates/translate-preserve-layout/skeleton.html +96 -0
  273. package/assets/skills/pdf/templates/translate-preserve-layout/terminology.template.json +66 -0
  274. package/assets/skills/pptx/SKILL.md +283 -0
  275. package/assets/skills/pptx/references/design-system.md +424 -0
  276. package/assets/skills/pptx/references/editing.md +162 -0
  277. package/assets/skills/pptx/references/element-map.md +229 -0
  278. package/assets/skills/pptx/references/pitfalls.md +205 -0
  279. package/assets/skills/pptx/references/pptxgenjs.md +420 -0
  280. package/assets/skills/pptx/references/preview-selection-writeback.md +65 -0
  281. package/assets/skills/pptx/references/python-pptx-recipes.md +63 -0
  282. package/assets/skills/pptx/references/slide-types.md +413 -0
  283. package/assets/skills/pptx/scripts/alran-ppt-map.cjs +280 -0
  284. package/assets/skills/pptx/scripts/audit_pptx.py +708 -0
  285. package/assets/skills/pptx/scripts/extract_comments.py +468 -0
  286. package/assets/skills/pptx/scripts/extract_images.py +226 -0
  287. package/assets/skills/pptx/scripts/extract_pptx.py +285 -0
  288. package/assets/skills/pptx/scripts/pdf2png.swift +203 -0
  289. package/assets/skills/pptx/scripts/pptx-screenshot.sh +105 -0
  290. package/assets/skills/resume-codex/SKILL.md +53 -0
  291. package/assets/skills/resume-codex/scripts/session-reader.mjs +445 -0
  292. package/assets/skills/skill-creator/SKILL.md +188 -0
  293. package/assets/skills/skill-creator/references/anti-patterns.md +149 -0
  294. package/assets/skills/skill-creator/references/commands-macos-linux.md +38 -0
  295. package/assets/skills/skill-creator/references/commands-windows-powershell.md +48 -0
  296. package/assets/skills/skill-creator/references/description-rubric.md +83 -0
  297. package/assets/skills/skill-creator/references/skill-template.md +101 -0
  298. package/assets/skills/skill-creator/references/when-to-bundle-scripts.md +139 -0
  299. package/assets/skills/skill-creator/scripts/lint-skill.js +226 -0
  300. package/assets/skills/skill-refiner/SKILL.md +137 -0
  301. package/assets/skills/visual-page/SKILL.md +194 -0
  302. package/assets/skills/x-link-reader/SKILL.md +108 -0
  303. package/assets/skills/xlsx/SKILL.md +498 -0
  304. package/assets/skills/xlsx/docs/advanced-reference.md +410 -0
  305. package/assets/skills/xlsx/docs/conventions-guide.md +217 -0
  306. package/assets/skills/xlsx/docs/create-edit-guide.md +410 -0
  307. package/assets/skills/xlsx/docs/pitfalls-index.md +759 -0
  308. package/assets/skills/xlsx/docs/raw-xml-escape-hatch.md +201 -0
  309. package/assets/skills/xlsx/docs/recalc-guide.md +295 -0
  310. package/assets/skills/xlsx/scripts/office/helpers/__init__.py +0 -0
  311. package/assets/skills/xlsx/scripts/office/helpers/merge_runs.py +199 -0
  312. package/assets/skills/xlsx/scripts/office/helpers/simplify_redlines.py +197 -0
  313. package/assets/skills/xlsx/scripts/office/pack.py +159 -0
  314. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
  315. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
  316. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
  317. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
  318. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
  319. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
  320. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
  321. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
  322. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
  323. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
  324. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
  325. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
  326. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
  327. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
  328. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
  329. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
  330. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
  331. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
  332. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
  333. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
  334. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
  335. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
  336. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
  337. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
  338. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
  339. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
  340. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
  341. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
  342. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
  343. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
  344. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
  345. package/assets/skills/xlsx/scripts/office/schemas/mce/mc.xsd +75 -0
  346. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2010.xsd +560 -0
  347. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2012.xsd +67 -0
  348. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2018.xsd +14 -0
  349. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cex-2018.xsd +20 -0
  350. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cid-2016.xsd +13 -0
  351. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
  352. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-symex-2015.xsd +8 -0
  353. package/assets/skills/xlsx/scripts/office/soffice.py +191 -0
  354. package/assets/skills/xlsx/scripts/office/unpack.py +132 -0
  355. package/assets/skills/xlsx/scripts/office/validate.py +117 -0
  356. package/assets/skills/xlsx/scripts/office/validators/__init__.py +15 -0
  357. package/assets/skills/xlsx/scripts/office/validators/base.py +851 -0
  358. package/assets/skills/xlsx/scripts/office/validators/docx.py +446 -0
  359. package/assets/skills/xlsx/scripts/office/validators/pptx.py +275 -0
  360. package/assets/skills/xlsx/scripts/office/validators/redlining.py +247 -0
  361. package/assets/skills/xlsx/scripts/recalc.py +450 -0
  362. package/chunks/account-commands-GW7N3MYC.js +2 -0
  363. package/chunks/anthropic-63VE6MAE.js +2 -0
  364. package/chunks/application-WPPTE6LU.js +2 -0
  365. package/chunks/auth-command-36RMNQZW.js +2 -0
  366. package/chunks/azure-openai-responses-OIP3KVKJ.js +2 -0
  367. package/chunks/chunk-2AYWJZ72.js +2 -0
  368. package/chunks/chunk-2K5H5GA7.js +2 -0
  369. package/chunks/chunk-2TF6JAQM.js +2 -0
  370. package/chunks/chunk-3AODGLMF.js +2 -0
  371. package/chunks/chunk-3GGKARES.js +2 -0
  372. package/chunks/chunk-4CN3IJFH.js +2 -0
  373. package/chunks/chunk-4XP5XUIZ.js +2 -0
  374. package/chunks/chunk-5DQTVSQV.js +131 -0
  375. package/chunks/chunk-5RIMHTEU.js +207 -0
  376. package/chunks/chunk-5Y76VFHY.js +2 -0
  377. package/chunks/chunk-6DOVXX7W.js +2 -0
  378. package/chunks/chunk-6P4UKHGR.js +2 -0
  379. package/chunks/chunk-6PFI65C6.js +5 -0
  380. package/chunks/chunk-6UXSIWCB.js +2 -0
  381. package/chunks/chunk-7XYOYZX2.js +2 -0
  382. package/chunks/chunk-AGUSPIUP.js +2 -0
  383. package/chunks/chunk-BQ3CF3KE.js +2 -0
  384. package/chunks/chunk-C6LAAFG2.js +30 -0
  385. package/chunks/chunk-CUG7F2FN.js +2 -0
  386. package/chunks/chunk-D66ZSHXR.js +2 -0
  387. package/chunks/chunk-D7MGU75P.js +2 -0
  388. package/chunks/chunk-DFMYLGVU.js +249 -0
  389. package/chunks/chunk-EJN3SE5B.js +16 -0
  390. package/chunks/chunk-F46IELF5.js +2 -0
  391. package/chunks/chunk-G5MOGPZ3.js +6711 -0
  392. package/chunks/chunk-GP52JZMY.js +2 -0
  393. package/chunks/chunk-HNWBFJNO.js +2 -0
  394. package/chunks/chunk-IC6A323Q.js +2 -0
  395. package/chunks/chunk-IN2Z5SSJ.js +164 -0
  396. package/chunks/chunk-JSTSFMGK.js +70 -0
  397. package/chunks/chunk-K5DTFR6D.js +29 -0
  398. package/chunks/chunk-LCC45PCZ.js +29 -0
  399. package/chunks/chunk-LU4RPLJ3.js +2 -0
  400. package/chunks/chunk-LZJYNT32.js +2 -0
  401. package/chunks/chunk-MACBL5HF.js +2 -0
  402. package/chunks/chunk-MPQ6G7LH.js +1085 -0
  403. package/chunks/chunk-MUXNNOSQ.js +3 -0
  404. package/chunks/chunk-N5NTXCJI.js +2 -0
  405. package/chunks/chunk-N6W7ZL26.js +2 -0
  406. package/chunks/chunk-NBONSNQZ.js +38 -0
  407. package/chunks/chunk-NMKRNU5O.js +2 -0
  408. package/chunks/chunk-NVPGGFT3.js +2 -0
  409. package/chunks/chunk-NZXJAHTO.js +9 -0
  410. package/chunks/chunk-OTDNOWXG.js +16 -0
  411. package/chunks/chunk-PCL2CVVE.js +2 -0
  412. package/chunks/chunk-PXH4SBCS.js +3 -0
  413. package/chunks/chunk-QKBN5CGI.js +2 -0
  414. package/chunks/chunk-QPGTKSIQ.js +2 -0
  415. package/chunks/chunk-R44C5DM6.js +2 -0
  416. package/chunks/chunk-RLJVY75P.js +28 -0
  417. package/chunks/chunk-RLND4AYL.js +4 -0
  418. package/chunks/chunk-SIOLUFGG.js +2 -0
  419. package/chunks/chunk-TJC4LPRQ.js +2 -0
  420. package/chunks/chunk-U3RMPDXU.js +2 -0
  421. package/chunks/chunk-U4PFHJ7Z.js +27 -0
  422. package/chunks/chunk-UJCAE7SG.js +3 -0
  423. package/chunks/chunk-V2SB4U4D.js +2 -0
  424. package/chunks/chunk-VGKKKM2W.js +6 -0
  425. package/chunks/chunk-VLXX22YO.js +2 -0
  426. package/chunks/chunk-VUISZDXX.js +24 -0
  427. package/chunks/chunk-W5ZOLW7T.js +2 -0
  428. package/chunks/chunk-WHD2XVT2.js +2 -0
  429. package/chunks/chunk-XLVABFJC.js +9 -0
  430. package/chunks/chunk-XQK7JM66.js +2 -0
  431. package/chunks/chunk-XSEU4WQD.js +7 -0
  432. package/chunks/chunk-XVGPB7TW.js +21 -0
  433. package/chunks/chunk-Z5HOCNTZ.js +2 -0
  434. package/chunks/chunk-ZDI22NOK.js +7 -0
  435. package/chunks/chunk-ZQKVUPKA.js +2 -0
  436. package/chunks/clipboard-image-PQPC4EHR.js +2 -0
  437. package/chunks/data-dir-OEPRRIOO.js +2 -0
  438. package/chunks/dist-VKYZJYR6.js +11 -0
  439. package/chunks/dist-WGTMUM3E.js +5 -0
  440. package/chunks/emscripten-module-3WGSFZYF.js +2 -0
  441. package/chunks/emscripten-module-74WUXTHL.js +2 -0
  442. package/chunks/emscripten-module-MCN4Y3N4.js +2 -0
  443. package/chunks/emscripten-module-NEAT5LGD.js +2 -0
  444. package/chunks/ffi-EFLUAAVX.js +2 -0
  445. package/chunks/ffi-JIGPPPF7.js +2 -0
  446. package/chunks/ffi-QKKA5HYI.js +2 -0
  447. package/chunks/ffi-RLX77WFG.js +2 -0
  448. package/chunks/google-RCR46TTQ.js +2 -0
  449. package/chunks/google-vertex-Y26T7YYR.js +2 -0
  450. package/chunks/install-source-63OVVBMK.js +2 -0
  451. package/chunks/launcher-2UG3JPYF.js +63 -0
  452. package/chunks/lifecycle-5IPJRP2V.js +2 -0
  453. package/chunks/main-7SGOQBHZ.js +13 -0
  454. package/chunks/mistral-NEBDKUEI.js +3 -0
  455. package/chunks/module-6F3E5H7Y-FIMLNSCK.js +2 -0
  456. package/chunks/module-asyncify-R6PWJ6ZV-Q2HJ3NOC.js +2 -0
  457. package/chunks/multipart-parser-JVSLI2CL.js +2 -0
  458. package/chunks/network-proxy-AJO7ZW3O.js +2 -0
  459. package/chunks/openai-codex-responses-L2CIGCKO.js +2 -0
  460. package/chunks/openai-completions-C4PHW6MD.js +2 -0
  461. package/chunks/openai-responses-5NVFOW4Y.js +2 -0
  462. package/chunks/openrouter-BKUGQT7Z.js +2 -0
  463. package/chunks/otel-DRJM2PIX.js +2 -0
  464. package/chunks/package-contract-GVXTMJ3N.js +2 -0
  465. package/chunks/pdfjs-2UOWBGC2.js +107 -0
  466. package/chunks/photon_rs-MVWYTYTO.js +3 -0
  467. package/chunks/plugin-command-CIDTOPNB.js +2 -0
  468. package/chunks/provider-command-UZ7KQFAC.js +2 -0
  469. package/chunks/questionnaire-bridge-ISQOCYWY.js +2 -0
  470. package/chunks/run-acp-command-AKDLHKMR.js +59 -0
  471. package/chunks/run-exec-command-UXTPS7LC.js +15 -0
  472. package/chunks/skills-command-57TF53NO.js +2 -0
  473. package/chunks/src-5PSNGHHD.js +2 -0
  474. package/chunks/src-YZ26EVSY.js +2 -0
  475. package/chunks/telemetry-3NXMCOVD.js +2 -0
  476. package/chunks/telemetry-command-CMDERYNN.js +5 -0
  477. package/chunks/tools-CRJR35HS.js +2 -0
  478. package/chunks/undici-O4OQVZ6I.js +2 -0
  479. package/chunks/update-ACFAGV6F.js +14 -0
  480. package/chunks/update-hint-ED7O67WU.js +3 -0
  481. package/chunks/wechat-onboard-UWXQW2HT.js +2 -0
  482. package/cli.js +4 -0
  483. package/configs/data-minimal.yaml +50 -0
  484. package/embedded/alran-tools/cli.mjs +4957 -0
  485. package/embedded/alran-tools/manifest.json +25 -0
  486. package/emscripten-module.wasm +0 -0
  487. package/image-preview-worker.js +2 -0
  488. package/internal-bin/alran-tools +9 -0
  489. package/internal-bin/alran-tools.cmd +8 -0
  490. package/matrix-mcp-stdio.js +4 -0
  491. package/native/darwin/prebuilds/darwin-arm64/darwin-modifiers.node +0 -0
  492. package/native/darwin/prebuilds/darwin-x64/darwin-modifiers.node +0 -0
  493. package/native/win32/prebuilds/win32-arm64/win32-console-mode.node +0 -0
  494. package/native/win32/prebuilds/win32-x64/win32-console-mode.node +0 -0
  495. package/package.json +38 -4
  496. package/photon_rs_bg.wasm +0 -0
  497. package/quickjs-worker.js +152 -0
  498. package/vendor/java-proxy-agent/build.ts +97 -0
  499. package/vendor/java-proxy-agent/srt-proxy-agent.jar +0 -0
  500. package/vendor/seccomp/arm64/apply-seccomp +0 -0
  501. package/vendor/seccomp/build.ts +74 -0
  502. package/vendor/seccomp/x64/apply-seccomp +0 -0
  503. package/vendor/srt-win/arm64/srt-win.exe +0 -0
  504. package/vendor/srt-win/build.ts +40 -0
  505. package/vendor/srt-win/x64/srt-win.exe +0 -0
@@ -0,0 +1,108 @@
1
+ using System.CommandLine;
2
+ using System.IO.Compression;
3
+ using System.Xml.Linq;
4
+
5
+ namespace AlranAIDocx.Core.Commands;
6
+
7
+ public static class FixOrderCommand
8
+ {
9
+ private static readonly XNamespace W = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
10
+
11
+ // Canonical element ordering within common parent elements per ISO 29500
12
+ private static readonly Dictionary<string, List<string>> ElementOrder = new()
13
+ {
14
+ ["pPr"] = new() { "pStyle", "keepNext", "keepLines", "pageBreakBefore", "widowControl", "numPr", "suppressLineNumbers", "pBdr", "shd", "tabs", "suppressAutoHyphens", "spacing", "ind", "jc", "outlineLvl", "rPr" },
15
+ ["rPr"] = new() { "rStyle", "rFonts", "b", "bCs", "i", "iCs", "caps", "smallCaps", "strike", "dstrike", "vanish", "color", "spacing", "w", "kern", "position", "sz", "szCs", "highlight", "u", "effect", "vertAlign", "lang" },
16
+ ["tblPr"] = new() { "tblStyle", "tblpPr", "tblOverlap", "tblW", "jc", "tblInd", "tblBorders", "shd", "tblLayout", "tblCellMar", "tblLook" },
17
+ ["tcPr"] = new() { "cnfStyle", "tcW", "gridSpan", "hMerge", "vMerge", "tcBorders", "shd", "noWrap", "tcMar", "textDirection", "tcFitText", "vAlign" },
18
+ ["sectPr"] = new() { "headerReference", "footerReference", "footnotePr", "endnotePr", "type", "pgSz", "pgMar", "paperSrc", "pgBorders", "lnNumType", "pgNumType", "cols", "docGrid" },
19
+ };
20
+
21
+ public static Command Create()
22
+ {
23
+ var inputOption = new Option<string>("--input") { Description = "DOCX file to fix", Required = true };
24
+ var outputOption = new Option<string>("--output") { Description = "Output path (default: overwrite input)" };
25
+ var backupOption = new Option<bool>("--backup") { Description = "Create .bak before modifying", DefaultValueFactory = (_) => true };
26
+
27
+ var cmd = new Command("fix-order", "Fix OpenXML element ordering per ISO 29500")
28
+ {
29
+ inputOption, outputOption, backupOption
30
+ };
31
+
32
+ cmd.SetAction((parseResult) =>
33
+ {
34
+ var input = parseResult.GetValue(inputOption)!;
35
+ var output = parseResult.GetValue(outputOption) ?? input;
36
+ var backup = parseResult.GetValue(backupOption);
37
+
38
+ if (!File.Exists(input))
39
+ {
40
+ Console.Error.WriteLine($"File not found: {input}");
41
+ return;
42
+ }
43
+
44
+ if (backup && output == input)
45
+ File.Copy(input, input + ".bak", true);
46
+
47
+ var tempPath = Path.GetTempFileName();
48
+ File.Copy(input, tempPath, true);
49
+
50
+ using var zip = ZipFile.Open(tempPath, ZipArchiveMode.Update);
51
+ var entry = zip.GetEntry("word/document.xml");
52
+ if (entry == null)
53
+ {
54
+ Console.Error.WriteLine("Not a valid DOCX");
55
+ return;
56
+ }
57
+
58
+ XDocument doc;
59
+ using (var stream = entry.Open())
60
+ doc = XDocument.Load(stream);
61
+
62
+ int reorderedCount = 0;
63
+
64
+ foreach (var (parentName, order) in ElementOrder)
65
+ {
66
+ foreach (var parent in doc.Descendants(W + parentName))
67
+ {
68
+ var children = parent.Elements().ToList();
69
+ var sorted = children.OrderBy(e =>
70
+ {
71
+ var idx = order.IndexOf(e.Name.LocalName);
72
+ return idx >= 0 ? idx : order.Count;
73
+ }).ToList();
74
+
75
+ bool changed = false;
76
+ for (int i = 0; i < children.Count; i++)
77
+ {
78
+ if (children[i] != sorted[i])
79
+ {
80
+ changed = true;
81
+ break;
82
+ }
83
+ }
84
+
85
+ if (changed)
86
+ {
87
+ parent.ReplaceNodes(sorted);
88
+ reorderedCount++;
89
+ }
90
+ }
91
+ }
92
+
93
+ entry.Delete();
94
+ var newEntry = zip.CreateEntry("word/document.xml", CompressionLevel.Optimal);
95
+ using (var stream = newEntry.Open())
96
+ doc.Save(stream);
97
+
98
+ zip.Dispose();
99
+ File.Copy(tempPath, output, true);
100
+ File.Delete(tempPath);
101
+
102
+ Console.WriteLine($"Reordered {reorderedCount} element group(s)");
103
+ Console.WriteLine($"Written to: {output}");
104
+ });
105
+
106
+ return cmd;
107
+ }
108
+ }
@@ -0,0 +1,122 @@
1
+ using System.CommandLine;
2
+ using System.IO.Compression;
3
+ using System.Xml.Linq;
4
+
5
+ namespace AlranAIDocx.Core.Commands;
6
+
7
+ public static class MergeRunsCommand
8
+ {
9
+ private static readonly XNamespace W = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
10
+
11
+ public static Command Create()
12
+ {
13
+ var inputOption = new Option<string>("--input") { Description = "DOCX file to optimize", Required = true };
14
+ var outputOption = new Option<string>("--output") { Description = "Output path (default: overwrite input)" };
15
+ var dryRunOption = new Option<bool>("--dry-run") { Description = "Report without modifying" };
16
+
17
+ var cmd = new Command("merge-runs", "Merge adjacent runs with identical formatting")
18
+ {
19
+ inputOption, outputOption, dryRunOption
20
+ };
21
+
22
+ cmd.SetAction((parseResult) =>
23
+ {
24
+ var input = parseResult.GetValue(inputOption)!;
25
+ var output = parseResult.GetValue(outputOption) ?? input;
26
+ var dryRun = parseResult.GetValue(dryRunOption);
27
+
28
+ if (!File.Exists(input))
29
+ {
30
+ Console.Error.WriteLine($"File not found: {input}");
31
+ return;
32
+ }
33
+
34
+ var tempPath = Path.GetTempFileName();
35
+ File.Copy(input, tempPath, true);
36
+
37
+ using var zip = ZipFile.Open(tempPath, ZipArchiveMode.Update);
38
+ var entry = zip.GetEntry("word/document.xml");
39
+ if (entry == null)
40
+ {
41
+ Console.Error.WriteLine("Not a valid DOCX: missing word/document.xml");
42
+ return;
43
+ }
44
+
45
+ XDocument doc;
46
+ using (var stream = entry.Open())
47
+ doc = XDocument.Load(stream);
48
+
49
+ int originalCount = 0;
50
+ int mergedCount = 0;
51
+
52
+ foreach (var p in doc.Descendants(W + "p"))
53
+ {
54
+ var runs = p.Elements(W + "r").ToList();
55
+ originalCount += runs.Count;
56
+
57
+ for (int i = runs.Count - 1; i > 0; i--)
58
+ {
59
+ var current = runs[i];
60
+ var previous = runs[i - 1];
61
+
62
+ var curProps = current.Element(W + "rPr")?.ToString() ?? "";
63
+ var prevProps = previous.Element(W + "rPr")?.ToString() ?? "";
64
+
65
+ if (curProps == prevProps)
66
+ {
67
+ // Only merge if both contain only text elements
68
+ var curChildren = current.Elements().Where(e => e.Name != W + "rPr").ToList();
69
+ var prevChildren = previous.Elements().Where(e => e.Name != W + "rPr").ToList();
70
+
71
+ if (curChildren.All(e => e.Name == W + "t") && prevChildren.All(e => e.Name == W + "t"))
72
+ {
73
+ var prevText = previous.Elements(W + "t").LastOrDefault();
74
+ var curText = current.Elements(W + "t").FirstOrDefault();
75
+
76
+ if (prevText != null && curText != null)
77
+ {
78
+ prevText.Value += curText.Value;
79
+ prevText.SetAttributeValue(XNamespace.Xml + "space", "preserve");
80
+
81
+ foreach (var extra in current.Elements(W + "t").Skip(1))
82
+ {
83
+ previous.Add(new XElement(extra));
84
+ }
85
+
86
+ current.Remove();
87
+ runs.RemoveAt(i);
88
+ }
89
+ }
90
+ }
91
+ }
92
+
93
+ mergedCount += runs.Count;
94
+ }
95
+
96
+ if (dryRun)
97
+ {
98
+ Console.WriteLine($"Original runs: {originalCount}");
99
+ Console.WriteLine($"After merge: {mergedCount}");
100
+ Console.WriteLine($"Reduction: {(originalCount > 0 ? (originalCount - mergedCount) * 100.0 / originalCount : 0):F1}%");
101
+ File.Delete(tempPath);
102
+ return;
103
+ }
104
+
105
+ entry.Delete();
106
+ var newEntry = zip.CreateEntry("word/document.xml", CompressionLevel.Optimal);
107
+ using (var stream = newEntry.Open())
108
+ doc.Save(stream);
109
+
110
+ zip.Dispose();
111
+ File.Copy(tempPath, output, true);
112
+ File.Delete(tempPath);
113
+
114
+ Console.WriteLine($"Original runs: {originalCount}");
115
+ Console.WriteLine($"After merge: {mergedCount}");
116
+ Console.WriteLine($"Reduction: {(originalCount > 0 ? (originalCount - mergedCount) * 100.0 / originalCount : 0):F1}%");
117
+ Console.WriteLine($"Written to: {output}");
118
+ });
119
+
120
+ return cmd;
121
+ }
122
+ }
@@ -0,0 +1,107 @@
1
+ using System.CommandLine;
2
+ using System.Text.Json;
3
+ using AlranAIDocx.Core.Validation;
4
+
5
+ namespace AlranAIDocx.Core.Commands;
6
+
7
+ public static class ValidateCommand
8
+ {
9
+ public static Command Create()
10
+ {
11
+ var inputOption = new Option<string>("--input") { Description = "DOCX file to validate", Required = true };
12
+ var xsdOption = new Option<string>("--xsd") { Description = "XSD schema path for XML validation" };
13
+ var businessOption = new Option<bool>("--business") { Description = "Run business rule validation" };
14
+ var gateCheckOption = new Option<string>("--gate-check") { Description = "Template DOCX for gate-check validation" };
15
+ var jsonOption = new Option<bool>("--json") { Description = "Output results as JSON" };
16
+
17
+ var cmd = new Command("validate", "Validate DOCX structure and content")
18
+ {
19
+ inputOption, xsdOption, businessOption, gateCheckOption, jsonOption
20
+ };
21
+
22
+ cmd.SetAction((parseResult) =>
23
+ {
24
+ var input = parseResult.GetValue(inputOption)!;
25
+ var xsd = parseResult.GetValue(xsdOption);
26
+ var business = parseResult.GetValue(businessOption);
27
+ var gateCheck = parseResult.GetValue(gateCheckOption);
28
+ var asJson = parseResult.GetValue(jsonOption);
29
+
30
+ if (!File.Exists(input))
31
+ {
32
+ Console.Error.WriteLine($"File not found: {input}");
33
+ return;
34
+ }
35
+
36
+ var combinedResult = new ValidationResult();
37
+ GateCheckResult? gateResult = null;
38
+
39
+ if (xsd != null)
40
+ {
41
+ var xsdValidator = new XsdValidator();
42
+ combinedResult.Merge(xsdValidator.Validate(input, xsd));
43
+ }
44
+
45
+ if (business)
46
+ {
47
+ var bizValidator = new BusinessRuleValidator();
48
+ combinedResult.Merge(bizValidator.Validate(input));
49
+ }
50
+
51
+ if (gateCheck != null)
52
+ {
53
+ var gateValidator = new GateCheckValidator();
54
+ gateResult = gateValidator.Validate(input, gateCheck);
55
+ }
56
+
57
+ if (asJson)
58
+ {
59
+ var output = new
60
+ {
61
+ isValid = combinedResult.IsValid && (gateResult?.Passed ?? true),
62
+ errors = combinedResult.Errors,
63
+ warnings = combinedResult.Warnings,
64
+ gateCheck = gateResult == null ? null : new
65
+ {
66
+ passed = gateResult.Passed,
67
+ violations = gateResult.Violations
68
+ }
69
+ };
70
+ Console.WriteLine(JsonSerializer.Serialize(output, new JsonSerializerOptions { WriteIndented = true }));
71
+ }
72
+ else
73
+ {
74
+ if (combinedResult.Errors.Count > 0)
75
+ {
76
+ Console.WriteLine($"ERRORS ({combinedResult.Errors.Count}):");
77
+ foreach (var e in combinedResult.Errors)
78
+ Console.WriteLine($" [{e.Severity}] {e.Message}" + (e.LineNumber > 0 ? $" (line {e.LineNumber}:{e.LinePosition})" : ""));
79
+ }
80
+
81
+ if (combinedResult.Warnings.Count > 0)
82
+ {
83
+ Console.WriteLine($"WARNINGS ({combinedResult.Warnings.Count}):");
84
+ foreach (var w in combinedResult.Warnings)
85
+ Console.WriteLine($" [{w.Severity}] {w.Message}");
86
+ }
87
+
88
+ if (gateResult != null)
89
+ {
90
+ Console.WriteLine(gateResult.Passed ? "GATE CHECK: PASSED" : "GATE CHECK: FAILED");
91
+ foreach (var v in gateResult.Violations)
92
+ Console.WriteLine($" - {v}");
93
+ }
94
+
95
+ if (combinedResult.IsValid && (gateResult?.Passed ?? true))
96
+ Console.WriteLine("Validation: PASSED");
97
+ else
98
+ Console.WriteLine("Validation: FAILED");
99
+ }
100
+
101
+ if (!combinedResult.IsValid || gateResult is { Passed: false })
102
+ Environment.ExitCode = 1;
103
+ });
104
+
105
+ return cmd;
106
+ }
107
+ }
@@ -0,0 +1,169 @@
1
+ using DocumentFormat.OpenXml;
2
+ using DocumentFormat.OpenXml.Packaging;
3
+ using DocumentFormat.OpenXml.Wordprocessing;
4
+
5
+ namespace AlranAIDocx.Core.OpenXml;
6
+
7
+ /// <summary>
8
+ /// Manages the 4-file comment system (comments.xml, commentsExtended.xml,
9
+ /// commentsIds.xml, commentsExtensible.xml) plus document.xml markers.
10
+ /// </summary>
11
+ public static class CommentSynchronizer
12
+ {
13
+ /// <summary>
14
+ /// Adds a comment to the document, updating all required parts.
15
+ /// </summary>
16
+ public static int AddComment(WordprocessingDocument doc, string text, string author, string rangeBookmark)
17
+ {
18
+ var mainPart = doc.MainDocumentPart
19
+ ?? throw new InvalidOperationException("Document has no main part.");
20
+
21
+ int commentId = GetNextCommentId(doc);
22
+
23
+ // Ensure comments part exists
24
+ var commentsPart = mainPart.WordprocessingCommentsPart
25
+ ?? mainPart.AddNewPart<WordprocessingCommentsPart>();
26
+
27
+ if (commentsPart.Comments == null)
28
+ commentsPart.Comments = new Comments();
29
+
30
+ // Create the comment
31
+ var comment = new Comment
32
+ {
33
+ Id = commentId.ToString(),
34
+ Author = author,
35
+ Date = DateTime.UtcNow,
36
+ Initials = author.Length > 0 ? author[..1].ToUpperInvariant() : "A"
37
+ };
38
+ comment.Append(new Paragraph(new Run(new Text(text))));
39
+ commentsPart.Comments.Append(comment);
40
+
41
+ // Add range markers in document body
42
+ var body = mainPart.Document.Body;
43
+ if (body != null)
44
+ {
45
+ // Find bookmark or append at end
46
+ var rangeStart = new CommentRangeStart { Id = commentId.ToString() };
47
+ var rangeEnd = new CommentRangeEnd { Id = commentId.ToString() };
48
+ var reference = new Run(new CommentReference { Id = commentId.ToString() });
49
+
50
+ body.Append(rangeStart);
51
+ body.Append(rangeEnd);
52
+ body.Append(new Paragraph(reference));
53
+ }
54
+
55
+ return commentId;
56
+ }
57
+
58
+ /// <summary>
59
+ /// Adds a reply to an existing comment.
60
+ /// </summary>
61
+ public static int AddReply(WordprocessingDocument doc, int parentCommentId, string text, string author)
62
+ {
63
+ var mainPart = doc.MainDocumentPart
64
+ ?? throw new InvalidOperationException("Document has no main part.");
65
+
66
+ var commentsPart = mainPart.WordprocessingCommentsPart
67
+ ?? throw new InvalidOperationException("Document has no comments part.");
68
+
69
+ int replyId = GetNextCommentId(doc);
70
+
71
+ var reply = new Comment
72
+ {
73
+ Id = replyId.ToString(),
74
+ Author = author,
75
+ Date = DateTime.UtcNow,
76
+ Initials = author.Length > 0 ? author[..1].ToUpperInvariant() : "A"
77
+ };
78
+ reply.Append(new Paragraph(new Run(new Text(text))));
79
+ commentsPart.Comments?.Append(reply);
80
+
81
+ // Link reply to parent via commentsExtended.xml
82
+ LinkReplyToParent(doc, replyId, parentCommentId);
83
+
84
+ return replyId;
85
+ }
86
+
87
+ /// <summary>
88
+ /// Marks a comment as resolved/done by setting done="1" in commentsExtended.xml.
89
+ /// Uses raw XML manipulation since these extended parts lack typed SDK support.
90
+ /// </summary>
91
+ public static void ResolveComment(WordprocessingDocument doc, int commentId)
92
+ {
93
+ var mainPart = doc.MainDocumentPart;
94
+ if (mainPart == null) return;
95
+
96
+ // commentsExtended.xml is an untyped part — manipulate via raw XML
97
+ const string ceUri = "http://schemas.microsoft.com/office/word/2018/wordml/cex";
98
+ foreach (var part in mainPart.Parts)
99
+ {
100
+ if (part.OpenXmlPart.ContentType.Contains("commentsExtensible"))
101
+ {
102
+ using var stream = part.OpenXmlPart.GetStream(FileMode.Open, FileAccess.ReadWrite);
103
+ var xdoc = System.Xml.Linq.XDocument.Load(stream);
104
+ var ns = System.Xml.Linq.XNamespace.Get(ceUri);
105
+ var commentEl = xdoc.Descendants(ns + "comment")
106
+ .FirstOrDefault(e => e.Attribute(ns + "paraId")?.Value != null);
107
+ // Set done flag if element found for this comment
108
+ if (commentEl != null)
109
+ {
110
+ commentEl.SetAttributeValue("done", "1");
111
+ stream.SetLength(0);
112
+ xdoc.Save(stream);
113
+ }
114
+ return;
115
+ }
116
+ }
117
+ }
118
+
119
+ /// <summary>
120
+ /// Links a reply comment to its parent via commentsExtended.xml (w15:commentEx).
121
+ /// Uses raw XML since the extended comment parts lack typed SDK support.
122
+ /// </summary>
123
+ private static void LinkReplyToParent(WordprocessingDocument doc, int replyId, int parentCommentId)
124
+ {
125
+ var mainPart = doc.MainDocumentPart;
126
+ if (mainPart == null) return;
127
+
128
+ const string w15Uri = "http://schemas.microsoft.com/office/word/2012/wordml";
129
+ var w15 = System.Xml.Linq.XNamespace.Get(w15Uri);
130
+
131
+ // Find or create commentsExtended part
132
+ foreach (var part in mainPart.Parts)
133
+ {
134
+ if (part.OpenXmlPart.ContentType.Contains("commentsExtended"))
135
+ {
136
+ using var stream = part.OpenXmlPart.GetStream(FileMode.Open, FileAccess.ReadWrite);
137
+ var xdoc = System.Xml.Linq.XDocument.Load(stream);
138
+ var root = xdoc.Root;
139
+ if (root == null) return;
140
+
141
+ root.Add(new System.Xml.Linq.XElement(w15 + "commentEx",
142
+ new System.Xml.Linq.XAttribute(w15 + "paraId", replyId.ToString("X8")),
143
+ new System.Xml.Linq.XAttribute(w15 + "paraIdParent", parentCommentId.ToString("X8")),
144
+ new System.Xml.Linq.XAttribute(w15 + "done", "0")));
145
+
146
+ stream.SetLength(0);
147
+ xdoc.Save(stream);
148
+ return;
149
+ }
150
+ }
151
+ }
152
+
153
+ /// <summary>
154
+ /// Finds the maximum existing comment ID and returns the next one.
155
+ /// </summary>
156
+ public static int GetNextCommentId(WordprocessingDocument doc)
157
+ {
158
+ var commentsPart = doc.MainDocumentPart?.WordprocessingCommentsPart;
159
+ if (commentsPart?.Comments == null) return 1;
160
+
161
+ int maxId = 0;
162
+ foreach (var comment in commentsPart.Comments.Elements<Comment>())
163
+ {
164
+ if (comment.Id?.Value != null && int.TryParse(comment.Id.Value, out int id) && id > maxId)
165
+ maxId = id;
166
+ }
167
+ return maxId + 1;
168
+ }
169
+ }
@@ -0,0 +1,80 @@
1
+ using System.Xml.Linq;
2
+
3
+ namespace AlranAIDocx.Core.OpenXml;
4
+
5
+ /// <summary>
6
+ /// Defines canonical child element ordering for key OpenXML parent elements
7
+ /// and provides reordering utilities.
8
+ /// </summary>
9
+ public static class ElementOrder
10
+ {
11
+ private static readonly Dictionary<string, string[]> OrderMap = new()
12
+ {
13
+ ["w:body"] = ["w:p", "w:tbl", "w:sdt", "w:sectPr"],
14
+ ["w:p"] = ["w:pPr", "w:hyperlink", "w:r", "w:ins", "w:del", "w:bookmarkStart", "w:bookmarkEnd", "w:commentRangeStart", "w:commentRangeEnd", "w:fldSimple"],
15
+ ["w:pPr"] = ["w:pStyle", "w:keepNext", "w:keepLines", "w:pageBreakBefore", "w:widowControl", "w:numPr", "w:pBdr", "w:shd", "w:tabs", "w:suppressAutoHyphens", "w:spacing", "w:ind", "w:jc", "w:rPr", "w:sectPr", "w:pPrChange"],
16
+ ["w:r"] = ["w:rPr", "w:t", "w:br", "w:tab", "w:cr", "w:sym", "w:drawing", "w:delText", "w:fldChar", "w:instrText", "w:lastRenderedPageBreak", "w:noBreakHyphen", "w:softHyphen"],
17
+ ["w:rPr"] = ["w:rStyle", "w:rFonts", "w:b", "w:bCs", "w:i", "w:iCs", "w:caps", "w:smallCaps", "w:strike", "w:dstrike", "w:vanish", "w:color", "w:sz", "w:szCs", "w:u", "w:shd", "w:highlight", "w:lang", "w:rPrChange"],
18
+ ["w:tbl"] = ["w:tblPr", "w:tblGrid", "w:tr"],
19
+ ["w:tblPr"] = ["w:tblStyle", "w:tblpPr", "w:tblOverlap", "w:tblW", "w:jc", "w:tblCellSpacing", "w:tblInd", "w:tblBorders", "w:shd", "w:tblLayout", "w:tblCellMar", "w:tblLook", "w:tblPrChange"],
20
+ ["w:tr"] = ["w:trPr", "w:tc"],
21
+ ["w:trPr"] = ["w:cnfStyle", "w:divId", "w:gridBefore", "w:gridAfter", "w:wBefore", "w:wAfter", "w:cantSplit", "w:trHeight", "w:tblHeader", "w:tblCellSpacing", "w:jc", "w:hidden", "w:ins", "w:del", "w:trPrChange"],
22
+ ["w:tc"] = ["w:tcPr", "w:p", "w:tbl"],
23
+ ["w:tcPr"] = ["w:cnfStyle", "w:tcW", "w:gridSpan", "w:hMerge", "w:vMerge", "w:tcBorders", "w:shd", "w:noWrap", "w:tcMar", "w:textDirection", "w:tcFitText", "w:vAlign", "w:hideMark", "w:headers", "w:cellIns", "w:cellDel", "w:cellMerge", "w:tcPrChange"],
24
+ ["w:sectPr"] = ["w:headerReference", "w:footerReference", "w:type", "w:pgSz", "w:pgMar", "w:paperSrc", "w:pgBorders", "w:lnNumType", "w:pgNumType", "w:cols", "w:formProt", "w:vAlign", "w:noEndnote", "w:titlePg", "w:textDirection", "w:bidi", "w:rtlGutter", "w:docGrid"],
25
+ ["w:hdr"] = ["w:p", "w:tbl", "w:sdt"],
26
+ ["w:ftr"] = ["w:p", "w:tbl", "w:sdt"],
27
+ };
28
+
29
+ /// <summary>
30
+ /// Returns the canonical child ordering for a given parent element name (e.g. "w:p").
31
+ /// Returns null if no ordering is defined.
32
+ /// </summary>
33
+ public static string[]? GetChildOrder(string parentElement)
34
+ {
35
+ return OrderMap.TryGetValue(parentElement, out var order) ? order : null;
36
+ }
37
+
38
+ /// <summary>
39
+ /// Reorders children of the given XElement according to the canonical ordering rules.
40
+ /// Children not listed in the ordering are placed at the end in their original order.
41
+ /// </summary>
42
+ public static void ReorderChildren(XElement parent)
43
+ {
44
+ var qualifiedName = GetQualifiedName(parent);
45
+ var order = GetChildOrder(qualifiedName);
46
+ if (order == null) return;
47
+
48
+ var children = parent.Elements().ToList();
49
+ if (children.Count <= 1) return;
50
+
51
+ var orderIndex = new Dictionary<string, int>();
52
+ for (int i = 0; i < order.Length; i++)
53
+ orderIndex[order[i]] = i;
54
+
55
+ int unknownBase = order.Length;
56
+ int unknownCounter = 0;
57
+
58
+ var sorted = children
59
+ .Select(c => (Element: c, QName: GetQualifiedName(c)))
60
+ .OrderBy(x => orderIndex.TryGetValue(x.QName, out var idx) ? idx : unknownBase + unknownCounter++)
61
+ .Select(x => x.Element)
62
+ .ToList();
63
+
64
+ parent.RemoveNodes();
65
+ foreach (var child in sorted)
66
+ parent.Add(child);
67
+ }
68
+
69
+ private static string GetQualifiedName(XElement element)
70
+ {
71
+ var ns = element.Name.Namespace;
72
+ var local = element.Name.LocalName;
73
+
74
+ if (ns == Ns.W) return $"w:{local}";
75
+ if (ns == Ns.R) return $"r:{local}";
76
+ if (ns == Ns.MC) return $"mc:{local}";
77
+
78
+ return local;
79
+ }
80
+ }
@@ -0,0 +1,42 @@
1
+ using System.Xml.Linq;
2
+
3
+ namespace AlranAIDocx.Core.OpenXml;
4
+
5
+ /// <summary>
6
+ /// All OpenXML namespace URIs and common content/relationship type constants.
7
+ /// </summary>
8
+ public static class Ns
9
+ {
10
+ public static readonly XNamespace W = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
11
+ public static readonly XNamespace R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
12
+ public static readonly XNamespace WP = "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing";
13
+ public static readonly XNamespace A = "http://schemas.openxmlformats.org/drawingml/2006/main";
14
+ public static readonly XNamespace MC = "http://schemas.openxmlformats.org/markup-compatibility/2006";
15
+ public static readonly XNamespace PIC = "http://schemas.openxmlformats.org/drawingml/2006/picture";
16
+ public static readonly XNamespace W14 = "http://schemas.microsoft.com/office/word/2010/wordml";
17
+ public static readonly XNamespace W15 = "http://schemas.microsoft.com/office/word/2012/wordml";
18
+ public static readonly XNamespace W16CID = "http://schemas.microsoft.com/office/word/2016/wordml/cid";
19
+ public static readonly XNamespace W16CEX = "http://schemas.microsoft.com/office/word/2018/wordml/cex";
20
+ public static readonly XNamespace WPC = "http://schemas.microsoft.com/office/word/2010/wordprocessingCanvas";
21
+ public static readonly XNamespace WPS = "http://schemas.microsoft.com/office/word/2010/wordprocessingShape";
22
+
23
+ // Content types
24
+ public const string MainDocumentContentType = "application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml";
25
+ public const string StylesContentType = "application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml";
26
+ public const string HeaderContentType = "application/vnd.openxmlformats-officedocument.wordprocessingml.header+xml";
27
+ public const string FooterContentType = "application/vnd.openxmlformats-officedocument.wordprocessingml.footer+xml";
28
+ public const string CommentsContentType = "application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml";
29
+
30
+ // Relationship types
31
+ public const string DocumentRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument";
32
+ public const string StylesRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles";
33
+ public const string HeaderRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/header";
34
+ public const string FooterRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer";
35
+ public const string CommentsRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments";
36
+ public const string ImageRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image";
37
+ public const string HyperlinkRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
38
+ public const string NumberingRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/numbering";
39
+ public const string FontTableRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/fontTable";
40
+ public const string ThemeRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme";
41
+ public const string SettingsRelationshipType = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/settings";
42
+ }