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,86 @@
1
+ """Draw bounding-box previews on top of a rasterised page.
2
+
3
+ Reads the new-style ``fields.json`` config (see docs/forms-guide.md
4
+ for the schema) and overlays each entry/tag rectangle onto a single
5
+ page image so the operator can eyeball the geometry before running
6
+ ``scripts.fill.overlay_apply``.
7
+
8
+ Run from the skill root::
9
+
10
+ python -m scripts.render.overlay_preview \\
11
+ 1 fields.json out_dir/page_1.png out_dir/page_1_overlay.png
12
+ """
13
+
14
+ from __future__ import annotations
15
+
16
+ import json
17
+ import sys
18
+
19
+ from PIL import Image, ImageDraw
20
+
21
+ from scripts.lib.cli_utils import emit, fail, make_parser
22
+
23
+
24
+ def render_overlay_preview(
25
+ page_no: int,
26
+ cfg_path: str,
27
+ base_img: str,
28
+ out_img: str,
29
+ *,
30
+ quiet: bool = False,
31
+ ) -> int:
32
+ with open(cfg_path, "r") as handle:
33
+ cfg = json.load(handle)
34
+
35
+ canvas = Image.open(base_img)
36
+ painter = ImageDraw.Draw(canvas)
37
+ drawn_boxes = 0
38
+
39
+ for slot in cfg.get("slots", []):
40
+ if slot.get("page_no") != page_no:
41
+ continue
42
+ slot_box = slot.get("slot_box")
43
+ tag_box = slot.get("tag_box")
44
+ if slot_box:
45
+ painter.rectangle(slot_box, outline="red", width=2)
46
+ drawn_boxes += 1
47
+ if tag_box:
48
+ painter.rectangle(tag_box, outline="blue", width=2)
49
+ drawn_boxes += 1
50
+
51
+ canvas.save(out_img)
52
+ emit(
53
+ f"Rendered overlay preview to {out_img} ({drawn_boxes} boxes drawn)",
54
+ quiet=quiet,
55
+ )
56
+ return drawn_boxes
57
+
58
+
59
+ def main(argv: list[str] | None = None) -> int:
60
+ parser = make_parser(
61
+ "overlay_preview",
62
+ "Draw slot/tag bounding boxes on top of a rasterised page image.",
63
+ )
64
+ parser.add_argument("page_no", type=int, help="1-based page number.")
65
+ parser.add_argument("cfg_path", help="Path to fields.json (new schema).")
66
+ parser.add_argument("base_img", help="Input page PNG.")
67
+ parser.add_argument("out_img", help="Output PNG with overlay drawn.")
68
+ args = parser.parse_args(argv)
69
+
70
+ try:
71
+ render_overlay_preview(
72
+ args.page_no,
73
+ args.cfg_path,
74
+ args.base_img,
75
+ args.out_img,
76
+ quiet=args.quiet,
77
+ )
78
+ except FileNotFoundError as exc:
79
+ fail(f"File not found: {exc.filename}", code=2)
80
+ except Exception as exc: # noqa: BLE001
81
+ fail(f"Overlay preview failed: {exc}", code=2)
82
+ return 0
83
+
84
+
85
+ if __name__ == "__main__":
86
+ sys.exit(main())
@@ -0,0 +1,85 @@
1
+ """Rasterise PDF pages to PNG images.
2
+
3
+ Each page becomes ``page_<N>.png`` inside the destination directory.
4
+ Pages larger than ``--max-edge`` (in pixels along the longer side)
5
+ are downsampled with PIL before being written, which keeps the output
6
+ manageable for visual inspection.
7
+
8
+ Run from the skill root::
9
+
10
+ python -m scripts.render.page_rasterize input.pdf out_dir/ \\
11
+ --max-edge 1200 --dpi 200
12
+ """
13
+
14
+ from __future__ import annotations
15
+
16
+ import os
17
+ import sys
18
+
19
+ from pdf2image import convert_from_path
20
+
21
+ from scripts.lib.cli_utils import emit, fail, make_parser
22
+
23
+
24
+ def rasterize(
25
+ src_pdf: str,
26
+ dst_dir: str,
27
+ *,
28
+ max_edge: int = 1000,
29
+ dpi: int = 200,
30
+ quiet: bool = False,
31
+ ) -> int:
32
+ os.makedirs(dst_dir, exist_ok=True)
33
+ page_imgs = convert_from_path(src_pdf, dpi=dpi)
34
+
35
+ for idx, img in enumerate(page_imgs):
36
+ w, h = img.size
37
+ if w > max_edge or h > max_edge:
38
+ shrink = min(max_edge / w, max_edge / h)
39
+ img = img.resize((int(w * shrink), int(h * shrink)))
40
+ out_png = os.path.join(dst_dir, f"page_{idx + 1}.png")
41
+ img.save(out_png)
42
+ emit(f" page {idx + 1} -> {out_png} ({img.size[0]}x{img.size[1]})", quiet=quiet)
43
+
44
+ emit(f"Rasterised {len(page_imgs)} page(s) into {dst_dir}", quiet=quiet)
45
+ return len(page_imgs)
46
+
47
+
48
+ def main(argv: list[str] | None = None) -> int:
49
+ parser = make_parser(
50
+ "page_rasterize",
51
+ "Convert each PDF page into a PNG file under the output directory.",
52
+ )
53
+ parser.add_argument("src_pdf", help="Input PDF path.")
54
+ parser.add_argument("dst_dir", help="Output directory for PNGs.")
55
+ parser.add_argument(
56
+ "--max-edge",
57
+ type=int,
58
+ default=1000,
59
+ help="Cap the longer side (pixels). Set 0 to disable resizing.",
60
+ )
61
+ parser.add_argument(
62
+ "--dpi",
63
+ type=int,
64
+ default=200,
65
+ help="Initial render resolution before optional resizing.",
66
+ )
67
+ args = parser.parse_args(argv)
68
+
69
+ try:
70
+ rasterize(
71
+ args.src_pdf,
72
+ args.dst_dir,
73
+ max_edge=args.max_edge if args.max_edge > 0 else 10**9,
74
+ dpi=args.dpi,
75
+ quiet=args.quiet,
76
+ )
77
+ except FileNotFoundError:
78
+ fail(f"PDF not found: {args.src_pdf}", code=2)
79
+ except Exception as exc: # noqa: BLE001
80
+ fail(f"Rasterisation failed: {exc}", code=2)
81
+ return 0
82
+
83
+
84
+ if __name__ == "__main__":
85
+ sys.exit(main())
@@ -0,0 +1,205 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * render_html.cjs — Render any HTML (file or URL) → PDF via Playwright.
4
+ *
5
+ * Usage:
6
+ * node render_html.cjs --in page.html --out report.pdf
7
+ * node render_html.cjs --in page.html --out report.pdf --wait 15000
8
+ * node render_html.cjs --in https://example.com --out site.pdf --landscape
9
+ *
10
+ * Options:
11
+ * --in <file|url> HTML file path or http(s):// URL (required)
12
+ * --out <file> Output PDF path (required)
13
+ * --wait <ms> Extra settle time after networkidle (default 800).
14
+ * Bump to 15000+ for Chart.js / heavy JS pages.
15
+ * --format <A4|Letter> Page format (default A4)
16
+ * --margin <css> CSS margin shorthand, e.g. "14mm 12mm" (default "14mm 12mm")
17
+ * --landscape Landscape orientation
18
+ * --scale <n> Print scale 0.1–2 (default 1)
19
+ * --no-print-background Disable -webkit-print-color-adjust:exact rendering
20
+ * --header <html> Optional header HTML template
21
+ * --footer <html> Optional footer HTML template
22
+ *
23
+ * Exit codes: 0 success, 1 bad args, 2 dependency missing, 3 render error
24
+ */
25
+
26
+ const path = require('path');
27
+ const fs = require('fs');
28
+
29
+ function usage(msg) {
30
+ if (msg) console.error(msg);
31
+ console.error(
32
+ 'Usage: node render_html.cjs --in <file.html|url> --out <file.pdf>\n' +
33
+ ' [--wait <ms>] [--format A4|Letter] [--margin "14mm 12mm"]\n' +
34
+ ' [--landscape] [--scale 1] [--no-print-background]\n' +
35
+ ' [--header <html>] [--footer <html>]',
36
+ );
37
+ process.exit(1);
38
+ }
39
+
40
+ // ── Arg parsing ────────────────────────────────────────────────────────────────
41
+ const args = process.argv.slice(2);
42
+ let input = null;
43
+ let outFile = null;
44
+ let waitMs = 800;
45
+ let format = 'A4';
46
+ let margin = '14mm 12mm';
47
+ let landscape = false;
48
+ let scale = 1;
49
+ let printBackground = true;
50
+ let headerHtml = null;
51
+ let footerHtml = null;
52
+
53
+ for (let i = 0; i < args.length; i++) {
54
+ const a = args[i];
55
+ if ((a === '--in' || a === '--input') && args[i + 1]) input = args[++i];
56
+ else if (a === '--out' && args[i + 1]) outFile = args[++i];
57
+ else if (a === '--wait' && args[i + 1]) waitMs = parseInt(args[++i], 10);
58
+ else if (a === '--format' && args[i + 1]) format = args[++i];
59
+ else if (a === '--margin' && args[i + 1]) margin = args[++i];
60
+ else if (a === '--scale' && args[i + 1]) scale = parseFloat(args[++i]);
61
+ else if (a === '--landscape') landscape = true;
62
+ else if (a === '--no-print-background') printBackground = false;
63
+ else if (a === '--header' && args[i + 1]) headerHtml = args[++i];
64
+ else if (a === '--footer' && args[i + 1]) footerHtml = args[++i];
65
+ else if (a === '-h' || a === '--help') usage();
66
+ }
67
+
68
+ if (!input || !outFile) usage('error: --in and --out are required');
69
+
70
+ // Resolve --in to file:// URL or pass through if already http(s)://
71
+ let pageUrl;
72
+ if (/^https?:\/\//i.test(input)) {
73
+ pageUrl = input;
74
+ } else {
75
+ if (!fs.existsSync(input)) {
76
+ console.error(JSON.stringify({ status: 'error', error: `File not found: ${input}` }));
77
+ process.exit(1);
78
+ }
79
+ pageUrl = 'file://' + path.resolve(input);
80
+ }
81
+
82
+ // Parse CSS margin shorthand → Playwright margin object
83
+ function parseMargin(css) {
84
+ const parts = css.trim().split(/\s+/);
85
+ const [t, r, b, l] = (() => {
86
+ if (parts.length === 1) return [parts[0], parts[0], parts[0], parts[0]];
87
+ if (parts.length === 2) return [parts[0], parts[1], parts[0], parts[1]];
88
+ if (parts.length === 3) return [parts[0], parts[1], parts[2], parts[1]];
89
+ return [parts[0], parts[1], parts[2], parts[3]];
90
+ })();
91
+ return { top: t, right: r, bottom: b, left: l };
92
+ }
93
+
94
+ // ── Playwright loader (tolerates global npm installs) ─────────────────────────
95
+ function loadPlaywright() {
96
+ const { execSync } = require('child_process');
97
+ try {
98
+ return require('playwright');
99
+ } catch (_) {}
100
+ try {
101
+ const root = execSync('npm root -g', { stdio: ['ignore', 'pipe', 'ignore'] })
102
+ .toString()
103
+ .trim();
104
+ return require(path.join(root, 'playwright'));
105
+ } catch (_) {}
106
+ console.error(
107
+ JSON.stringify({
108
+ status: 'error',
109
+ error: 'playwright not found',
110
+ hint: 'Run: bash scripts/make.sh fix (or: npm install -g playwright && npx playwright install chromium)',
111
+ }),
112
+ );
113
+ process.exit(2);
114
+ }
115
+
116
+ // ── Main ───────────────────────────────────────────────────────────────────────
117
+ (async () => {
118
+ const { chromium } = loadPlaywright();
119
+
120
+ let browser;
121
+ try {
122
+ browser = await chromium.launch();
123
+ } catch (_) {
124
+ // Chromium binary missing — try installing once
125
+ const { spawnSync } = require('child_process');
126
+ const r = spawnSync('npx', ['playwright', 'install', 'chromium'], {
127
+ stdio: 'inherit',
128
+ shell: true,
129
+ });
130
+ if (r.status !== 0) {
131
+ console.error(
132
+ JSON.stringify({
133
+ status: 'error',
134
+ error: 'Chromium not installed and auto-install failed',
135
+ hint: 'Run: npx playwright install chromium',
136
+ }),
137
+ );
138
+ process.exit(2);
139
+ }
140
+ browser = await chromium.launch();
141
+ }
142
+
143
+ try {
144
+ const page = await browser.newPage();
145
+ page.setDefaultTimeout(60_000);
146
+ page.setDefaultNavigationTimeout(60_000);
147
+
148
+ await page.goto(pageUrl, { waitUntil: 'networkidle', timeout: 60_000 });
149
+
150
+ // Wait for web fonts to actually load (otherwise body text falls back to
151
+ // a generic sans-serif while the snapshot is taken).
152
+ try {
153
+ await page.waitForFunction(() => document.fonts && document.fonts.ready, { timeout: 15_000 });
154
+ await page.evaluate(() => document.fonts.ready);
155
+ } catch (_) {
156
+ // Best effort — some pages have no @font-face; ignore.
157
+ }
158
+
159
+ // Extra settle window for Chart.js / lazy images / late JS.
160
+ if (waitMs > 0) await page.waitForTimeout(waitMs);
161
+
162
+ const pdfOpts = {
163
+ path: outFile,
164
+ format,
165
+ printBackground,
166
+ landscape,
167
+ scale,
168
+ margin: parseMargin(margin),
169
+ };
170
+ if (headerHtml || footerHtml) {
171
+ pdfOpts.displayHeaderFooter = true;
172
+ if (headerHtml) pdfOpts.headerTemplate = headerHtml;
173
+ if (footerHtml) pdfOpts.footerTemplate = footerHtml;
174
+ }
175
+
176
+ await page.pdf(pdfOpts);
177
+ await browser.close();
178
+
179
+ const stat = fs.statSync(outFile);
180
+ if (stat.size < 5000) {
181
+ console.error(
182
+ JSON.stringify({
183
+ status: 'error',
184
+ error: 'Output PDF is suspiciously small — page may be blank',
185
+ hint: 'Open the source HTML in a browser and check for render errors',
186
+ }),
187
+ );
188
+ process.exit(3);
189
+ }
190
+
191
+ console.log(
192
+ JSON.stringify({
193
+ status: 'ok',
194
+ out: outFile,
195
+ size_kb: Math.round(stat.size / 1024),
196
+ format,
197
+ landscape,
198
+ }),
199
+ );
200
+ } catch (e) {
201
+ if (browser) await browser.close().catch(() => {});
202
+ console.error(JSON.stringify({ status: 'error', error: String(e) }));
203
+ process.exit(3);
204
+ }
205
+ })();
File without changes
@@ -0,0 +1,124 @@
1
+ """Lint bounding-box geometry inside a fields.json config.
2
+
3
+ Catches the two mistakes operators make most often when hand-editing
4
+ ``fields.json``:
5
+
6
+ 1. **Overlapping rectangles** (slot vs. slot, slot vs. tag, tag vs.
7
+ tag), which cause text to land on top of other text.
8
+ 2. **Slot boxes that are too short** for the configured font size,
9
+ which clips glyphs.
10
+
11
+ The script returns exit code 0 only if no findings are produced.
12
+
13
+ Run from the skill root::
14
+
15
+ python -m scripts.validate.geometry_lint fields.json --max-findings 20
16
+ """
17
+
18
+ from __future__ import annotations
19
+
20
+ import json
21
+ import sys
22
+ from dataclasses import dataclass
23
+
24
+ from scripts.lib.cli_utils import make_parser
25
+ from scripts.lib.geometry import boxes_overlap
26
+
27
+
28
+ @dataclass
29
+ class BoxRecord:
30
+ bbox: list[float]
31
+ kind: str # "slot" or "tag"
32
+ owner: dict # the original slot dict
33
+
34
+
35
+ def _label_for(slot: dict) -> str:
36
+ return slot.get("description") or slot.get("tag_text") or "<unnamed>"
37
+
38
+
39
+ def lint(cfg_path: str, max_findings: int = 20) -> tuple[bool, list[str]]:
40
+ with open(cfg_path) as handle:
41
+ cfg = json.load(handle)
42
+
43
+ findings: list[str] = []
44
+ findings.append(f"Read {len(cfg['slots'])} slots from {cfg_path}")
45
+
46
+ boxes: list[BoxRecord] = []
47
+ for slot in cfg["slots"]:
48
+ if "tag_box" in slot:
49
+ boxes.append(BoxRecord(slot["tag_box"], "tag", slot))
50
+ if "slot_box" in slot:
51
+ boxes.append(BoxRecord(slot["slot_box"], "slot", slot))
52
+
53
+ failed = False
54
+
55
+ # --- intersection scan ---
56
+ for i, left in enumerate(boxes):
57
+ for right in boxes[i + 1 :]:
58
+ if left.owner["page_no"] != right.owner["page_no"]:
59
+ continue
60
+ if not boxes_overlap(left.bbox, right.bbox):
61
+ continue
62
+ failed = True
63
+ if left.owner is right.owner:
64
+ findings.append(
65
+ f"FAILURE: slot/tag overlap inside `{_label_for(left.owner)}`: "
66
+ f"{left.bbox} vs {right.bbox}"
67
+ )
68
+ else:
69
+ findings.append(
70
+ f"FAILURE: {left.kind} of `{_label_for(left.owner)}` "
71
+ f"({left.bbox}) overlaps {right.kind} of "
72
+ f"`{_label_for(right.owner)}` ({right.bbox})"
73
+ )
74
+ if len(findings) >= max_findings:
75
+ findings.append("Too many findings; aborting further checks.")
76
+ return True, findings
77
+
78
+ # --- height check ---
79
+ for record in boxes:
80
+ if record.kind != "slot":
81
+ continue
82
+ glyph_spec = record.owner.get("value")
83
+ if not glyph_spec:
84
+ continue
85
+ glyph_pt = glyph_spec.get("size", 14)
86
+ slot_h = record.bbox[3] - record.bbox[1]
87
+ if slot_h < glyph_pt:
88
+ failed = True
89
+ findings.append(
90
+ f"FAILURE: slot height {slot_h} for `{_label_for(record.owner)}` "
91
+ f"is shorter than glyph size {glyph_pt}; either grow the box or "
92
+ "shrink value.size."
93
+ )
94
+ if len(findings) >= max_findings:
95
+ findings.append("Too many findings; aborting further checks.")
96
+ return True, findings
97
+
98
+ if not failed:
99
+ findings.append("SUCCESS: all bounding boxes look sane.")
100
+ return failed, findings
101
+
102
+
103
+ def main(argv: list[str] | None = None) -> int:
104
+ parser = make_parser(
105
+ "geometry_lint",
106
+ "Validate bounding-box geometry inside a fields.json file.",
107
+ )
108
+ parser.add_argument("cfg_path", help="Path to fields.json.")
109
+ parser.add_argument(
110
+ "--max-findings",
111
+ type=int,
112
+ default=20,
113
+ help="Stop reporting after this many findings (default 20).",
114
+ )
115
+ args = parser.parse_args(argv)
116
+
117
+ failed, findings = lint(args.cfg_path, max_findings=args.max_findings)
118
+ for line in findings:
119
+ print(line)
120
+ return 1 if failed else 0
121
+
122
+
123
+ if __name__ == "__main__":
124
+ sys.exit(main())
@@ -0,0 +1,90 @@
1
+ # Templates Index
2
+
3
+ Eight production-grade PDF templates — every CREATE / REFORMAT skeleton renders via Playwright
4
+ HTML+CSS → PDF (no token pipeline, no LaTeX). Use them as starting points; copy, re-skin, and
5
+ render.
6
+
7
+ > **Diversity reminder.** Each skeleton ships with a baseline palette, fonts, and section ordering
8
+ > so the layout demo works out-of-the-box. **Adapt these to the user's brand, topic, mood, or
9
+ > audience every time** — do not return three different documents using the same bronze/gold (menu)
10
+ > or navy (research report) palette. Each README §7 lists the **structural invariants** you must
11
+ > keep and the **swappables** you should vary.
12
+
13
+ | Slug | Route | Use case | Trigger keywords |
14
+ | ------------------------- | -------------------- | ------------------------------------------------ | --------------------------------------------------------- |
15
+ | bilingual-menu-premium | CREATE | Premium bilingual menus | "menu", "bilingual menu", "餐厅菜单" |
16
+ | brand-guide-2page | CREATE | 2-page brand guide | "brand guide", "design system" |
17
+ | data-viz-report | CREATE | Chart-rich data analysis brief | "data report", "可视化", "benchmark", "图文报告" |
18
+ | multi-article-aggregator | CREATE | Article digest / anthology | "article digest", "newsletter" |
19
+ | multilang-research-report | CREATE | Multi-country research report | "research report", "regulatory survey" |
20
+ | reformat-default | REFORMAT | Default markdown / text / pdf reformat | "reformat", "markdown to PDF", "重排版" |
21
+ | translate-preserve-layout | REFORMAT | Translate while preserving layout | "translate PDF", "翻译保版" |
22
+ | form-fill-acroform | FILL | Government / official form fill | "fill form", "visa form", "签证表" |
23
+ | latex-technical-book | LATEX_TECHNICAL_BOOK | Chinese technical books / engineering monographs | "技术书", "源码解析书", "LaTeX 技术出版", "O'Reilly 风格" |
24
+
25
+ ## Usage
26
+
27
+ ### CREATE — copy a skeleton, fill placeholders, render
28
+
29
+ ```bash
30
+ # 1. Pick a template
31
+ cat templates/INDEX.md # the file you are reading
32
+ cat templates/<slug>/README.md # 7-section recipe (when-to-use → generalization)
33
+
34
+ # 2. Copy the skeleton + edit
35
+ cp templates/<slug>/skeleton.html /tmp/work/page.html
36
+ $EDITOR /tmp/work/page.html # replace <!-- PLACEHOLDER --> tokens
37
+
38
+ # 3. Render (15s settle if Chart.js is on the page)
39
+ bash scripts/make.sh render --in /tmp/work/page.html --out /tmp/work/out.pdf --wait 15000
40
+
41
+ # 4. Verify
42
+ pdfinfo /tmp/work/out.pdf | grep Pages
43
+ open /tmp/work/out.pdf
44
+ ```
45
+
46
+ ### REFORMAT — single-command markdown → PDF
47
+
48
+ ```bash
49
+ bash scripts/make.sh reformat \
50
+ --input doc.md --out report.pdf \
51
+ --title "My Report" --author "Jane" --accent "#0a7488"
52
+ ```
53
+
54
+ The `reformat-default` template is auto-applied. Pass `--template <slug>` to use a different
55
+ `templates/reformat-*/` skeleton.
56
+
57
+ ### FILL — see [form-fill-acroform/README.md](form-fill-acroform/README.md)
58
+
59
+ ```bash
60
+ bash scripts/make.sh fill probe form.pdf
61
+ ```
62
+
63
+ ## Per-template files
64
+
65
+ Each `templates/<slug>/` contains:
66
+
67
+ - `README.md` — the full seven-section recipe (when-to-use / pipeline / shape / visual / skeleton /
68
+ pitfalls / generalization).
69
+ - `skeleton.html` (or `skeleton.json` / `pipeline.md`) — a copy-and-edit starting point with
70
+ placeholders marked `<!-- PLACEHOLDER -->`.
71
+ - A small helper file when relevant (`terminology.template.json`, `field_values.template.json`).
72
+
73
+ ## Case exemplars
74
+
75
+ | Case | Source | Use when | Files |
76
+ | ---------------------------------------------- | ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
77
+ | Chinese technical book (LaTeX) | Structured HTML / Markdown chapters for a technical book | Long-form source-code reading or engineering book needs B5 book typography, O'Reilly-like cover, clickable TOC, code blocks, callouts, and diagrams; read `../docs/latex-technical-book-guide.md` first | `latex-technical-book/source.tex`; `latex-technical-book/README.md` |
78
+
79
+ ## When nothing matches
80
+
81
+ - Document is structurally close to a template → **adapt the closest one** and re-skin (palette +
82
+ cover archetype). Faster than from-zero authoring.
83
+ - Completely different shape → hand-author HTML following
84
+ [`../docs/html-pdf-spec.md`](../docs/html-pdf-spec.md) (the mechanical contract) and
85
+ [`../docs/design-guide.md`](../docs/design-guide.md) (the aesthetic contract). Copy individual
86
+ primitives (KPI grid, chart card, pill table, conclusion block) from
87
+ `data-viz-report/skeleton.html`.
88
+ - Still unsure → read a reference PDF first via the READ route:
89
+ `python3 -m scripts.read_pdf_vision --input <reference.pdf> --pages 1`, understand the structure,
90
+ then choose.