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,223 @@
1
+ # Cowork pipeline (pseudocode + key code blocks)
2
+
3
+ > This route has no single-file skeleton. Copy this document and
4
+ > implement the nine steps below. Each step ships with a Python skeleton
5
+ > (playwright + pypdf + reportlab).
6
+
7
+ ## 0. Input
8
+
9
+ ```json
10
+ // posts_list.json
11
+ [
12
+ {
13
+ "url": "https://example.com/blog/post-1",
14
+ "title": "Article Title",
15
+ "date": "2026-01-12",
16
+ "author": "Author Name",
17
+ "category": "category-slug",
18
+ "slug": "post-1"
19
+ }
20
+ ]
21
+ ```
22
+
23
+ ## 1. Fetch + clean DOM
24
+
25
+ ```python
26
+ import asyncio
27
+ from playwright.async_api import async_playwright
28
+
29
+ HIDE_CSS = """
30
+ nav, header, footer, [class*="nav_"], [class*="footer"],
31
+ [class*="related"], [class*="share"], [class*="cookie"],
32
+ [class*="newsletter"], iframe, video,
33
+ [style*="padding-bottom:56%"] { display: none !important; }
34
+ svg, [class*="icon"] { max-width: 64px; max-height: 64px; }
35
+ """
36
+
37
+ async def fetch_clean(url: str, out_pdf: str) -> None:
38
+ async with async_playwright() as p:
39
+ browser = await p.chromium.launch()
40
+ page = await browser.new_page(viewport={"width": 1024, "height": 1366})
41
+ await page.goto(url, wait_until="networkidle", timeout=60_000)
42
+
43
+ # Inject hide CSS, wait for fonts + images, scroll to load lazy content
44
+ await page.add_style_tag(content=HIDE_CSS)
45
+ await page.evaluate("document.fonts.ready")
46
+ await page.evaluate("window.scrollTo(0, document.body.scrollHeight)")
47
+ await page.wait_for_timeout(1800)
48
+ await page.evaluate("Promise.all(Array.from(document.images).map(i => i.complete ? null : new Promise(r => i.onload = r)))")
49
+
50
+ await page.pdf(
51
+ path=out_pdf,
52
+ format="A4",
53
+ margin={"top": "16mm", "bottom": "16mm", "left": "16mm", "right": "16mm"},
54
+ print_background=True,
55
+ )
56
+ await browser.close()
57
+ ```
58
+
59
+ ## 2. Per-article render (loop)
60
+
61
+ ```python
62
+ import json
63
+ from pathlib import Path
64
+
65
+ posts = json.loads(Path("posts_list.json").read_text())
66
+ for i, post in enumerate(posts, 1):
67
+ out = f"data/article-{i:02d}-{post['slug']}.pdf"
68
+ asyncio.run(fetch_clean(post["url"], out))
69
+ post["pdf_path"] = out
70
+ post["pages"] = page_count(out)
71
+ ```
72
+
73
+ ## 3. Compute page offsets (mock pass)
74
+
75
+ ```python
76
+ def page_count(pdf_path: str) -> int:
77
+ from pypdf import PdfReader
78
+ return len(PdfReader(pdf_path).pages)
79
+
80
+ mock_toc_pages = 1 # initial guess: TOC fits in 1 page
81
+ running = mock_toc_pages + 1
82
+ for post in posts:
83
+ post["start_page_mock"] = running
84
+ running += post["pages"]
85
+ ```
86
+
87
+ ## 4. TOC pass 1 (render with mock numbers, measure its own page count)
88
+
89
+ ```python
90
+ from reportlab.pdfgen import canvas
91
+ from reportlab.lib.pagesizes import A4
92
+ from reportlab.lib.units import mm
93
+
94
+ def build_toc(out_path: str, posts: list, page_field: str) -> int:
95
+ """Render TOC to out_path; return page count (1 or 2)."""
96
+ c = canvas.Canvas(out_path, pagesize=A4)
97
+ width, height = A4
98
+ margin_l = 22 * mm
99
+ margin_t = 22 * mm
100
+ y = height - margin_t
101
+
102
+ c.setFont("Helvetica-Bold", 22)
103
+ c.drawString(margin_l, y, "Table of Contents")
104
+ y -= 14 * mm
105
+
106
+ c.setFont("Helvetica-Oblique", 11)
107
+ c.drawString(margin_l, y, f"{len(posts)} articles - compiled {today_iso()}")
108
+ y -= 12 * mm
109
+
110
+ # Group by category, then iterate
111
+ by_cat: dict[str, list] = {}
112
+ for p in posts:
113
+ by_cat.setdefault(p.get("category", "_"), []).append(p)
114
+
115
+ for cat, group in by_cat.items():
116
+ c.setFont("Helvetica-Bold", 12)
117
+ c.drawString(margin_l, y, cat)
118
+ y -= 7 * mm
119
+ for j, p in enumerate(group, 1):
120
+ c.setFont("Helvetica", 10.5)
121
+ title_str = f"{j}. {p['title']}"
122
+ c.drawString(margin_l + 4 * mm, y, title_str[:80])
123
+ page_num = str(p[page_field])
124
+ c.drawRightString(width - margin_l, y, page_num)
125
+ # dot leader
126
+ c.setStrokeGray(0.6)
127
+ c.setDash(1, 2)
128
+ c.line(margin_l + 4 * mm + (len(title_str[:80]) * 5),
129
+ y - 1, width - margin_l - 8 * mm, y - 1)
130
+ c.setDash()
131
+ y -= 6 * mm
132
+ if y < 30 * mm:
133
+ c.showPage()
134
+ y = height - margin_t
135
+
136
+ c.save()
137
+ return page_count(out_path)
138
+ ```
139
+
140
+ Run pass 1:
141
+
142
+ ```python
143
+ toc_pages_v1 = build_toc("data/_toc_v1.pdf", posts, page_field="start_page_mock")
144
+ ```
145
+
146
+ ## 5. Merge pass 1
147
+
148
+ ```python
149
+ from pypdf import PdfWriter, PdfReader
150
+
151
+ def merge(out: str, parts: list[str]) -> None:
152
+ w = PdfWriter()
153
+ for f in parts:
154
+ for p in PdfReader(f).pages:
155
+ w.add_page(p)
156
+ with open(out, "wb") as fp:
157
+ w.write(fp)
158
+
159
+ merge("data/_combined_v1.pdf", ["data/_toc_v1.pdf"] + [p["pdf_path"] for p in posts])
160
+ ```
161
+
162
+ ## 6. Compute true page numbers (real TOC pages + cumulative article pages)
163
+
164
+ ```python
165
+ running = toc_pages_v1 + 1
166
+ for post in posts:
167
+ post["start_page_real"] = running
168
+ running += post["pages"]
169
+ ```
170
+
171
+ ## 7. TOC pass 2 + merge pass 2
172
+
173
+ ```python
174
+ toc_pages_v2 = build_toc("data/_toc_v2.pdf", posts, page_field="start_page_real")
175
+ assert toc_pages_v2 == toc_pages_v1, "TOC page count drifted; rerun pass-1 with corrected mock"
176
+
177
+ merge("output/final.pdf", ["data/_toc_v2.pdf"] + [p["pdf_path"] for p in posts])
178
+ ```
179
+
180
+ ## 8. Add outline / link annotations (optional)
181
+
182
+ ```python
183
+ from pypdf import PdfWriter, PdfReader
184
+
185
+ def add_outlines(in_pdf: str, out_pdf: str, posts: list) -> None:
186
+ r = PdfReader(in_pdf)
187
+ w = PdfWriter()
188
+ for p in r.pages:
189
+ w.add_page(p)
190
+ for post in posts:
191
+ w.add_outline_item(post["title"], post["start_page_real"] - 1) # 0-indexed
192
+ with open(out_pdf, "wb") as fp:
193
+ w.write(fp)
194
+
195
+ add_outlines("output/final.pdf", "output/final-with-outline.pdf", posts)
196
+ ```
197
+
198
+ ## 9. (Optional) Strip per-article trailing blank pages
199
+
200
+ ```python
201
+ def strip_trailing_blanks(pdf: str, out: str, threshold: float = 0.9) -> int:
202
+ """Return how many trailing pages were dropped (sparse < threshold% white)."""
203
+ # Render each page to PNG via pdftoppm, count white-pixel ratio, drop tail.
204
+ # Skipped here — see m16 reports/strip_manifest.json for the full algorithm.
205
+ ...
206
+ ```
207
+
208
+ After this step, **recompute offsets** and **rerun steps 4-7** because
209
+ the page count shifted.
210
+
211
+ ---
212
+
213
+ ## Checklist
214
+
215
+ - [ ] `posts_list.json` carries at least url / title / slug.
216
+ - [ ] Each `data/article-*.pdf` exists.
217
+ - [ ] `data/_toc_v1.pdf` page count == `data/_toc_v2.pdf` page count
218
+ (otherwise rerun pass 1).
219
+ - [ ] `pdfinfo output/final.pdf | grep Pages` equals
220
+ `toc_pages + sum(article pages)`.
221
+ - [ ] `pdfinfo output/final-with-outline.pdf` shows N outline entries.
222
+ - [ ] Spot-check five random TOC entries; the link jumps to the right
223
+ first page of the right article.
@@ -0,0 +1,136 @@
1
+ # multilang-research-report
2
+
3
+ > Multi-country regulatory survey template. Playwright HTML+CSS, A4 portrait, CJK multi-language
4
+ > font cascade, per-country sections + horizontal comparison table + references. For the production
5
+
6
+ ## 1. When to use
7
+
8
+ - **EN keywords**: research report, regulation, multi-country, cross-jurisdiction, deep research,
9
+ comparative study, policy analysis
10
+ - **CN keywords**: 监管、调研报告、多国对比、深度研究、跨国法律对比、行业研究、政策分析
11
+ - **Sample user asks**:
12
+ - "Produce a deep regulatory survey on global AI voice cloning, covering CN / EU / US / JP / KR —
13
+ each country needs laws, regulators, enforcement cases, and industry self-regulation."
14
+ - "Create a 50-60 page cross-jurisdictional regulatory comparison covering 5 countries with
15
+ horizontal comparison + 100+ sourced references."
16
+
17
+ ## 2. Pipeline
18
+
19
+ **Playwright HTML+CSS direct render -> PDF.** Does NOT use the token pipeline.
20
+
21
+ Why not the token pipeline:
22
+
23
+ - Multi-language CJK (SC / JP / KR) needs precise `@font-face` + `font-family` cascade control.
24
+ - 60 pages of structured prose + 6xN comparison tables + 100+ reference rows need full CSS control.
25
+ - The token pipeline's font fallback collapses on Korean hangul.
26
+
27
+ ## 3. Document shape
28
+
29
+ - **Pages**: ~50-90 (typical 59).
30
+ - **Structure**: cover -> exec summary -> TOC (dot leaders + page numbers) -> per-country x N
31
+ sections (4 subsections: laws / regulators / cases / self-regulation) -> horizontal comparison
32
+ table -> conclusion -> references -> appendices.
33
+ - **Page size**: A4 portrait.
34
+ - **Citations**: 150-200+, A/B/C reliability grading.
35
+
36
+ ## 4. Visual params
37
+
38
+ **Palette** (academic / governmental muted tone):
39
+
40
+ - Primary `#1a3d7c` navy (H1 + table headers)
41
+ - Text `#111` near-black
42
+ - Table zebra `#fafbfd` light
43
+ - Muted `#888` border
44
+
45
+ **Typography** (CJK cascade — **order matters**):
46
+
47
+ ```css
48
+ font-family:
49
+ 'PingFang SC',
50
+ /* CN simplified, primary */ 'Hiragino Sans',
51
+ /* JP fallback */ 'Apple SD Gothic Neo',
52
+ /* KR — required! Hiragino does NOT cover hangul */ 'Helvetica Neue',
53
+ /* Latin fallback */ sans-serif;
54
+ ```
55
+
56
+ **Layout**:
57
+
58
+ - TOC: dot leaders + right-aligned page numbers.
59
+ - Tables: `border-collapse`, 9.5pt body, navy header background, zebra even rows,
60
+ `page-break-inside: avoid`.
61
+ - Headings: H1 navy 20pt + 2.5pt underline (`page-break-before: always` except for the first
62
+ section), H2 14pt + left rule, H3 12pt muted navy.
63
+ - Line-height: 1.55-1.62 (CJK collision protection).
64
+ - Margins: 20 mm top / sides, 22 mm bottom.
65
+
66
+ ## 5. Skeleton
67
+
68
+ See [`skeleton.html`](skeleton.html) (~200 lines; one representative per-country section provided —
69
+ duplicate it per country in the loop).
70
+
71
+ **Quick start**:
72
+
73
+ ```bash
74
+ cp templates/multilang-research-report/skeleton.html /tmp/report/page.html
75
+ # Edit --primary in :root.
76
+ # Duplicate the per-country section for each of your N countries.
77
+ node packages/local-runtime/assets/skills/pdf/scripts/render_html.cjs /tmp/report/page.html /tmp/report/out.pdf
78
+ ```
79
+
80
+ ## 6. Pitfalls (from m15 production)
81
+
82
+ - **Hiragino does not cover Korean hangul** — fatal: Hiragino Kaku Gothic / Hiragino Sans cover SC +
83
+ JP, but Korean characters fail. **Apple SD Gothic Neo / Noto Sans CJK KR must be added explicitly
84
+ to the cascade.** Test by rendering "中日本국語" — all five characters must display correctly.
85
+ - **Last page < 1/3 full — P0 fail**: trigger content expansion (add a glossary / case timeline /
86
+ legislative evolution); **do not** shrink margins to force a fit.
87
+ - **Citation drift across N countries**: country A grades the ECJ as A, country B grades it as B.
88
+ **Freeze `references_master.md` within the first 3 iterations** to lock the A/B/C grading scheme.
89
+ - **Multi-language inline mixing** needs `lang="zh-CN"` / `lang="ko"` / `lang="ja"` on `<p>` /
90
+ `<td>` to enable correct hyphenation / line-breaking.
91
+ - **Table cell overflow**: 9pt + Korean + English URLs in a narrow column overflow. Use
92
+ `td { word-break: break-word; vertical-align: top; padding: 6pt; }`.
93
+ - **Cascade order**: SC -> JP -> KR -> Latin -> generic. Reordering causes tofu boxes.
94
+
95
+ ## 7. Generalization
96
+
97
+ **Required placeholders / swappable**:
98
+
99
+ - `JURISDICTION_COUNT` (5 is the baseline; 3-10 ok).
100
+ - `COUNTRY_LIST` -> loop structure: `COUNTRY_CODE` (CN/EU/US/KR/JP) / `COUNTRY_NAME` /
101
+ `LEGAL_FRAMEWORK_TEXT` / `STATUTE_NAMES` / ...
102
+ - `LAW_NAME` (per country x per section).
103
+ - `CASE_PARTIES` / `CASE_VERDICT` / `CASE_YEAR`.
104
+ - `DIMENSION_LIST` (6 baseline: legal hierarchy / core statutes / penalties / disclosure / effective
105
+ date / consent standard).
106
+ - Comparison-table column count = `JURISDICTION_COUNT + 1`.
107
+
108
+ **Optional sections**:
109
+
110
+ - Case studies (1-3 per country vs zero).
111
+ - Industry self-regulation (depends on the topic).
112
+ - Legislative timeline (track 3+ years of evolution).
113
+ - Cross-border enforcement cooperation (cross-border topics).
114
+
115
+ **Structural invariants**:
116
+
117
+ - Each section H1 has `page-break-before: always`.
118
+ - Subsections follow a fixed H2 order: §1 legal framework / §2 regulators / §3 cases / §4
119
+ self-regulation.
120
+ - One 6xN horizontal comparison table.
121
+ - References use `[CODE-##]` format (CN-1 / EU-27 / US-48).
122
+ - Last page is the appendices (acronym table, version stamp).
123
+
124
+ **Swappable subject domains** (verified path: AI voice cloning; generalises to: data privacy +
125
+ cross-border, chip export controls, crypto regulation, biometrics):
126
+
127
+ - Required: >= 3 jurisdictions + >= 2 statutes per jurisdiction +
128
+ > = 2 cases per jurisdiction + 50+ sources.
129
+ - Font stack stays put (CJK is critical).
130
+ - Comparison dimensions adapt (crypto: custody rules / AML / DeFi treatment).
131
+
132
+ **Diversify every run.** The §4 baseline (academic navy + zebra tables) is the m15 rendition of one
133
+ specific topic — do not paste it onto every research report. Adapt the primary color to match the
134
+ subject domain (privacy: green; chip export: industrial gray; crypto: amber), re-pick the table
135
+ accent, and re-cut the comparison dimensions per topic. Two reports on different subjects should
136
+ read as different publications, not two coats of paint on the same template.
@@ -0,0 +1,242 @@
1
+ <!DOCTYPE html>
2
+ <html lang="zh-CN">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <title><!-- REPORT_TITLE --></title>
6
+ <style>
7
+ @page {
8
+ size: A4;
9
+ margin: 20mm 18mm 22mm 18mm;
10
+ @bottom-center { content: "Page " counter(page) " of " counter(pages); font-size: 8pt; color: #888; }
11
+ }
12
+ @page :first { margin: 0; }
13
+ :root {
14
+ --primary: #1a3d7c;
15
+ --text: #111;
16
+ --muted: #555;
17
+ --rule: #888;
18
+ --zebra: #fafbfd;
19
+ --bq-bg: #f6f8fc;
20
+ --th-bg: #e8eef7;
21
+ }
22
+ html, body {
23
+ font-family:
24
+ "PingFang SC", /* CN simplified, primary */
25
+ "Hiragino Sans", /* JP fallback */
26
+ "Hiragino Kaku Gothic ProN",
27
+ "Apple SD Gothic Neo", /* KR — required, Hiragino does NOT cover hangul */
28
+ "Helvetica Neue", sans-serif;
29
+ font-size: 10.5pt;
30
+ line-height: 1.62;
31
+ color: var(--text);
32
+ margin: 0; padding: 0;
33
+ }
34
+ h1 {
35
+ page-break-before: always;
36
+ font-size: 20pt;
37
+ color: var(--primary);
38
+ border-bottom: 2.5pt solid var(--primary);
39
+ padding-bottom: 6pt;
40
+ margin: 0 0 14pt;
41
+ }
42
+ body > section:first-child h1 { page-break-before: avoid; }
43
+ h2 {
44
+ font-size: 14pt;
45
+ color: var(--primary);
46
+ border-left: 4pt solid var(--primary);
47
+ padding-left: 8pt;
48
+ margin: 18pt 0 8pt;
49
+ page-break-after: avoid;
50
+ }
51
+ h3 {
52
+ font-size: 12pt;
53
+ color: #2c4a7a;
54
+ margin: 12pt 0 6pt;
55
+ page-break-after: avoid;
56
+ }
57
+ p { margin: 4pt 0 6pt; text-align: justify; orphans: 2; widows: 2; }
58
+ table {
59
+ border-collapse: collapse;
60
+ width: 100%;
61
+ margin: 8pt 0;
62
+ font-size: 9.5pt;
63
+ }
64
+ table, th, td { border: 0.6pt solid var(--rule); }
65
+ th {
66
+ background: var(--th-bg);
67
+ color: var(--primary);
68
+ font-weight: 600;
69
+ padding: 4pt 6pt;
70
+ text-align: left;
71
+ }
72
+ td { padding: 4pt 6pt; vertical-align: top; word-break: break-word; }
73
+ tr:nth-child(even) td { background: var(--zebra); }
74
+
75
+ blockquote {
76
+ border-left: 3pt solid #b0b8c8;
77
+ background: var(--bq-bg);
78
+ padding: 6pt 10pt;
79
+ margin: 8pt 0;
80
+ color: var(--muted);
81
+ font-size: 10pt;
82
+ page-break-inside: avoid;
83
+ }
84
+
85
+ .cover-page {
86
+ text-align: center;
87
+ padding-top: 60mm;
88
+ page-break-after: always;
89
+ }
90
+ .cover-page h1 {
91
+ border: none;
92
+ font-size: 28pt;
93
+ color: #102a4c;
94
+ page-break-before: avoid;
95
+ }
96
+
97
+ .toc { page-break-after: always; }
98
+ .toc-row { display: grid; grid-template-columns: 1fr auto; gap: 8pt; padding: 3pt 0;
99
+ font-size: 10.5pt; border-bottom: 0.4pt dotted #ccc; }
100
+ .toc-row .num { color: var(--muted); font-variant-numeric: tabular-nums; }
101
+
102
+ section { page-break-before: always; }
103
+ section:first-child { page-break-before: avoid; }
104
+
105
+ /* === Screen-emulation: open in browser → looks like the A4 PDF =========== */
106
+ @media screen {
107
+ html { background: #d0d0d0; }
108
+ body { margin: 0; padding: 20px 0; }
109
+ body > section {
110
+ width: 210mm; min-height: 297mm; margin: 0 auto 20px;
111
+ background: #fff; box-shadow: 0 4px 24px rgba(0,0,0,0.18);
112
+ box-sizing: border-box; overflow: hidden;
113
+ }
114
+ }
115
+ </style>
116
+ </head>
117
+ <body>
118
+
119
+ <!-- ─── COVER ─────────────────────────────────────── -->
120
+ <section class="cover-page">
121
+ <h1><!-- REPORT_TITLE --></h1>
122
+ <p><strong><!-- SUBTITLE --></strong></p>
123
+ <p>Version: <!-- VERSION --> &middot; Date: <!-- DATE --> &middot; <!-- PAGE_COUNT_HINT --> pages</p>
124
+ </section>
125
+
126
+ <!-- ─── EXECUTIVE SUMMARY ─────────────────────────── -->
127
+ <section>
128
+ <h1>Executive Summary</h1>
129
+ <p><!-- 300-400 word abstract: scope, methodology, key findings, jurisdictions covered --></p>
130
+ </section>
131
+
132
+ <!-- ─── TABLE OF CONTENTS ─────────────────────────── -->
133
+ <section class="toc">
134
+ <h1>Contents</h1>
135
+ <!-- LOOP: TOC entries -->
136
+ <div class="toc-row"><span><!-- ENTRY_TITLE --></span><span class="num"><!-- PAGE --></span></div>
137
+ <!-- /LOOP -->
138
+ </section>
139
+
140
+ <!-- ─── HORIZONTAL COMPARISON ─────────────────────── -->
141
+ <section>
142
+ <h1><!-- JURISDICTION_COUNT -->-Country Comparative Analysis</h1>
143
+ <h2>Key Dimensions</h2>
144
+ <table>
145
+ <thead>
146
+ <tr>
147
+ <th>Dimension</th>
148
+ <!-- REPEAT FOR EACH COUNTRY: -->
149
+ <th lang="en"><!-- COUNTRY_NAME --></th>
150
+ <!-- /REPEAT -->
151
+ </tr>
152
+ </thead>
153
+ <tbody>
154
+ <!-- REPEAT FOR EACH DIMENSION (legal hierarchy / core statutes / penalties / disclosure / effective date / consent standard): -->
155
+ <tr>
156
+ <td><strong><!-- DIMENSION_NAME --></strong></td>
157
+ <!-- REPEAT FOR EACH COUNTRY: -->
158
+ <td><!-- DIMENSION_VALUE_FOR_COUNTRY --></td>
159
+ <!-- /REPEAT -->
160
+ </tr>
161
+ <!-- /REPEAT -->
162
+ </tbody>
163
+ </table>
164
+ </section>
165
+
166
+ <!-- ─── PER-COUNTRY DETAIL (REPEAT N TIMES) ───────── -->
167
+ <!-- For each country, copy this entire <section>, change lang="" + country name -->
168
+ <section lang="zh-CN">
169
+ <h1><!-- COUNTRY_NAME --> — Detailed Analysis</h1>
170
+
171
+ <h2>§1 Legal Framework &amp; Statutes</h2>
172
+ <p><!-- ~1000 words: primary legislation, regulatory hierarchy, key articles --></p>
173
+ <h3>Core Legal Sources</h3>
174
+ <ul>
175
+ <li><strong><!-- LAW_NAME --></strong> (<!-- YEAR -->): <!-- DESCRIPTION + key articles --></li>
176
+ <!-- REPEAT for additional laws -->
177
+ </ul>
178
+
179
+ <h2>§2 Regulatory Bodies &amp; Authority</h2>
180
+ <p><!-- ~600 words: which agencies, mandate, oversight structure --></p>
181
+ <h3>Primary Regulators</h3>
182
+ <ul>
183
+ <li><strong><!-- AGENCY_NAME --></strong> (<!-- ABBREV -->): <!-- MANDATE --></li>
184
+ </ul>
185
+
186
+ <h2>§3 Landmark Enforcement Cases</h2>
187
+ <p><!-- ~800 words: 2-3 case studies --></p>
188
+ <h3>Case: <!-- CASE_PARTIES --> (<!-- YEAR -->)</h3>
189
+ <ul>
190
+ <li><strong>Facts</strong>: <!-- CASE_FACTS --></li>
191
+ <li><strong>Legal claims</strong>: <!-- CLAIMS --></li>
192
+ <li><strong>Verdict</strong>: <!-- OUTCOME + PENALTY --></li>
193
+ <li><strong>Significance</strong>: <!-- WHY_LANDMARK --></li>
194
+ </ul>
195
+
196
+ <h2>§4 Industry Self-Regulation &amp; Soft Law</h2>
197
+ <p><!-- ~500 words: codes of conduct, voluntary standards --></p>
198
+ </section>
199
+ <!-- /REPEAT for each country -->
200
+
201
+ <!-- ─── REFERENCES ────────────────────────────────── -->
202
+ <section>
203
+ <h1>References &amp; Sources (<!-- TOTAL_REFS --> items)</h1>
204
+ <p><strong>Reliability grade:</strong> A = government primary source / B = professional authority / C = secondary synthesis</p>
205
+ <table>
206
+ <thead>
207
+ <tr><th>#</th><th>Title</th><th>Source / Institution</th><th>Date</th><th>Grade</th></tr>
208
+ </thead>
209
+ <tbody>
210
+ <!-- REPEAT for each reference (use code like CN-1, EU-27, US-48): -->
211
+ <tr>
212
+ <td>[<!-- REF_CODE -->]</td>
213
+ <td><!-- REF_TITLE --></td>
214
+ <td><!-- REF_INSTITUTION --></td>
215
+ <td><!-- REF_DATE --></td>
216
+ <td><!-- A|B|C --></td>
217
+ </tr>
218
+ <!-- /REPEAT -->
219
+ </tbody>
220
+ </table>
221
+ </section>
222
+
223
+ <!-- ─── APPENDICES ────────────────────────────────── -->
224
+ <section>
225
+ <h1>Appendices</h1>
226
+ <h2>A. Acronym Legend</h2>
227
+ <table>
228
+ <thead><tr><th>Abbrev</th><th>Full Form / Meaning</th></tr></thead>
229
+ <tbody>
230
+ <!-- REPEAT for each acronym: -->
231
+ <tr><td><!-- ABBREV --></td><td><!-- FULL --></td></tr>
232
+ <!-- /REPEAT -->
233
+ </tbody>
234
+ </table>
235
+ <h2>B. Methodology</h2>
236
+ <p><!-- ~300 words: how sources were selected, classification scheme --></p>
237
+ <h2>C. Version History</h2>
238
+ <p>v<!-- VERSION --> &middot; <!-- DATE --> &middot; Last review: <!-- LAST_REVIEW_DATE --></p>
239
+ </section>
240
+
241
+ </body>
242
+ </html>