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,170 @@
1
+ """AcroForm metadata enumeration for the Alran PDF skill.
2
+
3
+ The functions here produce the JSON-shaped records that the
4
+ ``inspect`` and ``fill`` script groups consume. The schema is:
5
+
6
+ [
7
+ {
8
+ "qname": str, # fully qualified field name
9
+ "page_no": int, # 1-based page number
10
+ "box": [l, b, r, t], # rectangle in PDF user space
11
+ "type": "text" | "checkbox" | "radio_group" | "choice" | "unknown (...)",
12
+ # type-specific extras:
13
+ "on_value": str, # checkbox: the value that ticks the box
14
+ "off_value": str, # checkbox: the value that unticks it
15
+ "radio_choices": [...], # radio: [{"set_to": str, "box": [...]}]
16
+ "choice_options": [...] # choice: [{"set_to": str, "label": str}]
17
+ }
18
+ ]
19
+
20
+ The qname is the dotted path of every ``/T`` from the leaf annotation
21
+ up to the root, joined with "." (so "address.line2" stays distinct
22
+ from "shipping.line2"). When pypdf cannot resolve the parent chain we
23
+ return ``None``.
24
+ """
25
+
26
+ from __future__ import annotations
27
+
28
+ from typing import Any
29
+
30
+
31
+ def resolve_full_qualified_name(annot: Any) -> str | None:
32
+ """Walk the ``/Parent`` chain of an annotation/field and join names."""
33
+ parts: list[str] = []
34
+ cursor = annot
35
+ while cursor is not None:
36
+ leaf = cursor.get("/T")
37
+ if leaf:
38
+ parts.append(leaf)
39
+ cursor = cursor.get("/Parent")
40
+ if not parts:
41
+ return None
42
+ return ".".join(reversed(parts))
43
+
44
+
45
+ def build_field_record(raw_field: Any, qname: str) -> dict:
46
+ """Turn a pypdf field object into our JSON record (without box/page)."""
47
+ record: dict = {"qname": qname}
48
+ ft = raw_field.get("/FT")
49
+ if ft == "/Tx":
50
+ record["type"] = "text"
51
+ elif ft == "/Btn":
52
+ record["type"] = "checkbox"
53
+ states = raw_field.get("/_States_", [])
54
+ if len(states) == 2:
55
+ if "/Off" in states:
56
+ on = states[0] if states[0] != "/Off" else states[1]
57
+ record["on_value"] = on
58
+ record["off_value"] = "/Off"
59
+ else:
60
+ # Unusual two-state checkbox without an explicit /Off.
61
+ # Fall back to positional guess and warn the caller.
62
+ print(
63
+ f"WARN: checkbox `{qname}` has non-standard states "
64
+ f"{states}; verify the rendered PDF before relying on it."
65
+ )
66
+ record["on_value"] = states[0]
67
+ record["off_value"] = states[1]
68
+ elif ft == "/Ch":
69
+ record["type"] = "choice"
70
+ states = raw_field.get("/_States_", [])
71
+ record["choice_options"] = [
72
+ {"set_to": pair[0], "label": pair[1]} for pair in states
73
+ ]
74
+ else:
75
+ record["type"] = f"unknown ({ft})"
76
+ return record
77
+
78
+
79
+ def enumerate_acroform_fields(pdf_doc) -> list[dict]:
80
+ """Return every fillable field in reading order, with location info.
81
+
82
+ ``pdf_doc`` is a ``pypdf.PdfReader``. Fields without a resolvable
83
+ page/box are skipped with a printed warning so a caller scanning the
84
+ JSON output never sees half-populated records.
85
+ """
86
+ raw_fields = pdf_doc.get_fields() or {}
87
+
88
+ record_by_qname: dict[str, dict] = {}
89
+ candidate_radio_qnames: set[str] = set()
90
+
91
+ for qname, field in raw_fields.items():
92
+ if field.get("/Kids"):
93
+ if field.get("/FT") == "/Btn":
94
+ candidate_radio_qnames.add(qname)
95
+ continue
96
+ record_by_qname[qname] = build_field_record(field, qname)
97
+
98
+ radio_groups_by_qname: dict[str, dict] = {}
99
+
100
+ for page_index, pg in enumerate(pdf_doc.pages):
101
+ for ann in pg.get("/Annots", []):
102
+ qname = resolve_full_qualified_name(ann)
103
+ if qname in record_by_qname:
104
+ record_by_qname[qname]["page_no"] = page_index + 1
105
+ record_by_qname[qname]["box"] = ann.get("/Rect")
106
+ elif qname in candidate_radio_qnames:
107
+ try:
108
+ on_states = [v for v in ann["/AP"]["/N"] if v != "/Off"]
109
+ except KeyError:
110
+ continue
111
+ if len(on_states) != 1:
112
+ continue
113
+ box = ann.get("/Rect")
114
+ if qname not in radio_groups_by_qname:
115
+ radio_groups_by_qname[qname] = {
116
+ "qname": qname,
117
+ "type": "radio_group",
118
+ "page_no": page_index + 1,
119
+ "radio_choices": [],
120
+ }
121
+ radio_groups_by_qname[qname]["radio_choices"].append(
122
+ {"set_to": on_states[0], "box": box}
123
+ )
124
+
125
+ placed_records: list[dict] = []
126
+ for record in record_by_qname.values():
127
+ if "page_no" in record:
128
+ placed_records.append(record)
129
+ else:
130
+ print(
131
+ f"WARN: cannot place field `{record.get('qname')}`, "
132
+ "skipping it in the output."
133
+ )
134
+
135
+ def reading_order_key(rec: dict):
136
+ if "radio_choices" in rec:
137
+ box = rec["radio_choices"][0]["box"] or [0, 0, 0, 0]
138
+ else:
139
+ box = rec.get("box") or [0, 0, 0, 0]
140
+ # sort top-to-bottom (negative y so larger y first), then left-to-right
141
+ return [rec.get("page_no"), [-box[1], box[0]]]
142
+
143
+ ordered_records = placed_records + list(radio_groups_by_qname.values())
144
+ ordered_records.sort(key=reading_order_key)
145
+ return ordered_records
146
+
147
+
148
+ def patch_pypdf_inheritance() -> None:
149
+ """Smooth over a pypdf quirk for choice fields.
150
+
151
+ pypdf's ``DictionaryObject.get_inherited`` returns the raw ``/Opt``
152
+ list which, for choice widgets that store ``[value, display]`` pairs,
153
+ breaks downstream value validation. We unwrap the pair so callers see
154
+ a flat list of valid values.
155
+ """
156
+ from pypdf.generic import DictionaryObject
157
+ from pypdf.constants import FieldDictionaryAttributes
158
+
159
+ original = DictionaryObject.get_inherited
160
+
161
+ def patched(self, key: str, default=None):
162
+ result = original(self, key, default)
163
+ if key == FieldDictionaryAttributes.Opt:
164
+ if isinstance(result, list) and all(
165
+ isinstance(v, list) and len(v) == 2 for v in result
166
+ ):
167
+ result = [r[0] for r in result]
168
+ return result
169
+
170
+ DictionaryObject.get_inherited = patched
@@ -0,0 +1,41 @@
1
+ """Tiny CLI helpers shared across the Alran PDF skill scripts.
2
+
3
+ Each entry-point script in ``scripts/`` builds its argparse parser
4
+ through :func:`make_parser` so the help output, default ``--quiet`` /
5
+ ``--verbose`` flags, and exit-code conventions stay uniform. The
6
+ ``emit`` / ``warn`` / ``fail`` helpers funnel all chatter through a
7
+ single place so we can later switch to ``logging`` if needed.
8
+ """
9
+
10
+ from __future__ import annotations
11
+
12
+ import argparse
13
+ import sys
14
+
15
+
16
+ def make_parser(prog: str, description: str) -> argparse.ArgumentParser:
17
+ """Build a parser pre-loaded with the project-wide flags."""
18
+ parser = argparse.ArgumentParser(prog=prog, description=description)
19
+ parser.add_argument(
20
+ "--quiet",
21
+ action="store_true",
22
+ help="Suppress informational output (warnings and errors still print).",
23
+ )
24
+ return parser
25
+
26
+
27
+ def emit(msg: str, *, quiet: bool = False) -> None:
28
+ """Print an informational message unless ``--quiet`` is in effect."""
29
+ if not quiet:
30
+ print(msg)
31
+
32
+
33
+ def warn(msg: str) -> None:
34
+ """Print a warning to stderr; never silenced by ``--quiet``."""
35
+ print(f"WARN: {msg}", file=sys.stderr)
36
+
37
+
38
+ def fail(msg: str, code: int = 1) -> None:
39
+ """Print an error to stderr and exit with a non-zero status."""
40
+ print(f"ERROR: {msg}", file=sys.stderr)
41
+ sys.exit(code)
@@ -0,0 +1,79 @@
1
+ """Geometry helpers for the Alran PDF skill.
2
+
3
+ This module concentrates the coordinate-system bridges that the
4
+ form-fill scripts share:
5
+
6
+ - ``image_box_to_pdf_rect``: rasterised page pixel coords -> pypdf rect
7
+ (origin at the bottom-left of the page).
8
+ - ``pdf_box_to_pypdf_rect``: pdfplumber-style PDF coords (origin at
9
+ the top-left) -> pypdf rect (origin at the bottom-left).
10
+ - ``boxes_overlap``: boolean intersection check used by the geometry
11
+ linter.
12
+
13
+ All functions are intentionally side-effect free so the module can be
14
+ imported at unit-test time without touching disk or pulling in heavy
15
+ PDF dependencies.
16
+ """
17
+
18
+ from __future__ import annotations
19
+
20
+ from typing import Sequence
21
+
22
+ # Type aliases (Python 3.9+ accepts these in annotations because
23
+ # ``from __future__ import annotations`` defers evaluation).
24
+ Box = Sequence[float]
25
+
26
+
27
+ def image_box_to_pdf_rect(
28
+ bbox: Box,
29
+ img_w: float,
30
+ img_h: float,
31
+ pdf_w: float,
32
+ pdf_h: float,
33
+ ) -> tuple[float, float, float, float]:
34
+ """Convert a pixel-space bbox into a pypdf rectangle.
35
+
36
+ ``bbox`` is ``[left, top, right, bottom]`` in raster pixels. The
37
+ output is ``(left, bottom, right, top)`` in PDF user-space points,
38
+ with the origin at the bottom-left of the page (which is what
39
+ ``pypdf.annotations.FreeText`` expects).
40
+ """
41
+ sx = pdf_w / img_w
42
+ sy = pdf_h / img_h
43
+
44
+ left = bbox[0] * sx
45
+ right = bbox[2] * sx
46
+
47
+ top = pdf_h - (bbox[1] * sy)
48
+ bottom = pdf_h - (bbox[3] * sy)
49
+
50
+ return left, bottom, right, top
51
+
52
+
53
+ def pdf_box_to_pypdf_rect(
54
+ bbox: Box,
55
+ pdf_h: float,
56
+ ) -> tuple[float, float, float, float]:
57
+ """Flip a pdfplumber-style bbox to pypdf orientation.
58
+
59
+ pdfplumber reports ``[x0, top, x1, bottom]`` with the origin at the
60
+ top-left; pypdf expects the origin at the bottom-left.
61
+ """
62
+ left = bbox[0]
63
+ right = bbox[2]
64
+ pypdf_top = pdf_h - bbox[1]
65
+ pypdf_bottom = pdf_h - bbox[3]
66
+ return left, pypdf_bottom, right, pypdf_top
67
+
68
+
69
+ def boxes_overlap(box_a: Box, box_b: Box) -> bool:
70
+ """True iff two axis-aligned boxes have a non-empty intersection.
71
+
72
+ Both inputs are ``[left, top, right, bottom]`` (the convention used
73
+ in the ``fields.json`` schema). Edge contact is treated as
74
+ *non-overlapping* so the linter does not complain about boxes that
75
+ happen to share a border.
76
+ """
77
+ apart_x = box_a[0] >= box_b[2] or box_a[2] <= box_b[0]
78
+ apart_y = box_a[1] >= box_b[3] or box_a[3] <= box_b[1]
79
+ return not (apart_x or apart_y)
@@ -0,0 +1,388 @@
1
+ #!/usr/bin/env bash
2
+ # make.sh — pdf unified CLI (HTML → PDF)
3
+ # Usage: bash make.sh <command> [options]
4
+ #
5
+ # Commands:
6
+ # check Verify all dependencies
7
+ # fix Auto-install missing dependencies
8
+ # render --in page.html --out report.pdf [--wait 15000] [--format A4] ...
9
+ # CREATE: render any HTML file/URL → PDF
10
+ # reformat --input doc.md --out report.pdf [--title T] [--accent #HEX] ...
11
+ # REFORMAT: parse markdown/text/pdf → HTML → PDF
12
+ # fill <subcommand> [args...] FILL: probe / inspect / apply (AcroForm)
13
+ # scan / rasterize / preview / overlay / lint (visual)
14
+ #
15
+ # For READ / extract existing PDFs, see docs/read-guide.md (pdfplumber default,
16
+ # scripts/read_pdf_vision.py for vision escalation).
17
+ # For PDF mutation (merge / split / rotate / watermark / annotate), see
18
+ # docs/advanced-reference.md (qpdf / pypdf / reportlab cookbook).
19
+ #
20
+ # Exit codes: 0 success, 1 usage error, 2 dep missing, 3 runtime error
21
+
22
+ set -euo pipefail
23
+ SCRIPTS="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
24
+ SKILL_ROOT="$(cd "$SCRIPTS/.." && pwd)"
25
+ PY="${PYTHON:-$(command -v python3 2>/dev/null || command -v python 2>/dev/null || echo python3)}"
26
+
27
+ # ── Colour helpers ─────────────────────────────────────────────────────────────
28
+ red() { printf '\033[0;31m%s\033[0m\n' "$*"; }
29
+ green() { printf '\033[0;32m%s\033[0m\n' "$*"; }
30
+ yellow() { printf '\033[0;33m%s\033[0m\n' "$*"; }
31
+ bold() { printf '\033[1m%s\033[0m\n' "$*"; }
32
+
33
+ # ── Minimum versions (single source of truth for `check` and `fix`) ───────────
34
+ PY_MIN="3.9"
35
+ NODE_MIN_MAJOR=18
36
+ PYPDF_MIN="3.0"
37
+ MARKDOWN_IT_MIN="3.0"
38
+
39
+ # Compare two dotted versions A and B; succeed iff A >= B.
40
+ ver_ge() {
41
+ $PY - "$1" "$2" <<'PYEOF'
42
+ import sys
43
+ def parts(v):
44
+ out = []
45
+ for chunk in v.split("."):
46
+ digits = "".join(c for c in chunk if c.isdigit())
47
+ out.append(int(digits) if digits else 0)
48
+ return out
49
+ a, b = parts(sys.argv[1]), parts(sys.argv[2])
50
+ n = max(len(a), len(b))
51
+ a += [0] * (n - len(a))
52
+ b += [0] * (n - len(b))
53
+ sys.exit(0 if a >= b else 1)
54
+ PYEOF
55
+ }
56
+
57
+ # Print "OK <label> <version> (>= <min>)" or set ok=false and warn.
58
+ # Args: <import-name> <pretty-label> <min-version> [optional]
59
+ py_pkg_check() {
60
+ local import_name="$1" label="$2" min="$3" optional="${4:-}"
61
+ if ! $PY -c "import importlib, sys; m=importlib.import_module('$import_name'); v=getattr(m,'__version__','0'); print(v)" 2>/dev/null >/tmp/.pdfgen_ver; then
62
+ if [[ "$optional" == "true" ]]; then
63
+ yellow " WARN $label not installed (optional)"
64
+ else
65
+ yellow " MISSING $label (run: bash make.sh fix)"
66
+ ok=false
67
+ fi
68
+ return
69
+ fi
70
+ local ver
71
+ ver="$(cat /tmp/.pdfgen_ver)"
72
+ if ver_ge "$ver" "$min"; then
73
+ green " OK $label $ver (>= $min)"
74
+ else
75
+ red " FAIL $label $ver is below required $min"
76
+ ok=false
77
+ fi
78
+ }
79
+
80
+ # ── check ──────────────────────────────────────────────────────────────────────
81
+ cmd_check() {
82
+ local ok=true
83
+ bold "Checking dependencies..."
84
+
85
+ # Python interpreter + version gate
86
+ if ! command -v $PY &>/dev/null; then
87
+ red " MISSING python3 not found"
88
+ ok=false
89
+ else
90
+ local py_ver
91
+ py_ver=$($PY -c 'import sys;print(f"{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}")' 2>/dev/null || echo "?")
92
+ if ver_ge "$py_ver" "$PY_MIN"; then
93
+ green " OK python3 $py_ver (>= $PY_MIN) at $(command -v $PY)"
94
+ else
95
+ red " FAIL python3 $py_ver is below required $PY_MIN"
96
+ ok=false
97
+ fi
98
+ # pip must be importable so 'fix' can do its job
99
+ if $PY -m pip --version &>/dev/null; then
100
+ local pip_ver
101
+ pip_ver=$($PY -m pip --version 2>/dev/null | awk '{print $2}')
102
+ green " OK pip $pip_ver"
103
+ else
104
+ yellow " WARN pip not importable from $PY (try: $PY -m ensurepip)"
105
+ ok=false
106
+ fi
107
+ fi
108
+
109
+ # Python packages — pypdf is needed by fill/, markdown-it-py by reformat
110
+ py_pkg_check pypdf "pypdf" "$PYPDF_MIN"
111
+ py_pkg_check markdown_it "markdown-it-py" "$MARKDOWN_IT_MIN"
112
+
113
+ # Node.js + version gate
114
+ if command -v node &>/dev/null; then
115
+ local node_ver node_major
116
+ node_ver=$(node --version 2>&1 | sed 's/^v//')
117
+ node_major=${node_ver%%.*}
118
+ if [[ "$node_major" -ge "$NODE_MIN_MAJOR" ]]; then
119
+ green " OK node v$node_ver (>= v$NODE_MIN_MAJOR)"
120
+ else
121
+ red " FAIL node v$node_ver is below required v$NODE_MIN_MAJOR"
122
+ ok=false
123
+ fi
124
+ else
125
+ red " MISSING node not found - HTML rendering unavailable"
126
+ ok=false
127
+ fi
128
+
129
+ # Playwright (resolved either locally or globally)
130
+ if node -e "require('playwright')" 2>/dev/null || \
131
+ node -e "require(require('child_process').execSync('npm root -g').toString().trim()+'/playwright')" 2>/dev/null; then
132
+ green " OK playwright"
133
+ else
134
+ yellow " WARN playwright not found (run: bash make.sh fix)"
135
+ ok=false
136
+ fi
137
+
138
+ # pdfinfo / qpdf are nice-to-have for verification & mutation
139
+ if command -v pdfinfo &>/dev/null; then green " OK pdfinfo $(pdfinfo -v 2>&1 | head -1 | awk '{print $NF}')"
140
+ else yellow " WARN pdfinfo not found (brew install poppler) — only used for verification"; fi
141
+ if command -v qpdf &>/dev/null; then green " OK qpdf $(qpdf --version | head -1 | awk '{print $NF}')"
142
+ else yellow " WARN qpdf not found (brew install qpdf) — only used for advanced PDF mutation"; fi
143
+
144
+ if $ok; then
145
+ green ""
146
+ green "All required dependencies satisfied."
147
+ exit 0
148
+ else
149
+ yellow ""
150
+ yellow "Some dependencies are missing or below the supported minimum."
151
+ yellow "Run: bash make.sh fix"
152
+ exit 2
153
+ fi
154
+ }
155
+
156
+ # ── fix ────────────────────────────────────────────────────────────────────────
157
+ cmd_fix() {
158
+ bold "Installing missing dependencies..."
159
+ local rc=0
160
+
161
+ if ! command -v $PY &>/dev/null; then
162
+ red " python3 not found - install Python $PY_MIN+ first"
163
+ exit 2
164
+ fi
165
+ if ! $PY -m pip --version &>/dev/null; then
166
+ red " pip is not importable from $(command -v $PY)"
167
+ yellow " Try: $PY -m ensurepip --upgrade"
168
+ exit 2
169
+ fi
170
+
171
+ # Python packages
172
+ local pip_log
173
+ pip_log=$(mktemp -t pdfgen-pip.XXXXXX)
174
+ local pip_specs=("pypdf>=$PYPDF_MIN" "markdown-it-py>=$MARKDOWN_IT_MIN")
175
+ bold " Running: $PY -m pip install ${pip_specs[*]}"
176
+ if $PY -m pip install --break-system-packages -q "${pip_specs[@]}" >"$pip_log" 2>&1 \
177
+ || $PY -m pip install -q "${pip_specs[@]}" >"$pip_log" 2>&1; then
178
+ green " OK Python packages installed (pypdf, markdown-it-py)"
179
+ else
180
+ yellow " pip install failed -- last 20 lines of output:"
181
+ tail -20 "$pip_log" | sed 's/^/ /'
182
+ rc=3
183
+ fi
184
+ rm -f "$pip_log"
185
+
186
+ # Playwright -- skip when already resolvable
187
+ if node -e "require('playwright')" 2>/dev/null || \
188
+ node -e "require(require('child_process').execSync('npm root -g').toString().trim()+'/playwright')" 2>/dev/null; then
189
+ green " OK playwright already installed -- skipping"
190
+ elif command -v npm &>/dev/null; then
191
+ if npm install -g playwright --silent 2>/dev/null && \
192
+ npx playwright install chromium --silent 2>/dev/null; then
193
+ green " OK Playwright + Chromium installed"
194
+ else
195
+ yellow " playwright install failed -- try: npm install -g playwright && npx playwright install chromium"
196
+ rc=3
197
+ fi
198
+ else
199
+ yellow " npm not found - cannot install Playwright (HTML rendering will fail)"
200
+ rc=2
201
+ fi
202
+
203
+ if [[ $rc -eq 0 ]]; then
204
+ green ""
205
+ green "All dependencies installed. Run: bash make.sh check"
206
+ else
207
+ yellow ""
208
+ yellow "Some installs failed -- run 'bash make.sh check' for the current state."
209
+ fi
210
+ exit $rc
211
+ }
212
+
213
+ # ── render ────────────────────────────────────────────────────────────────────
214
+ # Thin wrapper around scripts/render_html.cjs. Forwards every flag through.
215
+ # Usage:
216
+ # bash make.sh render --in page.html --out report.pdf [--wait 15000] ...
217
+ cmd_render() {
218
+ if [[ $# -eq 0 ]]; then
219
+ cat <<'USAGE'
220
+ Usage: bash make.sh render --in <file.html|url> --out <file.pdf>
221
+ [--wait <ms>] extra settle time (Chart.js: 15000)
222
+ [--format A4|Letter] page format (default A4)
223
+ [--margin "14mm 12mm"] CSS margin shorthand
224
+ [--landscape] landscape orientation
225
+ [--scale 1] print scale 0.1–2
226
+ [--no-print-background] disable color-exact print
227
+ [--header <html>] header template
228
+ [--footer <html>] footer template
229
+
230
+ Examples:
231
+ bash make.sh render --in templates/data-viz-report/skeleton.html \
232
+ --out demo.pdf --wait 15000
233
+ bash make.sh render --in https://example.com --out site.pdf --landscape
234
+ USAGE
235
+ exit 1
236
+ fi
237
+ exec node "$SCRIPTS/render_html.cjs" "$@"
238
+ }
239
+
240
+ # ── reformat ───────────────────────────────────────────────────────────────────
241
+ # Parse a markdown / text / pdf source into HTML using the reformat-default
242
+ # template, then render to PDF.
243
+ cmd_reformat() {
244
+ local input="" out="output.pdf"
245
+ local title="" subtitle="" author="" date="" accent=""
246
+ local template="default" wait_ms="800"
247
+ local keep_html=false
248
+
249
+ while [[ $# -gt 0 ]]; do
250
+ case "$1" in
251
+ --input) input="$2"; shift 2 ;;
252
+ --out) out="$2"; shift 2 ;;
253
+ --title) title="$2"; shift 2 ;;
254
+ --subtitle) subtitle="$2"; shift 2 ;;
255
+ --author) author="$2"; shift 2 ;;
256
+ --date) date="$2"; shift 2 ;;
257
+ --accent) accent="$2"; shift 2 ;;
258
+ --template) template="$2"; shift 2 ;;
259
+ --wait) wait_ms="$2"; shift 2 ;;
260
+ --keep-html) keep_html=true; shift ;;
261
+ -h|--help)
262
+ cat <<'USAGE'
263
+ Usage: bash make.sh reformat --input <file.md|.txt|.pdf|.html> --out <file.pdf>
264
+ [--title T] [--subtitle S] [--author A] [--date D]
265
+ [--accent "#007AFF"] [--template default]
266
+ [--wait <ms>] [--keep-html]
267
+
268
+ Pipeline: source → markdown → reformat-default skeleton → PDF
269
+ USAGE
270
+ exit 0 ;;
271
+ *) red "Unknown option: $1"; exit 1 ;;
272
+ esac
273
+ done
274
+
275
+ if [[ -z "$input" ]]; then
276
+ red "error: --input is required"
277
+ bash "$0" reformat --help
278
+ exit 1
279
+ fi
280
+ if [[ ! -f "$input" ]]; then
281
+ red "error: input not found: $input"
282
+ exit 1
283
+ fi
284
+
285
+ local tmpdir
286
+ tmpdir="$(mktemp -d -t pdfgen-reformat.XXXXXX)"
287
+ local html="$tmpdir/page.html"
288
+
289
+ bold "Parsing → HTML: $input"
290
+ local parse_args=(--input "$input" --out "$html" --template "$template")
291
+ [[ -n "$title" ]] && parse_args+=(--title "$title")
292
+ [[ -n "$subtitle" ]] && parse_args+=(--subtitle "$subtitle")
293
+ [[ -n "$author" ]] && parse_args+=(--author "$author")
294
+ [[ -n "$date" ]] && parse_args+=(--date "$date")
295
+ [[ -n "$accent" ]] && parse_args+=(--accent "$accent")
296
+ $PY "$SCRIPTS/reformat_parse.py" "${parse_args[@]}"
297
+
298
+ bold "Rendering → PDF: $out"
299
+ node "$SCRIPTS/render_html.cjs" --in "$html" --out "$out" --wait "$wait_ms"
300
+
301
+ if $keep_html; then
302
+ yellow " (--keep-html) intermediate HTML kept at: $html"
303
+ else
304
+ rm -rf "$tmpdir"
305
+ fi
306
+ green "OK reformat complete: $out"
307
+ }
308
+
309
+ # ── fill ──────────────────────────────────────────────────────────────────────
310
+ # FILL is dispatched via subverbs that map to subpackages under scripts/.
311
+ # All scripts run as `python -m scripts.<group>.<name>` from the skill root.
312
+ cmd_fill() {
313
+ if [[ $# -lt 1 ]]; then
314
+ cat <<'USAGE'
315
+ Usage: make.sh fill <subcommand> [args...]
316
+
317
+ Subcommands:
318
+ probe <input.pdf> Detect AcroForm: prints acroform=true|false
319
+ inspect <input.pdf> <meta.json> Dump AcroForm field metadata
320
+ apply <input.pdf> <values.json> <output.pdf> Apply values to AcroForm fields
321
+ scan <input.pdf> <layout.json> Scan visual layout (non-fillable PDFs)
322
+ rasterize <input.pdf> <out_dir/> [--max-edge N] [--dpi N]
323
+ Render pages to PNG
324
+ preview <page> <fields.json> <page.png> <out.png> Overlay bbox preview on a page image
325
+ overlay <input.pdf> <fields.json> <output.pdf> Lay text via FreeText annotations
326
+ lint <fields.json> [--max-findings N] Lint bounding-box geometry in fields.json
327
+
328
+ Decision tree: run 'fill probe' first.
329
+ acroform=true → inspect → apply
330
+ acroform=false → scan → rasterize → preview → overlay → lint
331
+ USAGE
332
+ exit 1
333
+ fi
334
+
335
+ local sub="$1"; shift
336
+ cd "$SKILL_ROOT"
337
+ # Prepend the skill root to PYTHONPATH so `python -m scripts.X` works even
338
+ # when PYTHONSAFEPATH=1 is set in the user environment.
339
+ export PYTHONPATH="$SKILL_ROOT${PYTHONPATH:+:$PYTHONPATH}"
340
+
341
+ case "$sub" in
342
+ probe) bold "Probing AcroForm: $1"; $PY -m scripts.pdf_inspect.acroform_probe "$@" ;;
343
+ inspect) bold "Inspecting AcroForm: $1 → $2"; $PY -m scripts.pdf_inspect.acroform_inspect "$@" ;;
344
+ apply) bold "Applying values: $1 + $2 → $3"; $PY -m scripts.fill.acroform_apply "$@" ;;
345
+ scan) bold "Scanning layout: $1 → $2"; $PY -m scripts.pdf_inspect.layout_scan "$@" ;;
346
+ rasterize) bold "Rasterising pages: $1 → $2"; $PY -m scripts.render.page_rasterize "$@" ;;
347
+ preview) bold "Overlay preview: page $1 → $4"; $PY -m scripts.render.overlay_preview "$@" ;;
348
+ overlay) bold "Filling via overlay: $1 + $2 → $3"; $PY -m scripts.fill.overlay_apply "$@" ;;
349
+ lint) bold "Linting fields: $1"; $PY -m scripts.validate.geometry_lint "$@" ;;
350
+ *) red "Unknown fill subcommand: $sub"; exit 1 ;;
351
+ esac
352
+ }
353
+
354
+ # ── dispatch ───────────────────────────────────────────────────────────────────
355
+ main() {
356
+ if [[ $# -lt 1 ]]; then
357
+ bold "pdf — make.sh (HTML → PDF)"
358
+ cat <<'USAGE'
359
+
360
+ Usage: bash make.sh <command> [options]
361
+
362
+ Commands:
363
+ check Verify all dependencies
364
+ fix Auto-install missing dependencies
365
+ render --in HTML --out PDF [opts] CREATE: render HTML file or URL → PDF
366
+ (see: bash make.sh render with no args)
367
+ reformat --input SRC --out PDF REFORMAT: markdown/text/pdf → HTML → PDF
368
+ (see: bash make.sh reformat --help)
369
+ fill <subcommand> [args...] FILL: AcroForm probe/apply, visual overlay
370
+ (see: bash make.sh fill with no args)
371
+
372
+ For READ / extract existing PDFs, see docs/read-guide.md.
373
+ For PDF mutation (merge / split / rotate / watermark), see docs/advanced-reference.md.
374
+ USAGE
375
+ exit 0
376
+ fi
377
+
378
+ case "$1" in
379
+ check) cmd_check ;;
380
+ fix) cmd_fix ;;
381
+ render) shift; cmd_render "$@" ;;
382
+ reformat) shift; cmd_reformat "$@" ;;
383
+ fill) shift; cmd_fill "$@" ;;
384
+ *) red "Unknown command: $1"; exit 1 ;;
385
+ esac
386
+ }
387
+
388
+ main "$@"