alran 0.0.0-stage → 0.9.0

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 (506) hide show
  1. package/ALRAN_TOOLS_NOTICES.md +64 -0
  2. package/LICENSE +27 -0
  3. package/LICENSE-STATUS.md +21 -0
  4. package/NOTICE +6 -0
  5. package/README.md +289 -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 +61 -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-JZ6NXTTK.js +2 -0
  363. package/chunks/anthropic-MN33DP4E.js +2 -0
  364. package/chunks/application-ITGAJ4HC.js +2 -0
  365. package/chunks/auth-command-V3RVPLZO.js +2 -0
  366. package/chunks/azure-openai-responses-OWHMUNKC.js +2 -0
  367. package/chunks/chunk-2TF6JAQM.js +2 -0
  368. package/chunks/chunk-33CNY6GP.js +2 -0
  369. package/chunks/chunk-3AODGLMF.js +2 -0
  370. package/chunks/chunk-44VPC5LA.js +38 -0
  371. package/chunks/chunk-4CN3IJFH.js +2 -0
  372. package/chunks/chunk-4PDIO3M6.js +2 -0
  373. package/chunks/chunk-4X22UJQH.js +164 -0
  374. package/chunks/chunk-6255CZPL.js +2 -0
  375. package/chunks/chunk-6P4UKHGR.js +2 -0
  376. package/chunks/chunk-7QLAXRD2.js +1085 -0
  377. package/chunks/chunk-7XYOYZX2.js +2 -0
  378. package/chunks/chunk-A7GMJNA2.js +29 -0
  379. package/chunks/chunk-AGUSPIUP.js +2 -0
  380. package/chunks/chunk-BQ3CF3KE.js +2 -0
  381. package/chunks/chunk-C3CMJAAV.js +3 -0
  382. package/chunks/chunk-CJM7ZJ6W.js +7 -0
  383. package/chunks/chunk-CSOUJVKM.js +2 -0
  384. package/chunks/chunk-D66ZSHXR.js +2 -0
  385. package/chunks/chunk-D7MGU75P.js +2 -0
  386. package/chunks/chunk-E3GLGDGC.js +5 -0
  387. package/chunks/chunk-ENHOPPS7.js +16 -0
  388. package/chunks/chunk-EOR6EDNR.js +2 -0
  389. package/chunks/chunk-EYK25HWR.js +2 -0
  390. package/chunks/chunk-F46IELF5.js +2 -0
  391. package/chunks/chunk-FC4M2B7E.js +2 -0
  392. package/chunks/chunk-FSNYOJPJ.js +2 -0
  393. package/chunks/chunk-FUERW2DW.js +3 -0
  394. package/chunks/chunk-FXOH6TEQ.js +21 -0
  395. package/chunks/chunk-GP52JZMY.js +2 -0
  396. package/chunks/chunk-GRXX6I72.js +2 -0
  397. package/chunks/chunk-GSYHBK5Q.js +6 -0
  398. package/chunks/chunk-HNWBFJNO.js +2 -0
  399. package/chunks/chunk-IIE366LR.js +6706 -0
  400. package/chunks/chunk-IWK7PZP7.js +207 -0
  401. package/chunks/chunk-J3KCPYZT.js +2 -0
  402. package/chunks/chunk-KCLRJQ53.js +59 -0
  403. package/chunks/chunk-LU4RPLJ3.js +2 -0
  404. package/chunks/chunk-LZJYNT32.js +2 -0
  405. package/chunks/chunk-M7GW4VMR.js +27 -0
  406. package/chunks/chunk-MACBL5HF.js +2 -0
  407. package/chunks/chunk-N5NTXCJI.js +2 -0
  408. package/chunks/chunk-N5SVBCUB.js +7 -0
  409. package/chunks/chunk-N6W7ZL26.js +2 -0
  410. package/chunks/chunk-NWB7LFOK.js +131 -0
  411. package/chunks/chunk-OIQ336YE.js +16 -0
  412. package/chunks/chunk-OQNU3VPS.js +30 -0
  413. package/chunks/chunk-OTDNOWXG.js +16 -0
  414. package/chunks/chunk-PNXZWSWT.js +3 -0
  415. package/chunks/chunk-QFUV5PX6.js +2 -0
  416. package/chunks/chunk-QIN5ZBE2.js +2 -0
  417. package/chunks/chunk-QKBN5CGI.js +2 -0
  418. package/chunks/chunk-QPGTKSIQ.js +2 -0
  419. package/chunks/chunk-SIOLUFGG.js +2 -0
  420. package/chunks/chunk-TW23QKAD.js +3 -0
  421. package/chunks/chunk-U3RMPDXU.js +2 -0
  422. package/chunks/chunk-U7U3DJHF.js +2 -0
  423. package/chunks/chunk-VLXX22YO.js +2 -0
  424. package/chunks/chunk-WHD2XVT2.js +2 -0
  425. package/chunks/chunk-WTAJMYF2.js +249 -0
  426. package/chunks/chunk-WWNUAU4P.js +29 -0
  427. package/chunks/chunk-WYANV3IX.js +4 -0
  428. package/chunks/chunk-XAGZ6ZEU.js +9 -0
  429. package/chunks/chunk-XFCC2CI2.js +24 -0
  430. package/chunks/chunk-XQK7JM66.js +2 -0
  431. package/chunks/chunk-YLQXZBEL.js +2 -0
  432. package/chunks/chunk-YPV2X2RG.js +2 -0
  433. package/chunks/chunk-Z6BHCXKT.js +25 -0
  434. package/chunks/chunk-Z6HBNJCA.js +8 -0
  435. package/chunks/chunk-ZQKVUPKA.js +2 -0
  436. package/chunks/chunk-ZQOALVGL.js +2 -0
  437. package/chunks/clipboard-image-PQPC4EHR.js +2 -0
  438. package/chunks/data-dir-LDVKDCJ2.js +2 -0
  439. package/chunks/dist-2BRD4JFU.js +11 -0
  440. package/chunks/dist-EXKHRFQO.js +5 -0
  441. package/chunks/emscripten-module-RD6P2XH5.js +2 -0
  442. package/chunks/emscripten-module-WYNDFH3N.js +2 -0
  443. package/chunks/emscripten-module-XPTEOIWW.js +2 -0
  444. package/chunks/emscripten-module-ZS3PMSDF.js +2 -0
  445. package/chunks/ffi-IO7WZQNG.js +2 -0
  446. package/chunks/ffi-M5UP5J6C.js +2 -0
  447. package/chunks/ffi-ORLOPBB3.js +2 -0
  448. package/chunks/ffi-OUPK6AY6.js +2 -0
  449. package/chunks/google-UJAPMFAB.js +2 -0
  450. package/chunks/google-vertex-VLSF55PW.js +2 -0
  451. package/chunks/install-source-JTIUC4G4.js +2 -0
  452. package/chunks/launcher-FCZ3EDBF.js +61 -0
  453. package/chunks/lifecycle-GY435YMF.js +2 -0
  454. package/chunks/main-TQGGRHTS.js +13 -0
  455. package/chunks/mistral-ZJZUEF2X.js +3 -0
  456. package/chunks/module-6F3E5H7Y-BN7QWGYB.js +2 -0
  457. package/chunks/module-asyncify-R6PWJ6ZV-P4FWSBAY.js +2 -0
  458. package/chunks/multipart-parser-L6M455MS.js +2 -0
  459. package/chunks/network-proxy-U72JCK2I.js +2 -0
  460. package/chunks/openai-codex-responses-FPCDNRL5.js +2 -0
  461. package/chunks/openai-completions-D32YW6KL.js +2 -0
  462. package/chunks/openai-responses-ZCGSENM4.js +2 -0
  463. package/chunks/openrouter-G2EHY5BD.js +2 -0
  464. package/chunks/otel-OHXIZ666.js +2 -0
  465. package/chunks/package-contract-GVXTMJ3N.js +2 -0
  466. package/chunks/pdfjs-SHZAF7PF.js +107 -0
  467. package/chunks/photon_rs-C52RL4CI.js +3 -0
  468. package/chunks/plugin-command-OSAFHS7C.js +2 -0
  469. package/chunks/provider-command-SKTCHD4E.js +2 -0
  470. package/chunks/questionnaire-bridge-ISQOCYWY.js +2 -0
  471. package/chunks/run-acp-command-SG2BDMFJ.js +2 -0
  472. package/chunks/run-exec-command-5ADSQR2Z.js +15 -0
  473. package/chunks/skills-command-XXXEZAG6.js +2 -0
  474. package/chunks/src-DNIDEMVV.js +2 -0
  475. package/chunks/src-IBHIRTD7.js +2 -0
  476. package/chunks/telemetry-J7ZLGF5X.js +2 -0
  477. package/chunks/telemetry-command-COQG2AKK.js +5 -0
  478. package/chunks/tools-WDBB2JKV.js +2 -0
  479. package/chunks/undici-TUGHZJSA.js +2 -0
  480. package/chunks/update-NB6OD572.js +14 -0
  481. package/chunks/update-hint-ED7O67WU.js +3 -0
  482. package/chunks/wechat-onboard-UWXQW2HT.js +2 -0
  483. package/cli.js +5 -0
  484. package/configs/data-minimal.yaml +50 -0
  485. package/embedded/alran-tools/cli.mjs +4961 -0
  486. package/embedded/alran-tools/manifest.json +25 -0
  487. package/emscripten-module.wasm +0 -0
  488. package/image-preview-worker.js +2 -0
  489. package/internal-bin/alran-tools +9 -0
  490. package/internal-bin/alran-tools.cmd +8 -0
  491. package/matrix-mcp-stdio.js +4 -0
  492. package/native/darwin/prebuilds/darwin-arm64/darwin-modifiers.node +0 -0
  493. package/native/darwin/prebuilds/darwin-x64/darwin-modifiers.node +0 -0
  494. package/native/win32/prebuilds/win32-arm64/win32-console-mode.node +0 -0
  495. package/native/win32/prebuilds/win32-x64/win32-console-mode.node +0 -0
  496. package/package.json +38 -4
  497. package/photon_rs_bg.wasm +0 -0
  498. package/quickjs-worker.js +152 -0
  499. package/vendor/java-proxy-agent/build.ts +97 -0
  500. package/vendor/java-proxy-agent/srt-proxy-agent.jar +0 -0
  501. package/vendor/seccomp/arm64/apply-seccomp +0 -0
  502. package/vendor/seccomp/build.ts +74 -0
  503. package/vendor/seccomp/x64/apply-seccomp +0 -0
  504. package/vendor/srt-win/arm64/srt-win.exe +0 -0
  505. package/vendor/srt-win/build.ts +40 -0
  506. package/vendor/srt-win/x64/srt-win.exe +0 -0
@@ -0,0 +1,542 @@
1
+ # docx Environment Setup & Initialization Script (Windows PowerShell)
2
+ # Mirror of setup.sh — Windows 10/11 + Windows Server 2019+
3
+ # Requires: PowerShell 5.1+ (Windows-shipped) or PowerShell 7+ (pwsh)
4
+ # Goals (parity with setup.sh):
5
+ # - dotnet >= 9
6
+ # - python (3.x), pandoc, LibreOffice (soffice.exe), poppler (pdftoppm.exe), zip/unzip
7
+ # - UTF-8 console (CRITICAL: dotnet build of the bundled project will fail on GBK consoles
8
+ # because some C# samples carry CJK content)
9
+ # - Same [OK] / [WARN] / [FAIL] / [INFO] / === === lines as setup.sh
10
+ # - Same exit codes (0 success / 1 fatal / 2 unsupported shell)
11
+ #Requires -Version 5.1
12
+
13
+ [CmdletBinding()]
14
+ param(
15
+ [ValidateSet('Read', 'Render', 'Full')]
16
+ [string]$Level = 'Full',
17
+ [switch]$Minimal,
18
+ [switch]$SkipVerify,
19
+ [switch]$Help
20
+ )
21
+
22
+ $ErrorActionPreference = "Stop"
23
+ # Force UTF-8 for THIS session AND its child native processes (dotnet build / pandoc / soffice).
24
+ # [Console]::OutputEncoding only affects PowerShell's view of stdout. The active console code page
25
+ # (chcp) is what child native processes inherit, and CN/JP/KR Windows ships with chcp 936/932/949.
26
+ # Bundled C# Sample files contain CJK string literals WITHOUT a UTF-8 BOM, so `dotnet build` will
27
+ # fail on a non-UTF-8 console code page. chcp must come BEFORE the [Console]::OutputEncoding
28
+ # assignment so we don't double-flip the encoding.
29
+ try { & chcp.com 65001 *> $null } catch { } # chcp.com missing on Nano Server / WSL pwsh — fall through
30
+ [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
31
+ [Console]::InputEncoding = [System.Text.Encoding]::UTF8
32
+ $OutputEncoding = [System.Text.UTF8Encoding]::new()
33
+ # PS 5.1 default Invoke-WebRequest only enables Ssl3 + Tls1.0; dotnet-install endpoint requires
34
+ # TLS 1.2+ since 2020. Enable Tls12/Tls13 globally for this session before any IWR call.
35
+ try {
36
+ [Net.ServicePointManager]::SecurityProtocol =
37
+ [Net.ServicePointManager]::SecurityProtocol -bor `
38
+ [Net.SecurityProtocolType]::Tls12 -bor `
39
+ [Net.SecurityProtocolType]::Tls11
40
+ if ([enum]::GetNames([Net.SecurityProtocolType]) -contains 'Tls13') {
41
+ [Net.ServicePointManager]::SecurityProtocol =
42
+ [Net.ServicePointManager]::SecurityProtocol -bor `
43
+ [Net.SecurityProtocolType]::Tls13
44
+ }
45
+ } catch { } # rare environments lack the enum; let IWR fail loudly later
46
+ $env:DOTNET_CLI_UI_LANGUAGE = 'en'
47
+
48
+ $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
49
+ $ProjectDir = Split-Path -Parent $ScriptDir
50
+ $DotnetDir = Join-Path $ScriptDir 'dotnet'
51
+ $LogFile = Join-Path $ProjectDir '.setup.log'
52
+ $DotnetRequiredMajor = 9
53
+
54
+ # --- Output helpers (parity with setup.sh log/warn/fail/info/step) ---
55
+ function Write-Log { param([Parameter(ValueFromRemainingArguments = $true)]$Msg) Write-Host ("[OK] " + ($Msg -join ' ')) -ForegroundColor Green }
56
+ function Write-Warn { param([Parameter(ValueFromRemainingArguments = $true)]$Msg) Write-Host ("[WARN] " + ($Msg -join ' ')) -ForegroundColor Yellow }
57
+ function Write-Fail { param([Parameter(ValueFromRemainingArguments = $true)]$Msg) Write-Host ("[FAIL] " + ($Msg -join ' ')) -ForegroundColor Red }
58
+ function Write-Info { param([Parameter(ValueFromRemainingArguments = $true)]$Msg) Write-Host ("[INFO] " + ($Msg -join ' ')) -ForegroundColor Cyan }
59
+ function Write-Step { param([Parameter(ValueFromRemainingArguments = $true)]$Msg) Write-Host ("`n=== " + ($Msg -join ' ') + " ===") -ForegroundColor Blue }
60
+
61
+ if ($Help) {
62
+ @"
63
+ Usage: setup.ps1 [-Level Read|Render|Full] [-Minimal] [-SkipVerify] [-Help]
64
+
65
+ -Level Read Only install/verify the read gate (python, unzip/tar, UTF-8)
66
+ -Level Render Above + soffice + pdftoppm
67
+ -Level Full Above + dotnet >= $DotnetRequiredMajor + pandoc + zip + project build (default)
68
+ -Minimal Skip optional checks (fonts only)
69
+ -SkipVerify Skip the final create-document verification
70
+ -Help Show this help
71
+ "@ | Write-Host
72
+ exit 0
73
+ }
74
+
75
+ Write-Host "============================================"
76
+ Write-Host " docx Setup & Initialization (Windows)"
77
+ Write-Host " $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')"
78
+ Write-Host " Level: $Level"
79
+ Write-Host "============================================"
80
+
81
+ "" | Set-Content -Path $LogFile -Encoding UTF8
82
+
83
+ # --- Detect package manager ---
84
+ function Test-Command($Name) { [bool](Get-Command $Name -ErrorAction SilentlyContinue) }
85
+ $HasWinget = Test-Command winget
86
+ $HasChoco = Test-Command choco
87
+ $HasScoop = Test-Command scoop
88
+
89
+ if ($HasWinget) { Write-Info "Package manager: winget" }
90
+ elseif ($HasChoco) { Write-Info "Package manager: chocolatey" }
91
+ elseif ($HasScoop) { Write-Info "Package manager: scoop" }
92
+ else { Write-Warn "No package manager found (winget/choco/scoop). Manual install may be needed." }
93
+
94
+ function Add-PathForSession([string]$Dir) {
95
+ if (-not $Dir -or -not (Test-Path $Dir)) { return }
96
+ if (-not (($env:Path -split [IO.Path]::PathSeparator) -contains $Dir)) {
97
+ $env:Path = $Dir + [IO.Path]::PathSeparator + $env:Path
98
+ }
99
+ }
100
+
101
+ # Pull whatever Machine/User PATH the registry currently holds, MERGE it with the existing
102
+ # session PATH (so any session-only Add-PathForSession entries from earlier in this script are
103
+ # preserved), and dedup. Naively re-assigning $env:Path = "$machine;$user" wipes session-only
104
+ # entries that have not been written to the registry yet — that was the original bug.
105
+ function Sync-PathFromMachineUser {
106
+ $machine = [Environment]::GetEnvironmentVariable('Path', 'Machine')
107
+ $user = [Environment]::GetEnvironmentVariable('Path', 'User')
108
+ $sep = [IO.Path]::PathSeparator
109
+ $sessionExtras = @()
110
+ foreach ($entry in ($env:Path -split $sep)) {
111
+ if (-not $entry) { continue }
112
+ $inMachine = ($machine -and ($machine -split $sep) -contains $entry)
113
+ $inUser = ($user -and ($user -split $sep) -contains $entry)
114
+ if (-not ($inMachine -or $inUser)) { $sessionExtras += $entry }
115
+ }
116
+ $merged = @()
117
+ foreach ($entry in @($sessionExtras + ($machine -split $sep) + ($user -split $sep))) {
118
+ if (-not $entry) { continue }
119
+ if ($merged -notcontains $entry) { $merged += $entry }
120
+ }
121
+ $env:Path = ($merged -join $sep)
122
+ }
123
+
124
+ # Back-compat alias for any external doc that still mentions the old name; new code MUST use
125
+ # Sync-PathFromMachineUser. The ordering bug was: callers did Add-PathForSession then Refresh,
126
+ # and Refresh wiped the just-added entry. Sync-* preserves session-only entries.
127
+ Set-Alias -Name Refresh-PathFromMachineUser -Value Sync-PathFromMachineUser
128
+
129
+ # Replacement for `Tee-Object -FilePath $LogFile -Append` whose default encoding in PS 5.1 is
130
+ # ANSI/Default (mojibakes CJK in the install log). Add-Content -Encoding UTF8 is the only
131
+ # reliable way on 5.1 to append UTF-8 without reopening/rewriting the file.
132
+ function Append-LogUtf8 {
133
+ [CmdletBinding()]
134
+ param([Parameter(ValueFromPipeline = $true)] $InputObject)
135
+ process {
136
+ $line = if ($null -eq $InputObject) { '' } else { "$InputObject" }
137
+ Add-Content -LiteralPath $script:LogFile -Value $line -Encoding UTF8
138
+ # Re-emit so the original Tee-Object behavior (also write to console / downstream) holds.
139
+ $InputObject
140
+ }
141
+ }
142
+
143
+ function Install-WithPkgMgr {
144
+ param(
145
+ [Parameter(Mandatory)] [string]$Tool,
146
+ [string]$WingetId,
147
+ [string]$ChocoId,
148
+ [string]$ScoopId,
149
+ [string]$ManualUrl
150
+ )
151
+ Write-Info "Installing $Tool ..."
152
+ if ($HasWinget -and $WingetId) {
153
+ & winget install --id $WingetId --silent --accept-source-agreements --accept-package-agreements 2>&1 | Append-LogUtf8
154
+ }
155
+ elseif ($HasChoco -and $ChocoId) {
156
+ & choco install $ChocoId -y --no-progress 2>&1 | Append-LogUtf8
157
+ }
158
+ elseif ($HasScoop -and $ScoopId) {
159
+ & scoop install $ScoopId 2>&1 | Append-LogUtf8
160
+ }
161
+ else {
162
+ Write-Fail "Cannot auto-install $Tool. Install it manually: $ManualUrl"
163
+ return $false
164
+ }
165
+ Refresh-PathFromMachineUser
166
+ return $true
167
+ }
168
+
169
+ # --- Resolve soffice.exe across the usual install layouts ---
170
+ function Resolve-SofficePath {
171
+ $cmd = Get-Command soffice.exe -ErrorAction SilentlyContinue
172
+ if ($cmd) { return $cmd.Source }
173
+ $cmd = Get-Command soffice -ErrorAction SilentlyContinue
174
+ if ($cmd) { return $cmd.Source }
175
+
176
+ $candidates = @(
177
+ (Join-Path $env:ProgramFiles 'LibreOffice\program\soffice.exe'),
178
+ (Join-Path ${env:ProgramFiles(x86)} 'LibreOffice\program\soffice.exe'),
179
+ (Join-Path $env:LOCALAPPDATA 'Programs\LibreOffice\program\soffice.exe'),
180
+ (Join-Path $env:LOCALAPPDATA 'Microsoft\WinGet\Links\soffice.exe'),
181
+ (Join-Path $env:USERPROFILE 'scoop\apps\libreoffice\current\program\soffice.exe')
182
+ ) | Where-Object { $_ }
183
+
184
+ foreach ($p in $candidates) {
185
+ if (Test-Path $p) { return (Resolve-Path $p).Path }
186
+ }
187
+ return $null
188
+ }
189
+
190
+ # --- Resolve pdftoppm.exe (poppler) ---
191
+ function Resolve-PdftoppmPath {
192
+ $cmd = Get-Command pdftoppm.exe -ErrorAction SilentlyContinue
193
+ if ($cmd) { return $cmd.Source }
194
+ $cmd = Get-Command pdftoppm -ErrorAction SilentlyContinue
195
+ if ($cmd) { return $cmd.Source }
196
+
197
+ $candidates = @(
198
+ (Join-Path $env:USERPROFILE 'scoop\apps\poppler\current\bin\pdftoppm.exe'),
199
+ (Join-Path $env:ProgramData 'chocolatey\bin\pdftoppm.exe')
200
+ ) | Where-Object { $_ }
201
+ foreach ($p in $candidates) { if (Test-Path $p) { return (Resolve-Path $p).Path } }
202
+ return $null
203
+ }
204
+
205
+ # --- Resolve python (Windows ships `py` launcher; we want `python` callable) ---
206
+ function Resolve-PythonCommand {
207
+ foreach ($name in @('python', 'python3', 'py')) {
208
+ $cmd = Get-Command $name -ErrorAction SilentlyContinue
209
+ if (-not $cmd) { continue }
210
+ if ($name -eq 'py') {
211
+ try {
212
+ & $cmd.Source -3 --version *> $null
213
+ if ($LASTEXITCODE -eq 0) { return @{ Cmd = $cmd.Source; Args = @('-3') } }
214
+ } catch { continue }
215
+ } else {
216
+ return @{ Cmd = $cmd.Source; Args = @() }
217
+ }
218
+ }
219
+ return $null
220
+ }
221
+
222
+ # ============ READ-LEVEL DEPS ============
223
+ function Install-Python {
224
+ Write-Step "Checking python (>= 3.9)"
225
+ $py = Resolve-PythonCommand
226
+ if ($py) {
227
+ $verLine = (& $py.Cmd @($py.Args + '--version') 2>&1) -join ' '
228
+ Write-Log "python available: $($py.Cmd) ($verLine)"
229
+ return $true
230
+ }
231
+ if (-not (Install-WithPkgMgr -Tool 'python' `
232
+ -WingetId 'Python.Python.3.12' `
233
+ -ChocoId 'python' `
234
+ -ScoopId 'python' `
235
+ -ManualUrl 'https://www.python.org/downloads/windows/')) { return $false }
236
+ $py = Resolve-PythonCommand
237
+ if (-not $py) { Write-Fail 'python installation finished but the command is still not on PATH'; return $false }
238
+ Write-Log "python installed: $($py.Cmd)"
239
+ return $true
240
+ }
241
+
242
+ function Install-UnzipFallback {
243
+ Write-Step "Checking unzip / tar.exe"
244
+ if (Test-Command tar) {
245
+ # tar.exe ships with Windows 10 1803+ and handles .zip natively.
246
+ Write-Log "tar.exe available (handles .zip on Windows 10+)"
247
+ return $true
248
+ }
249
+ if (Test-Command unzip) {
250
+ Write-Log "unzip available"
251
+ return $true
252
+ }
253
+ Write-Warn "Neither tar.exe nor unzip found. Falling back to PowerShell Expand-Archive at runtime."
254
+ Write-Info "(Expand-Archive ships with PowerShell 5+ so this is a soft warning, not a fatal.)"
255
+ return $true
256
+ }
257
+
258
+ function Test-Utf8Console {
259
+ Write-Step "Checking console encoding"
260
+ $enc = [Console]::OutputEncoding.WebName
261
+ $cp = (chcp.com 2>$null | Out-String).Trim()
262
+ if ($enc -match '^utf-?8$') {
263
+ Write-Log "Console encoding: $enc / $cp"
264
+ return $true
265
+ }
266
+ Write-Warn "Console encoding is $enc / $cp. Forcing UTF-8 for this session."
267
+ [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
268
+ Write-Info "To make this permanent: 'Settings -> Time & Language -> Language & region -> Administrative -> Change system locale -> Beta: UTF-8'"
269
+ return $true
270
+ }
271
+
272
+ function Set-ScriptUnblock {
273
+ Write-Step "Unblocking skill scripts (NTFS Mark-of-the-Web)"
274
+ Get-ChildItem -Path $ScriptDir -File -Include *.ps1, *.sh -Recurse -ErrorAction SilentlyContinue |
275
+ ForEach-Object {
276
+ try { Unblock-File -Path $_.FullName -ErrorAction Stop } catch { }
277
+ }
278
+ Write-Log "scripts unblocked (where applicable)"
279
+ }
280
+
281
+ # ============ RENDER-LEVEL DEPS ============
282
+ function Install-Soffice {
283
+ Write-Step "Checking LibreOffice/soffice.exe"
284
+ $sof = Resolve-SofficePath
285
+ if ($sof) {
286
+ Write-Log "soffice available: $sof"
287
+ Add-PathForSession (Split-Path -Parent $sof)
288
+ return $true
289
+ }
290
+ Write-Info "Installing LibreOffice (this may take a few minutes)..."
291
+ if (-not (Install-WithPkgMgr -Tool 'LibreOffice' `
292
+ -WingetId 'TheDocumentFoundation.LibreOffice' `
293
+ -ChocoId 'libreoffice-fresh' `
294
+ -ScoopId 'libreoffice' `
295
+ -ManualUrl 'https://www.libreoffice.org/download/')) { return $false }
296
+ $sof = Resolve-SofficePath
297
+ if (-not $sof) {
298
+ Write-Fail "LibreOffice install reported success but soffice.exe is still not discoverable. Add its 'program' directory to PATH and re-run."
299
+ return $false
300
+ }
301
+ Add-PathForSession (Split-Path -Parent $sof)
302
+ Write-Log "soffice installed: $sof"
303
+ return $true
304
+ }
305
+
306
+ function Install-Poppler {
307
+ Write-Step "Checking pdftoppm (poppler)"
308
+ $pp = Resolve-PdftoppmPath
309
+ if ($pp) { Write-Log "pdftoppm available: $pp"; return $true }
310
+ if (-not (Install-WithPkgMgr -Tool 'poppler' `
311
+ -WingetId 'oschwartz10612.Poppler' `
312
+ -ChocoId 'poppler' `
313
+ -ScoopId 'poppler' `
314
+ -ManualUrl 'https://github.com/oschwartz10612/poppler-windows/releases')) { return $false }
315
+ $pp = Resolve-PdftoppmPath
316
+ if (-not $pp) { Write-Fail "poppler install reported success but pdftoppm.exe is still not discoverable"; return $false }
317
+ Add-PathForSession (Split-Path -Parent $pp)
318
+ Write-Log "pdftoppm installed: $pp"
319
+ return $true
320
+ }
321
+
322
+ # ============ FULL-LEVEL DEPS ============
323
+ function Install-DotnetSdk {
324
+ Write-Step "Checking .NET SDK (>= $DotnetRequiredMajor.0)"
325
+ if (Test-Command dotnet) {
326
+ $verRaw = (& dotnet --version) 2>$null
327
+ if ($verRaw) {
328
+ try {
329
+ $major = [int](($verRaw -split '\.')[0])
330
+ if ($major -ge $DotnetRequiredMajor) {
331
+ Write-Log "dotnet $verRaw already installed (>= $DotnetRequiredMajor.0 OK)"
332
+ return $true
333
+ }
334
+ Write-Warn "dotnet $verRaw found but < $DotnetRequiredMajor.0, upgrading..."
335
+ } catch { Write-Warn "Could not parse dotnet --version output ('$verRaw'), reinstalling" }
336
+ }
337
+ }
338
+ # Prefer the official Channel install via dotnet-install.ps1 (no admin, lands in $env:USERPROFILE\.dotnet)
339
+ Write-Info "Installing .NET SDK $DotnetRequiredMajor via dotnet-install.ps1 (user-scope, no sudo)..."
340
+ $installerPath = Join-Path $env:TEMP "dotnet-install.ps1"
341
+ try {
342
+ Invoke-WebRequest -Uri 'https://dot.net/v1/dotnet-install.ps1' -OutFile $installerPath -UseBasicParsing
343
+ } catch {
344
+ Write-Warn "Could not download dotnet-install.ps1: $_"
345
+ if (-not (Install-WithPkgMgr -Tool '.NET SDK' `
346
+ -WingetId "Microsoft.DotNet.SDK.$DotnetRequiredMajor" `
347
+ -ChocoId 'dotnet-sdk' `
348
+ -ScoopId 'dotnet-sdk' `
349
+ -ManualUrl "https://dotnet.microsoft.com/download/dotnet/$DotnetRequiredMajor.0")) { return $false }
350
+ }
351
+ if (Test-Path $installerPath) {
352
+ $dotnetRoot = Join-Path $env:USERPROFILE '.dotnet'
353
+ & powershell -ExecutionPolicy Bypass -File $installerPath -Channel "$DotnetRequiredMajor.0" -InstallDir $dotnetRoot 2>&1 |
354
+ Append-LogUtf8 | Out-Null
355
+ # NOTE: do NOT Sync-PathFromMachineUser here. dotnet-install.ps1 (user-scope) installs to
356
+ # $USERPROFILE\.dotnet but does NOT modify the registry PATH; syncing would still preserve
357
+ # the session-only Add we're about to do, but no useful work would happen. Just Add and
358
+ # move on.
359
+ Add-PathForSession $dotnetRoot
360
+ }
361
+ if (-not (Test-Command dotnet)) {
362
+ Write-Fail "dotnet installation failed"
363
+ return $false
364
+ }
365
+ Write-Log "dotnet $(& dotnet --version) installed"
366
+ return $true
367
+ }
368
+
369
+ function Install-Pandoc {
370
+ Write-Step "Checking pandoc"
371
+ if (Test-Command pandoc) {
372
+ $pv = (& pandoc --version | Select-Object -First 1)
373
+ Write-Log "pandoc already installed ($pv)"
374
+ return $true
375
+ }
376
+ if (-not (Install-WithPkgMgr -Tool 'pandoc' `
377
+ -WingetId 'JohnMacFarlane.Pandoc' `
378
+ -ChocoId 'pandoc' `
379
+ -ScoopId 'pandoc' `
380
+ -ManualUrl 'https://pandoc.org/installing.html')) { return $false }
381
+ if (-not (Test-Command pandoc)) { Write-Fail 'pandoc installation failed'; return $false }
382
+ Write-Log "pandoc installed"
383
+ return $true
384
+ }
385
+
386
+ function Install-ZipTools {
387
+ Write-Step "Checking zip / Compress-Archive"
388
+ if (Test-Command zip) { Write-Log "zip available"; return $true }
389
+ # Compress-Archive is built into PowerShell 5+; treat as zip equivalent for skill needs.
390
+ if (Get-Command Compress-Archive -ErrorAction SilentlyContinue) {
391
+ Write-Log "Compress-Archive cmdlet available (zip equivalent)"
392
+ return $true
393
+ }
394
+ Write-Warn "Neither zip nor Compress-Archive available. DOCX repacking may fail."
395
+ return $true
396
+ }
397
+
398
+ function Test-NugetConfig {
399
+ Write-Step "Checking NuGet configuration"
400
+ try {
401
+ $sources = & dotnet nuget list source 2>$null
402
+ if ($sources -and ($sources -match 'nuget.org')) {
403
+ Write-Log 'nuget.org source is configured'
404
+ return
405
+ }
406
+ Write-Warn 'nuget.org not in sources. Adding...'
407
+ & dotnet nuget add source 'https://api.nuget.org/v3/index.json' --name 'nuget.org' 2>&1 |
408
+ Append-LogUtf8 | Out-Null
409
+ } catch {
410
+ Write-Warn "Could not validate NuGet sources: $_"
411
+ }
412
+ }
413
+
414
+ function Build-DotnetProject {
415
+ Write-Step "Building docx .NET project"
416
+ if (-not (Test-Path $DotnetDir)) {
417
+ Write-Fail "Dotnet project directory not found: $DotnetDir"
418
+ return $false
419
+ }
420
+ Push-Location $DotnetDir
421
+ try {
422
+ Write-Info "Restoring NuGet packages..."
423
+ & dotnet restore --verbosity quiet 2>&1 | Append-LogUtf8 | Out-Null
424
+ if ($LASTEXITCODE -ne 0) {
425
+ Write-Fail "NuGet restore failed. Common causes: no internet / corporate proxy blocking nuget.org / disk full."
426
+ Write-Info "Diagnose with: dotnet restore --verbosity detailed"
427
+ return $false
428
+ }
429
+ Write-Log "NuGet packages restored"
430
+
431
+ Write-Info "Building project..."
432
+ & dotnet build --verbosity quiet --no-restore 2>&1 | Append-LogUtf8 | Out-Null
433
+ if ($LASTEXITCODE -ne 0) {
434
+ Write-Fail "Build failed. Check $LogFile for details."
435
+ return $false
436
+ }
437
+ Write-Log "Project built successfully"
438
+ return $true
439
+ } finally {
440
+ Pop-Location
441
+ }
442
+ }
443
+
444
+ function Test-Verification {
445
+ Write-Step "Verification Test"
446
+ $testOutput = Join-Path $env:TEMP "docx-setup-test-$PID.docx"
447
+ Push-Location $DotnetDir
448
+ try {
449
+ Write-Info "Creating a test document..."
450
+ & dotnet run --project AlranAIDocx.Cli -- create --type report --output $testOutput --title 'Setup Test' 2>&1 |
451
+ Append-LogUtf8 | Out-Null
452
+ if ($LASTEXITCODE -ne 0 -or -not (Test-Path $testOutput)) {
453
+ Write-Fail "Test document creation failed. Check $LogFile for details."
454
+ return $false
455
+ }
456
+ Write-Log "Test document created: $testOutput"
457
+ Remove-Item $testOutput -Force -ErrorAction SilentlyContinue
458
+ Write-Log "Test passed - docx is ready to use"
459
+ return $true
460
+ } finally {
461
+ Pop-Location
462
+ }
463
+ }
464
+
465
+ function Test-Fonts {
466
+ Write-Step "Checking fonts"
467
+ try {
468
+ Add-Type -AssemblyName System.Drawing -ErrorAction Stop
469
+ $names = [System.Drawing.FontFamily]::Families | ForEach-Object { $_.Name }
470
+ } catch {
471
+ Write-Info "Cannot enumerate fonts (System.Drawing unavailable). Skipping."
472
+ return
473
+ }
474
+ if ($names -contains 'Calibri') { Write-Log 'Western fonts: Calibri' } else { Write-Warn 'Calibri missing — install Microsoft Office or fonts pack' }
475
+ if ($names -contains 'Times New Roman') { Write-Log 'Western fonts: Times New Roman' } else { Write-Warn 'Times New Roman missing' }
476
+ if ($names | Where-Object { $_ -match 'SimSun|Microsoft YaHei|MS Mincho|Malgun Gothic|Noto Sans CJK' }) {
477
+ Write-Log 'CJK fonts: available'
478
+ } else {
479
+ Write-Warn 'CJK fonts not found — install Chinese/Japanese/Korean language packs'
480
+ }
481
+ }
482
+
483
+ function Show-Summary {
484
+ Write-Step "Setup Complete"
485
+ $sof = Resolve-SofficePath; if (-not $sof) { $sof = 'NOT FOUND' }
486
+ $pp = Resolve-PdftoppmPath; if (-not $pp) { $pp = 'NOT FOUND' }
487
+ $py = Resolve-PythonCommand
488
+ $pyDisp = if ($py) { "$($py.Cmd) $($py.Args -join ' ')" } else { 'NOT FOUND' }
489
+ $dotnetVer = try { (& dotnet --version 2>$null) } catch { $null }
490
+ if (-not $dotnetVer) { $dotnetVer = 'NOT FOUND' }
491
+ $pandocVer = try { (& pandoc --version 2>$null | Select-Object -First 1) } catch { $null }
492
+ if (-not $pandocVer) { $pandocVer = 'NOT FOUND' }
493
+
494
+ Write-Host ""
495
+ Write-Host (" Environment: Windows {0}" -f [Environment]::OSVersion.Version)
496
+ Write-Host (" Level: {0}" -f $Level)
497
+ Write-Host (" dotnet: {0}" -f $dotnetVer)
498
+ Write-Host (" python: {0}" -f $pyDisp)
499
+ Write-Host (" pandoc: {0}" -f $pandocVer)
500
+ Write-Host (" pdftoppm: {0}" -f $pp)
501
+ Write-Host (" soffice: {0}" -f $sof)
502
+ Write-Host (" Project: {0}" -f $DotnetDir)
503
+ Write-Host ""
504
+ Write-Host (" Mandatory preflight: powershell -ExecutionPolicy Bypass -File {0}\env_check.ps1 -Level Read" -f $ScriptDir)
505
+ Write-Host (" Log file: {0}" -f $LogFile)
506
+ }
507
+
508
+ # ============ MAIN ============
509
+ $fatal = $false
510
+
511
+ # Read level (always)
512
+ if (-not (Install-Python)) { $fatal = $true }
513
+ Install-UnzipFallback | Out-Null
514
+ Test-Utf8Console | Out-Null
515
+ Set-ScriptUnblock | Out-Null
516
+
517
+ # Render level
518
+ if ($Level -in @('Render', 'Full')) {
519
+ if (-not (Install-Soffice)) { $fatal = $true }
520
+ if (-not (Install-Poppler)) { $fatal = $true }
521
+ }
522
+
523
+ # Full level
524
+ if ($Level -eq 'Full') {
525
+ if (-not (Install-DotnetSdk)) { $fatal = $true }
526
+ if (-not (Install-Pandoc)) { $fatal = $true }
527
+ Install-ZipTools | Out-Null
528
+ Test-NugetConfig
529
+ if (-not $fatal) {
530
+ if (-not (Build-DotnetProject)) { $fatal = $true }
531
+ }
532
+ }
533
+
534
+ if (-not $Minimal -and $Level -eq 'Full') { Test-Fonts }
535
+
536
+ if (-not $fatal -and -not $SkipVerify -and $Level -eq 'Full') {
537
+ if (-not (Test-Verification)) { $fatal = $true }
538
+ }
539
+
540
+ Show-Summary
541
+
542
+ if ($fatal) { exit 1 } else { exit 0 }