alran 0.0.0-stage → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (505) hide show
  1. package/ALRAN_TOOLS_NOTICES.md +75 -0
  2. package/LICENSE +27 -0
  3. package/LICENSE-STATUS.md +21 -0
  4. package/NOTICE +6 -0
  5. package/README.md +284 -2
  6. package/THIRD_PARTY_NOTICES.md +113 -0
  7. package/alran-tools.js +3 -0
  8. package/assets/agents/_default/prompt-auto_classifier.md +185 -0
  9. package/assets/agents/_default/prompt-auto_classifier_extras.md +17 -0
  10. package/assets/agents/_default/prompt-base-all.md +133 -0
  11. package/assets/agents/_default/prompt-base-all.md.hbs +228 -0
  12. package/assets/agents/_default/prompt-base-windows.md +5 -0
  13. package/assets/agents/_default/prompt-base-windows.md.hbs +5 -0
  14. package/assets/agents/_default/prompt-base-worker.md +10 -0
  15. package/assets/agents/_default/prompt-base-worker.md.hbs +27 -0
  16. package/assets/agents/_default/prompt-compact.md +76 -0
  17. package/assets/agents/_default/prompt-compact_continue.md +9 -0
  18. package/assets/agents/_default/prompt-git.md +8 -0
  19. package/assets/agents/_default/prompt-goal.md +13 -0
  20. package/assets/agents/_default/prompt-session-branch.md +3 -0
  21. package/assets/agents/_default/prompt-session-branch.md.hbs +30 -0
  22. package/assets/agents/_default/prompt-session-root.md +3 -0
  23. package/assets/agents/_default/prompt-session-root.md.hbs +32 -0
  24. package/assets/agents/_default/prompt-title.md +11 -0
  25. package/assets/agents/_default/prompt-tool_agent.md +22 -0
  26. package/assets/agents/_migration/README.md +20 -0
  27. package/assets/agents/_migration/coder/PERSONA.md +11 -0
  28. package/assets/agents/_migration/coder/system-prompt.md.hbs +42 -0
  29. package/assets/agents/_migration/general/PERSONA.md +11 -0
  30. package/assets/agents/_migration/general/system-prompt.md.hbs +49 -0
  31. package/assets/agents/_v2/AGENT_CONTEXT.md.hbs +245 -0
  32. package/assets/agents/_v2/PTC_TOOL_CALLS.md.hbs +35 -0
  33. package/assets/agents/_v2/coding/SYSTEM.md.hbs +173 -0
  34. package/assets/agents/_v2/explore.md.hbs +38 -0
  35. package/assets/agents/_v2/tui/SYSTEM.md.hbs +211 -0
  36. package/assets/agents/_v2/verifier.md.hbs +32 -0
  37. package/assets/agents/_v2/work/SYSTEM.md.hbs +186 -0
  38. package/assets/agents/_v2/worker.md.hbs +27 -0
  39. package/assets/agents/alran/PERSONA.md +7 -0
  40. package/assets/agents/alran/features/cron.md.hbs +0 -0
  41. package/assets/agents/alran/features/delegation.md.hbs +56 -0
  42. package/assets/agents/alran/features/memory.md.hbs +61 -0
  43. package/assets/agents/alran/features/recoverable-deletion.md.hbs +10 -0
  44. package/assets/agents/alran/features/task-management.md.hbs +11 -0
  45. package/assets/agents/alran/features/web-search.md.hbs +11 -0
  46. package/assets/agents/alran/modes/coding/online/PERSONA.md.hbs +20 -0
  47. package/assets/agents/alran/modes/coding/online/SYSTEM.md.hbs +158 -0
  48. package/assets/agents/alran/modes/work/online/PERSONA.md.hbs +20 -0
  49. package/assets/agents/alran/modes/work/online/SYSTEM.md.hbs +160 -0
  50. package/assets/agents/alran/prompt-session-root.md +4 -0
  51. package/assets/agents/alran/prompt-session-root.md.hbs +4 -0
  52. package/assets/agents/alran/skills/alran-code-product/SKILL.md +72 -0
  53. package/assets/agents/alran/skills/alran-code-product/references/account-models.md +64 -0
  54. package/assets/agents/alran/skills/alran-code-product/references/agents.md +34 -0
  55. package/assets/agents/alran/skills/alran-code-product/references/extensions.md +46 -0
  56. package/assets/agents/alran/skills/alran-code-product/references/workflows.md +56 -0
  57. package/assets/agents/alran/skills/control-in-app-browser/SKILL.md +590 -0
  58. package/assets/agents/alran/system-prompt.md.hbs +97 -0
  59. package/assets/agents/builtin-agents.json +1 -0
  60. package/assets/agents/desktop-task/archive-title/system-en.md +1 -0
  61. package/assets/agents/desktop-task/checkpoint/system.md +19 -0
  62. package/assets/agents/desktop-task/output-revision/system.md +1 -0
  63. package/assets/agents/desktop-task/retry/continuation.md +4 -0
  64. package/assets/agents/desktop-task/session-title/system.md +41 -0
  65. package/assets/agents/explore/PERSONA.md +8 -0
  66. package/assets/agents/explore/agent.md +14 -0
  67. package/assets/agents/explore/system-prompt.md.hbs +35 -0
  68. package/assets/agents/greeting.md +61 -0
  69. package/assets/agents/managed-prompts.json +47 -0
  70. package/assets/agents/prompt-exemptions.json +36 -0
  71. package/assets/agents/verifier/PERSONA.md +8 -0
  72. package/assets/agents/verifier/agent.md +17 -0
  73. package/assets/agents/verifier/system-prompt.md.hbs +28 -0
  74. package/assets/agents/worker/PERSONA.md +8 -0
  75. package/assets/agents/worker/agent.md +18 -0
  76. package/assets/agents/worker/system-prompt.md.hbs +22 -0
  77. package/assets/agents/workflow/code-review/review-candidates.md +120 -0
  78. package/assets/agents/workflow/code-review/reviewer-system.md +75 -0
  79. package/assets/agents/workflow/goal/budget-limit.md +16 -0
  80. package/assets/agents/workflow/goal/continuation.md +62 -0
  81. package/assets/agents/workflow/goal/objective-updated.md +16 -0
  82. package/assets/agents/workflow/goal/recovery-terminal-audit.md +13 -0
  83. package/assets/agents/workflow/goal/recovery.md +11 -0
  84. package/assets/agents/workflow/goal/terminal-audit.md +10 -0
  85. package/assets/agents/workflow/plan-mode/agent-entry.md +72 -0
  86. package/assets/agents/workflow/prompt-hook/system.md +0 -0
  87. package/assets/models-dev-catalog.json.gz +0 -0
  88. package/assets/prompts/code-review/review-candidates.md +120 -0
  89. package/assets/prompts/code-review/reviewer-system.md +75 -0
  90. package/assets/skills/alran-tools-master/SKILL.md +127 -0
  91. package/assets/skills/code-review/SKILL.md +51 -0
  92. package/assets/skills/cu-desktop/SKILL.md +255 -0
  93. package/assets/skills/deep-research/SKILL.md +30 -0
  94. package/assets/skills/deploy-website/SKILL.md +52 -0
  95. package/assets/skills/docx/LICENSE +21 -0
  96. package/assets/skills/docx/SKILL.md +259 -0
  97. package/assets/skills/docx/assets/styles/academic_styles.xml +250 -0
  98. package/assets/skills/docx/assets/styles/corporate_styles.xml +284 -0
  99. package/assets/skills/docx/assets/styles/default_styles.xml +449 -0
  100. package/assets/skills/docx/assets/xsd/aesthetic-rules.xsd +470 -0
  101. package/assets/skills/docx/assets/xsd/business-rules.xsd +130 -0
  102. package/assets/skills/docx/assets/xsd/common-types.xsd +159 -0
  103. package/assets/skills/docx/assets/xsd/wml-subset.xsd +589 -0
  104. package/assets/skills/docx/docs/acceptance-checklists/create.md +7 -0
  105. package/assets/skills/docx/docs/acceptance-checklists/edit.md +6 -0
  106. package/assets/skills/docx/docs/acceptance-checklists/layout-repair.md +7 -0
  107. package/assets/skills/docx/docs/acceptance-checklists/template.md +6 -0
  108. package/assets/skills/docx/docs/acceptance.md +139 -0
  109. package/assets/skills/docx/docs/anti-patterns.md +14 -0
  110. package/assets/skills/docx/docs/backends.md +116 -0
  111. package/assets/skills/docx/docs/evidence.md +73 -0
  112. package/assets/skills/docx/docs/failure-taxonomy.md +71 -0
  113. package/assets/skills/docx/docs/index.md +50 -0
  114. package/assets/skills/docx/docs/rendered-delivery.md +125 -0
  115. package/assets/skills/docx/docs/router.md +122 -0
  116. package/assets/skills/docx/docs/tables-and-numbering.md +27 -0
  117. package/assets/skills/docx/docs/task-apply-template.md +141 -0
  118. package/assets/skills/docx/docs/task-compare-two-docx.md +48 -0
  119. package/assets/skills/docx/docs/task-create.md +124 -0
  120. package/assets/skills/docx/docs/task-edit-fill.md +69 -0
  121. package/assets/skills/docx/docs/task-read-content.md +148 -0
  122. package/assets/skills/docx/docs/task-read-rendered.md +78 -0
  123. package/assets/skills/docx/docs/task-read-structure.md +93 -0
  124. package/assets/skills/docx/docs/task-repair-layout.md +70 -0
  125. package/assets/skills/docx/docs/template-dsl.md +32 -0
  126. package/assets/skills/docx/docs/track-changes.md +15 -0
  127. package/assets/skills/docx/docs/xml-patch-dsl.md +33 -0
  128. package/assets/skills/docx/references/cjk_typography.md +357 -0
  129. package/assets/skills/docx/references/cjk_university_template_guide.md +184 -0
  130. package/assets/skills/docx/references/comments_guide.md +191 -0
  131. package/assets/skills/docx/references/design_good_bad_examples.md +829 -0
  132. package/assets/skills/docx/references/design_principles.md +819 -0
  133. package/assets/skills/docx/references/openxml_element_order.md +308 -0
  134. package/assets/skills/docx/references/openxml_encyclopedia_part1.md +4061 -0
  135. package/assets/skills/docx/references/openxml_encyclopedia_part2.md +2820 -0
  136. package/assets/skills/docx/references/openxml_encyclopedia_part3.md +3381 -0
  137. package/assets/skills/docx/references/openxml_namespaces.md +82 -0
  138. package/assets/skills/docx/references/openxml_units.md +72 -0
  139. package/assets/skills/docx/references/sample-patch-plans.json +22 -0
  140. package/assets/skills/docx/references/sample-task-intents.json +5 -0
  141. package/assets/skills/docx/references/sample-template-manifests.json +21 -0
  142. package/assets/skills/docx/references/scenario_a_create.md +284 -0
  143. package/assets/skills/docx/references/scenario_b_edit_content.md +295 -0
  144. package/assets/skills/docx/references/scenario_c_apply_template.md +456 -0
  145. package/assets/skills/docx/references/track_changes_guide.md +200 -0
  146. package/assets/skills/docx/references/troubleshooting.md +506 -0
  147. package/assets/skills/docx/references/typography_guide.md +294 -0
  148. package/assets/skills/docx/references/xsd_validation_guide.md +158 -0
  149. package/assets/skills/docx/scripts/build_patch_plan.py +29 -0
  150. package/assets/skills/docx/scripts/diff_docx_structure.py +61 -0
  151. package/assets/skills/docx/scripts/doc_to_docx.ps1 +85 -0
  152. package/assets/skills/docx/scripts/doc_to_docx.sh +40 -0
  153. package/assets/skills/docx/scripts/docx_preview.ps1 +76 -0
  154. package/assets/skills/docx/scripts/docx_preview.sh +37 -0
  155. package/assets/skills/docx/scripts/docx_to_pdf.py +87 -0
  156. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/AlranAIDocx.Cli.csproj +19 -0
  157. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/Program.cs +18 -0
  158. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/AlranAIDocx.Core.csproj +15 -0
  159. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/AnalyzeCommand.cs +147 -0
  160. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ApplyTemplateCommand.cs +322 -0
  161. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/CreateCommand.cs +324 -0
  162. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/DiffCommand.cs +155 -0
  163. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/EditContentCommand.cs +487 -0
  164. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/FixOrderCommand.cs +108 -0
  165. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/MergeRunsCommand.cs +122 -0
  166. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ValidateCommand.cs +107 -0
  167. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/CommentSynchronizer.cs +169 -0
  168. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/ElementOrder.cs +80 -0
  169. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/NamespaceConstants.cs +42 -0
  170. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/RunMerger.cs +81 -0
  171. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/StyleAnalyzer.cs +81 -0
  172. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/TrackChangesHelper.cs +99 -0
  173. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/UnitConverter.cs +23 -0
  174. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples.cs +1832 -0
  175. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch1.cs +910 -0
  176. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch2.cs +999 -0
  177. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch3.cs +1048 -0
  178. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch4.cs +1038 -0
  179. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/CharacterFormattingSamples.cs +1020 -0
  180. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/DocumentCreationSamples.cs +1121 -0
  181. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FieldAndTocSamples.cs +624 -0
  182. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FootnoteAndCommentSamples.cs +675 -0
  183. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/HeaderFooterSamples.cs +838 -0
  184. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ImageSamples.cs +917 -0
  185. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ListAndNumberingSamples.cs +826 -0
  186. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ParagraphFormattingSamples.cs +1199 -0
  187. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/StyleSystemSamples.cs +1487 -0
  188. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TableSamples.cs +1163 -0
  189. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TrackChangesSamples.cs +595 -0
  190. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/CjkHelper.cs +39 -0
  191. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/FontDefaults.cs +24 -0
  192. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/PageSizes.cs +20 -0
  193. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/BusinessRuleValidator.cs +224 -0
  194. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/GateCheckValidator.cs +148 -0
  195. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/ValidationResult.cs +23 -0
  196. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/XsdValidator.cs +69 -0
  197. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.slnx +4 -0
  198. package/assets/skills/docx/scripts/env_check.ps1 +327 -0
  199. package/assets/skills/docx/scripts/env_check.sh +340 -0
  200. package/assets/skills/docx/scripts/extract_docx_text.py +1075 -0
  201. package/assets/skills/docx/scripts/pack_docx.py +31 -0
  202. package/assets/skills/docx/scripts/read_docx_structure.py +1032 -0
  203. package/assets/skills/docx/scripts/render_docx_pages.py +147 -0
  204. package/assets/skills/docx/scripts/rendered_report.py +609 -0
  205. package/assets/skills/docx/scripts/setup.ps1 +542 -0
  206. package/assets/skills/docx/scripts/setup.sh +537 -0
  207. package/assets/skills/docx/scripts/unpack_docx.py +29 -0
  208. package/assets/skills/docx/scripts/validate_template_manifest.py +60 -0
  209. package/assets/skills/docx/scripts/verify_anchor_atomicity.py +87 -0
  210. package/assets/skills/edit-deployed-website/SKILL.md +27 -0
  211. package/assets/skills/init/SKILL.md +135 -0
  212. package/assets/skills/llm-call/SKILL.md +48 -0
  213. package/assets/skills/llm-call/scripts/llm_call.py +458 -0
  214. package/assets/skills/pdf/SKILL.md +280 -0
  215. package/assets/skills/pdf/docs/advanced-reference.md +711 -0
  216. package/assets/skills/pdf/docs/create-guide.md +437 -0
  217. package/assets/skills/pdf/docs/design-guide.md +204 -0
  218. package/assets/skills/pdf/docs/forms-guide.md +462 -0
  219. package/assets/skills/pdf/docs/html-pdf-spec.md +500 -0
  220. package/assets/skills/pdf/docs/latex-academic-thesis-guide.md +233 -0
  221. package/assets/skills/pdf/docs/latex-technical-book-guide.md +112 -0
  222. package/assets/skills/pdf/docs/pitfalls-index.md +792 -0
  223. package/assets/skills/pdf/docs/read-guide.md +358 -0
  224. package/assets/skills/pdf/docs/reformat-guide.md +238 -0
  225. package/assets/skills/pdf/docs/skill-readme-archive.md +151 -0
  226. package/assets/skills/pdf/docs/troubleshooting.md +86 -0
  227. package/assets/skills/pdf/docs/vision-guide.md +188 -0
  228. package/assets/skills/pdf/scripts/__init__.py +0 -0
  229. package/assets/skills/pdf/scripts/_pdf_read_lib.py +284 -0
  230. package/assets/skills/pdf/scripts/fill/__init__.py +0 -0
  231. package/assets/skills/pdf/scripts/fill/acroform_apply.py +153 -0
  232. package/assets/skills/pdf/scripts/fill/overlay_apply.py +109 -0
  233. package/assets/skills/pdf/scripts/lib/__init__.py +0 -0
  234. package/assets/skills/pdf/scripts/lib/acroform_io.py +170 -0
  235. package/assets/skills/pdf/scripts/lib/cli_utils.py +41 -0
  236. package/assets/skills/pdf/scripts/lib/geometry.py +79 -0
  237. package/assets/skills/pdf/scripts/make.sh +388 -0
  238. package/assets/skills/pdf/scripts/merge.py +112 -0
  239. package/assets/skills/pdf/scripts/pdf_inspect/__init__.py +0 -0
  240. package/assets/skills/pdf/scripts/pdf_inspect/acroform_inspect.py +52 -0
  241. package/assets/skills/pdf/scripts/pdf_inspect/acroform_probe.py +57 -0
  242. package/assets/skills/pdf/scripts/pdf_inspect/layout_scan.py +164 -0
  243. package/assets/skills/pdf/scripts/read_pdf_vision.py +473 -0
  244. package/assets/skills/pdf/scripts/reformat_parse.py +181 -0
  245. package/assets/skills/pdf/scripts/render/__init__.py +0 -0
  246. package/assets/skills/pdf/scripts/render/overlay_preview.py +86 -0
  247. package/assets/skills/pdf/scripts/render/page_rasterize.py +85 -0
  248. package/assets/skills/pdf/scripts/render_html.cjs +205 -0
  249. package/assets/skills/pdf/scripts/validate/__init__.py +0 -0
  250. package/assets/skills/pdf/scripts/validate/geometry_lint.py +124 -0
  251. package/assets/skills/pdf/templates/INDEX.md +90 -0
  252. package/assets/skills/pdf/templates/bilingual-menu-premium/README.md +175 -0
  253. package/assets/skills/pdf/templates/bilingual-menu-premium/skeleton.html +343 -0
  254. package/assets/skills/pdf/templates/brand-guide-2page/README.md +140 -0
  255. package/assets/skills/pdf/templates/brand-guide-2page/skeleton.html +264 -0
  256. package/assets/skills/pdf/templates/data-viz-report/README.md +234 -0
  257. package/assets/skills/pdf/templates/data-viz-report/skeleton.html +835 -0
  258. package/assets/skills/pdf/templates/form-fill-acroform/README.md +195 -0
  259. package/assets/skills/pdf/templates/form-fill-acroform/field_values.template.json +118 -0
  260. package/assets/skills/pdf/templates/latex-academic-thesis/README.md +146 -0
  261. package/assets/skills/pdf/templates/latex-academic-thesis/source.tex +334 -0
  262. package/assets/skills/pdf/templates/latex-technical-book/README.md +130 -0
  263. package/assets/skills/pdf/templates/latex-technical-book/README.template-source.md +62 -0
  264. package/assets/skills/pdf/templates/latex-technical-book/source.tex +439 -0
  265. package/assets/skills/pdf/templates/multi-article-aggregator/README.md +148 -0
  266. package/assets/skills/pdf/templates/multi-article-aggregator/pipeline.md +223 -0
  267. package/assets/skills/pdf/templates/multilang-research-report/README.md +136 -0
  268. package/assets/skills/pdf/templates/multilang-research-report/skeleton.html +242 -0
  269. package/assets/skills/pdf/templates/reformat-default/README.md +136 -0
  270. package/assets/skills/pdf/templates/reformat-default/skeleton.html +204 -0
  271. package/assets/skills/pdf/templates/translate-preserve-layout/README.md +136 -0
  272. package/assets/skills/pdf/templates/translate-preserve-layout/skeleton.html +96 -0
  273. package/assets/skills/pdf/templates/translate-preserve-layout/terminology.template.json +66 -0
  274. package/assets/skills/pptx/SKILL.md +283 -0
  275. package/assets/skills/pptx/references/design-system.md +424 -0
  276. package/assets/skills/pptx/references/editing.md +162 -0
  277. package/assets/skills/pptx/references/element-map.md +229 -0
  278. package/assets/skills/pptx/references/pitfalls.md +205 -0
  279. package/assets/skills/pptx/references/pptxgenjs.md +420 -0
  280. package/assets/skills/pptx/references/preview-selection-writeback.md +65 -0
  281. package/assets/skills/pptx/references/python-pptx-recipes.md +63 -0
  282. package/assets/skills/pptx/references/slide-types.md +413 -0
  283. package/assets/skills/pptx/scripts/alran-ppt-map.cjs +280 -0
  284. package/assets/skills/pptx/scripts/audit_pptx.py +708 -0
  285. package/assets/skills/pptx/scripts/extract_comments.py +468 -0
  286. package/assets/skills/pptx/scripts/extract_images.py +226 -0
  287. package/assets/skills/pptx/scripts/extract_pptx.py +285 -0
  288. package/assets/skills/pptx/scripts/pdf2png.swift +203 -0
  289. package/assets/skills/pptx/scripts/pptx-screenshot.sh +105 -0
  290. package/assets/skills/resume-codex/SKILL.md +53 -0
  291. package/assets/skills/resume-codex/scripts/session-reader.mjs +445 -0
  292. package/assets/skills/skill-creator/SKILL.md +188 -0
  293. package/assets/skills/skill-creator/references/anti-patterns.md +149 -0
  294. package/assets/skills/skill-creator/references/commands-macos-linux.md +38 -0
  295. package/assets/skills/skill-creator/references/commands-windows-powershell.md +48 -0
  296. package/assets/skills/skill-creator/references/description-rubric.md +83 -0
  297. package/assets/skills/skill-creator/references/skill-template.md +101 -0
  298. package/assets/skills/skill-creator/references/when-to-bundle-scripts.md +139 -0
  299. package/assets/skills/skill-creator/scripts/lint-skill.js +226 -0
  300. package/assets/skills/skill-refiner/SKILL.md +137 -0
  301. package/assets/skills/visual-page/SKILL.md +194 -0
  302. package/assets/skills/x-link-reader/SKILL.md +108 -0
  303. package/assets/skills/xlsx/SKILL.md +498 -0
  304. package/assets/skills/xlsx/docs/advanced-reference.md +410 -0
  305. package/assets/skills/xlsx/docs/conventions-guide.md +217 -0
  306. package/assets/skills/xlsx/docs/create-edit-guide.md +410 -0
  307. package/assets/skills/xlsx/docs/pitfalls-index.md +759 -0
  308. package/assets/skills/xlsx/docs/raw-xml-escape-hatch.md +201 -0
  309. package/assets/skills/xlsx/docs/recalc-guide.md +295 -0
  310. package/assets/skills/xlsx/scripts/office/helpers/__init__.py +0 -0
  311. package/assets/skills/xlsx/scripts/office/helpers/merge_runs.py +199 -0
  312. package/assets/skills/xlsx/scripts/office/helpers/simplify_redlines.py +197 -0
  313. package/assets/skills/xlsx/scripts/office/pack.py +159 -0
  314. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
  315. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
  316. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
  317. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
  318. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
  319. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
  320. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
  321. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
  322. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
  323. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
  324. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
  325. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
  326. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
  327. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
  328. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
  329. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
  330. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
  331. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
  332. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
  333. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
  334. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
  335. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
  336. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
  337. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
  338. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
  339. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
  340. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
  341. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
  342. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
  343. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
  344. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
  345. package/assets/skills/xlsx/scripts/office/schemas/mce/mc.xsd +75 -0
  346. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2010.xsd +560 -0
  347. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2012.xsd +67 -0
  348. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2018.xsd +14 -0
  349. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cex-2018.xsd +20 -0
  350. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cid-2016.xsd +13 -0
  351. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
  352. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-symex-2015.xsd +8 -0
  353. package/assets/skills/xlsx/scripts/office/soffice.py +191 -0
  354. package/assets/skills/xlsx/scripts/office/unpack.py +132 -0
  355. package/assets/skills/xlsx/scripts/office/validate.py +117 -0
  356. package/assets/skills/xlsx/scripts/office/validators/__init__.py +15 -0
  357. package/assets/skills/xlsx/scripts/office/validators/base.py +851 -0
  358. package/assets/skills/xlsx/scripts/office/validators/docx.py +446 -0
  359. package/assets/skills/xlsx/scripts/office/validators/pptx.py +275 -0
  360. package/assets/skills/xlsx/scripts/office/validators/redlining.py +247 -0
  361. package/assets/skills/xlsx/scripts/recalc.py +450 -0
  362. package/chunks/account-commands-GW7N3MYC.js +2 -0
  363. package/chunks/anthropic-63VE6MAE.js +2 -0
  364. package/chunks/application-WPPTE6LU.js +2 -0
  365. package/chunks/auth-command-36RMNQZW.js +2 -0
  366. package/chunks/azure-openai-responses-OIP3KVKJ.js +2 -0
  367. package/chunks/chunk-2AYWJZ72.js +2 -0
  368. package/chunks/chunk-2K5H5GA7.js +2 -0
  369. package/chunks/chunk-2TF6JAQM.js +2 -0
  370. package/chunks/chunk-3AODGLMF.js +2 -0
  371. package/chunks/chunk-3GGKARES.js +2 -0
  372. package/chunks/chunk-4CN3IJFH.js +2 -0
  373. package/chunks/chunk-4XP5XUIZ.js +2 -0
  374. package/chunks/chunk-5DQTVSQV.js +131 -0
  375. package/chunks/chunk-5RIMHTEU.js +207 -0
  376. package/chunks/chunk-5Y76VFHY.js +2 -0
  377. package/chunks/chunk-6DOVXX7W.js +2 -0
  378. package/chunks/chunk-6P4UKHGR.js +2 -0
  379. package/chunks/chunk-6PFI65C6.js +5 -0
  380. package/chunks/chunk-6UXSIWCB.js +2 -0
  381. package/chunks/chunk-7XYOYZX2.js +2 -0
  382. package/chunks/chunk-AGUSPIUP.js +2 -0
  383. package/chunks/chunk-BQ3CF3KE.js +2 -0
  384. package/chunks/chunk-C6LAAFG2.js +30 -0
  385. package/chunks/chunk-CUG7F2FN.js +2 -0
  386. package/chunks/chunk-D66ZSHXR.js +2 -0
  387. package/chunks/chunk-D7MGU75P.js +2 -0
  388. package/chunks/chunk-DFMYLGVU.js +249 -0
  389. package/chunks/chunk-EJN3SE5B.js +16 -0
  390. package/chunks/chunk-F46IELF5.js +2 -0
  391. package/chunks/chunk-G5MOGPZ3.js +6711 -0
  392. package/chunks/chunk-GP52JZMY.js +2 -0
  393. package/chunks/chunk-HNWBFJNO.js +2 -0
  394. package/chunks/chunk-IC6A323Q.js +2 -0
  395. package/chunks/chunk-IN2Z5SSJ.js +164 -0
  396. package/chunks/chunk-JSTSFMGK.js +70 -0
  397. package/chunks/chunk-K5DTFR6D.js +29 -0
  398. package/chunks/chunk-LCC45PCZ.js +29 -0
  399. package/chunks/chunk-LU4RPLJ3.js +2 -0
  400. package/chunks/chunk-LZJYNT32.js +2 -0
  401. package/chunks/chunk-MACBL5HF.js +2 -0
  402. package/chunks/chunk-MPQ6G7LH.js +1085 -0
  403. package/chunks/chunk-MUXNNOSQ.js +3 -0
  404. package/chunks/chunk-N5NTXCJI.js +2 -0
  405. package/chunks/chunk-N6W7ZL26.js +2 -0
  406. package/chunks/chunk-NBONSNQZ.js +38 -0
  407. package/chunks/chunk-NMKRNU5O.js +2 -0
  408. package/chunks/chunk-NVPGGFT3.js +2 -0
  409. package/chunks/chunk-NZXJAHTO.js +9 -0
  410. package/chunks/chunk-OTDNOWXG.js +16 -0
  411. package/chunks/chunk-PCL2CVVE.js +2 -0
  412. package/chunks/chunk-PXH4SBCS.js +3 -0
  413. package/chunks/chunk-QKBN5CGI.js +2 -0
  414. package/chunks/chunk-QPGTKSIQ.js +2 -0
  415. package/chunks/chunk-R44C5DM6.js +2 -0
  416. package/chunks/chunk-RLJVY75P.js +28 -0
  417. package/chunks/chunk-RLND4AYL.js +4 -0
  418. package/chunks/chunk-SIOLUFGG.js +2 -0
  419. package/chunks/chunk-TJC4LPRQ.js +2 -0
  420. package/chunks/chunk-U3RMPDXU.js +2 -0
  421. package/chunks/chunk-U4PFHJ7Z.js +27 -0
  422. package/chunks/chunk-UJCAE7SG.js +3 -0
  423. package/chunks/chunk-V2SB4U4D.js +2 -0
  424. package/chunks/chunk-VGKKKM2W.js +6 -0
  425. package/chunks/chunk-VLXX22YO.js +2 -0
  426. package/chunks/chunk-VUISZDXX.js +24 -0
  427. package/chunks/chunk-W5ZOLW7T.js +2 -0
  428. package/chunks/chunk-WHD2XVT2.js +2 -0
  429. package/chunks/chunk-XLVABFJC.js +9 -0
  430. package/chunks/chunk-XQK7JM66.js +2 -0
  431. package/chunks/chunk-XSEU4WQD.js +7 -0
  432. package/chunks/chunk-XVGPB7TW.js +21 -0
  433. package/chunks/chunk-Z5HOCNTZ.js +2 -0
  434. package/chunks/chunk-ZDI22NOK.js +7 -0
  435. package/chunks/chunk-ZQKVUPKA.js +2 -0
  436. package/chunks/clipboard-image-PQPC4EHR.js +2 -0
  437. package/chunks/data-dir-OEPRRIOO.js +2 -0
  438. package/chunks/dist-VKYZJYR6.js +11 -0
  439. package/chunks/dist-WGTMUM3E.js +5 -0
  440. package/chunks/emscripten-module-3WGSFZYF.js +2 -0
  441. package/chunks/emscripten-module-74WUXTHL.js +2 -0
  442. package/chunks/emscripten-module-MCN4Y3N4.js +2 -0
  443. package/chunks/emscripten-module-NEAT5LGD.js +2 -0
  444. package/chunks/ffi-EFLUAAVX.js +2 -0
  445. package/chunks/ffi-JIGPPPF7.js +2 -0
  446. package/chunks/ffi-QKKA5HYI.js +2 -0
  447. package/chunks/ffi-RLX77WFG.js +2 -0
  448. package/chunks/google-RCR46TTQ.js +2 -0
  449. package/chunks/google-vertex-Y26T7YYR.js +2 -0
  450. package/chunks/install-source-63OVVBMK.js +2 -0
  451. package/chunks/launcher-2UG3JPYF.js +63 -0
  452. package/chunks/lifecycle-5IPJRP2V.js +2 -0
  453. package/chunks/main-7SGOQBHZ.js +13 -0
  454. package/chunks/mistral-NEBDKUEI.js +3 -0
  455. package/chunks/module-6F3E5H7Y-FIMLNSCK.js +2 -0
  456. package/chunks/module-asyncify-R6PWJ6ZV-Q2HJ3NOC.js +2 -0
  457. package/chunks/multipart-parser-JVSLI2CL.js +2 -0
  458. package/chunks/network-proxy-AJO7ZW3O.js +2 -0
  459. package/chunks/openai-codex-responses-L2CIGCKO.js +2 -0
  460. package/chunks/openai-completions-C4PHW6MD.js +2 -0
  461. package/chunks/openai-responses-5NVFOW4Y.js +2 -0
  462. package/chunks/openrouter-BKUGQT7Z.js +2 -0
  463. package/chunks/otel-DRJM2PIX.js +2 -0
  464. package/chunks/package-contract-GVXTMJ3N.js +2 -0
  465. package/chunks/pdfjs-2UOWBGC2.js +107 -0
  466. package/chunks/photon_rs-MVWYTYTO.js +3 -0
  467. package/chunks/plugin-command-CIDTOPNB.js +2 -0
  468. package/chunks/provider-command-UZ7KQFAC.js +2 -0
  469. package/chunks/questionnaire-bridge-ISQOCYWY.js +2 -0
  470. package/chunks/run-acp-command-AKDLHKMR.js +59 -0
  471. package/chunks/run-exec-command-UXTPS7LC.js +15 -0
  472. package/chunks/skills-command-57TF53NO.js +2 -0
  473. package/chunks/src-5PSNGHHD.js +2 -0
  474. package/chunks/src-YZ26EVSY.js +2 -0
  475. package/chunks/telemetry-3NXMCOVD.js +2 -0
  476. package/chunks/telemetry-command-CMDERYNN.js +5 -0
  477. package/chunks/tools-CRJR35HS.js +2 -0
  478. package/chunks/undici-O4OQVZ6I.js +2 -0
  479. package/chunks/update-ACFAGV6F.js +14 -0
  480. package/chunks/update-hint-ED7O67WU.js +3 -0
  481. package/chunks/wechat-onboard-UWXQW2HT.js +2 -0
  482. package/cli.js +4 -0
  483. package/configs/data-minimal.yaml +50 -0
  484. package/embedded/alran-tools/cli.mjs +4957 -0
  485. package/embedded/alran-tools/manifest.json +25 -0
  486. package/emscripten-module.wasm +0 -0
  487. package/image-preview-worker.js +2 -0
  488. package/internal-bin/alran-tools +9 -0
  489. package/internal-bin/alran-tools.cmd +8 -0
  490. package/matrix-mcp-stdio.js +4 -0
  491. package/native/darwin/prebuilds/darwin-arm64/darwin-modifiers.node +0 -0
  492. package/native/darwin/prebuilds/darwin-x64/darwin-modifiers.node +0 -0
  493. package/native/win32/prebuilds/win32-arm64/win32-console-mode.node +0 -0
  494. package/native/win32/prebuilds/win32-x64/win32-console-mode.node +0 -0
  495. package/package.json +38 -4
  496. package/photon_rs_bg.wasm +0 -0
  497. package/quickjs-worker.js +152 -0
  498. package/vendor/java-proxy-agent/build.ts +97 -0
  499. package/vendor/java-proxy-agent/srt-proxy-agent.jar +0 -0
  500. package/vendor/seccomp/arm64/apply-seccomp +0 -0
  501. package/vendor/seccomp/build.ts +74 -0
  502. package/vendor/seccomp/x64/apply-seccomp +0 -0
  503. package/vendor/srt-win/arm64/srt-win.exe +0 -0
  504. package/vendor/srt-win/build.ts +40 -0
  505. package/vendor/srt-win/x64/srt-win.exe +0 -0
@@ -0,0 +1,136 @@
1
+ # reformat-default
2
+
3
+ > The default template for `bash make.sh reformat`. Takes any markdown / text /
4
+ > PDF input, renders the prose into a clean A4 portrait report. **No charts, no
5
+ > KPI cards** — for visual-heavy reports, use a CREATE template (e.g.
6
+ > `data-viz-report`) instead of REFORMAT.
7
+
8
+ ## 1. When to use
9
+
10
+ - **EN keywords**: reformat, restyle, markdown to PDF, document conversion,
11
+ prose report, make this look good
12
+ - **CN keywords**: 重排版、转 PDF、markdown 转 PDF、把这个文档变好看
13
+ - **Sample user asks**:
14
+ - "把这个 .md 文件转成 PDF。"
15
+ - "Reformat my markdown notes into a clean PDF."
16
+ - "我有一份 PDF 文档,重新排版一下。"
17
+
18
+ This template is **automatically selected** when the user runs
19
+ `bash make.sh reformat` without `--template`. Other reformat-* templates can be
20
+ added in the same `templates/` directory and selected via `--template <slug>`.
21
+
22
+ ## 2. Pipeline
23
+
24
+ `scripts/reformat_parse.py` does:
25
+
26
+ ```
27
+ source.md markdown-it-py placeholder fill
28
+ or .txt or .pdf ─► → HTML fragment ─► skeleton.html → page.html
29
+ ```
30
+
31
+ Then `scripts/render_html.cjs` renders `page.html` → `report.pdf` via
32
+ Playwright (Chromium headless).
33
+
34
+ ## 3. Document shape
35
+
36
+ - **A4 portrait**, 18 mm vertical / 16 mm horizontal margins
37
+ - **Cover page**: 4 px accent rule on top + eyebrow + H1 title + optional
38
+ subtitle + author/date meta block at the bottom
39
+ - **Body**: prose with rendered Markdown — H1/H2/H3, paragraphs, lists,
40
+ blockquotes, code blocks, GFM tables, images
41
+ - Each H1 starts a new page (except the very first). H2 has a left rule. H3 is
42
+ unadorned.
43
+ - Tables are accent-headed, zebra-striped, `page-break-inside: avoid`.
44
+
45
+ ## 4. Visual params
46
+
47
+ **Palette** (neutral / general — re-skin per topic via `--accent`):
48
+ - Ink `#1a1a1a` body / `#444` secondary / `#666` tertiary / `#999` muted
49
+ - Rule `#e5e5e5` / Hairline `#efefef` / Mute `#f7f7f7`
50
+ - Accent **`<!-- ACCENT -->`** (defaults to `#1d4ed8` indigo from `make.sh`)
51
+ - Code block bg `#f4f4f6`, inline code text `#c7254e`
52
+
53
+ **Typography**:
54
+ - Body 10.5 pt / line-height 1.65
55
+ - Cover H1 32 pt 700, body H1 22 pt 700, H2 15 pt 700, H3 12 pt 600
56
+ - Code 9 pt SF Mono / Menlo / Consolas
57
+
58
+ **@page**:
59
+ ```css
60
+ @page { size: A4 portrait; margin: 18mm 16mm; }
61
+ * { -webkit-print-color-adjust: exact; print-color-adjust: exact; }
62
+ ```
63
+
64
+ ## 5. Skeleton
65
+
66
+ See [`skeleton.html`](skeleton.html) (~150 lines, single self-contained
67
+ file).
68
+
69
+ **Quick start**:
70
+ ```bash
71
+ # One-shot via make.sh (recommended)
72
+ bash scripts/make.sh reformat \
73
+ --input mydoc.md --out mydoc.pdf \
74
+ --title "My Document" --author "Jane Doe" --accent "#0a7488"
75
+
76
+ # Or two-step manually
77
+ python3 scripts/reformat_parse.py --input mydoc.md --out /tmp/page.html \
78
+ --title "My Document" --accent "#0a7488"
79
+ node scripts/render_html.cjs --in /tmp/page.html --out mydoc.pdf
80
+ ```
81
+
82
+
83
+ ### Legal contract round-trip case
84
+
85
+
86
+ ## 6. Pitfalls
87
+
88
+ - **No charts.** This template renders prose only; markdown can't express
89
+ charts / KPI cards / radar / scatter. If the source is data-heavy
90
+ (benchmarks, comparisons), switch to `data-viz-report` and write a custom
91
+ HTML rather than reformat.
92
+ - **First H1 lifted as title.** `reformat_parse.py` strips the leading `# Title`
93
+ from the body and uses it as the cover title. If you want the H1 to remain in
94
+ body, pass `--title "..."` explicitly so the lift is skipped.
95
+ - **Last page < 1/3 full.** Same anti-pattern as other templates: do not
96
+ shrink margins to force-fit. Either accept the short tail or have the source
97
+ expand.
98
+ - **PDF source with bad layout extraction.** `pdftotext -layout` works for
99
+ text-native PDFs but garbles two-column / scanned PDFs. For those, use
100
+ the READ route ([`../../docs/read-guide.md`](../../docs/read-guide.md))
101
+ first to get clean text, then reformat.
102
+ - **CJK punctuation in tables.** Full-width `()`、`:`、`/` overflow narrow
103
+ cells. Edit the source markdown to use half-width punctuation inside table
104
+ rows.
105
+ - **Lazy images / external `<img>` URLs.** `render_html.cjs` waits for
106
+ `networkidle`, but very slow CDNs may still drop. Inline base64 or use
107
+ `file://` paths for reliability.
108
+
109
+ ## 7. Generalization
110
+
111
+ **Required placeholders** (filled by `reformat_parse.py`):
112
+ - `<!-- TITLE -->`, `<!-- SUBTITLE -->`, `<!-- AUTHOR -->`, `<!-- DATE -->`
113
+ - `<!-- ACCENT -->` (CSS hex)
114
+ - `<!-- BODY_HTML -->` (the rendered markdown)
115
+
116
+ **Structural invariants**:
117
+ - `@page A4 portrait` with 18/16 mm margins (do not change without re-tuning
118
+ cover height `261mm`).
119
+ - Cover has accent top rule + eyebrow + title + subtitle + meta footer.
120
+ - H1 in body has `page-break-before: always` (except first).
121
+ - Tables use accent header + zebra body.
122
+
123
+ **Diversify per run.** Default accent is a generic blue — **change it**:
124
+
125
+ | Topic feel | Suggested accent |
126
+ | --- | --- |
127
+ | Engineering / hardware | `#0066cc` |
128
+ | Healthcare / wellness | `#0a7488` |
129
+ | Sustainability | `#3f7d3f` |
130
+ | Finance | `#0c8a5d` |
131
+ | Creative / portfolio | `#7c3aed` |
132
+ | Industrial / energy | `#d4621a` |
133
+
134
+ For richer customization (different cover layout, sidebar, custom hero),
135
+ duplicate this directory as `reformat-<your-slug>/`, edit `skeleton.html`,
136
+ and select with `--template <your-slug>`.
@@ -0,0 +1,204 @@
1
+ <!DOCTYPE html>
2
+ <!--
3
+ reformat-default skeleton
4
+ -------------------------
5
+ Used by `bash make.sh reformat`. Placeholders are replaced by
6
+ scripts/reformat_parse.py:
7
+
8
+ <!-- TITLE --> document title (H1 lifted from source if absent)
9
+ <!-- SUBTITLE --> cover line 2 (optional)
10
+ <!-- AUTHOR --> cover meta line — author
11
+ <!-- DATE --> cover meta line — date (YYYY-MM-DD; defaults to today)
12
+ <!-- ACCENT --> CSS hex (--accent), drives section rule + link + table head
13
+ <!-- BODY_HTML --> markdown-it rendered HTML (h1/h2/h3/p/ul/ol/table/code/…)
14
+
15
+ Render:
16
+ node scripts/render_html.cjs --in page.html --out report.pdf
17
+ -->
18
+ <html lang="zh-CN">
19
+ <head>
20
+ <meta charset="UTF-8">
21
+ <title><!-- TITLE --></title>
22
+ <style>
23
+ @page { size: A4 portrait; margin: 18mm 16mm; }
24
+ * { box-sizing: border-box; -webkit-print-color-adjust: exact; print-color-adjust: exact; }
25
+
26
+ :root {
27
+ --ink: #1a1a1a;
28
+ --ink-2: #444;
29
+ --ink-3: #666;
30
+ --ink-4: #999;
31
+ --rule: #e5e5e5;
32
+ --hairline: #efefef;
33
+ --mute: #f7f7f7;
34
+ --accent: <!-- ACCENT -->;
35
+ --code-bg: #f4f4f6;
36
+ }
37
+
38
+ html, body {
39
+ margin: 0; padding: 0;
40
+ font-family: -apple-system, BlinkMacSystemFont, "SF Pro Display",
41
+ "PingFang SC", "Hiragino Sans", "Helvetica Neue", Arial, sans-serif;
42
+ color: var(--ink);
43
+ font-size: 10.5pt; line-height: 1.65;
44
+ -webkit-font-smoothing: antialiased;
45
+ }
46
+
47
+ /* ── Cover ───────────────────────────────────────────────────────────── */
48
+ .cover {
49
+ height: 261mm; /* A4 297 - 36 margins */
50
+ display: flex; flex-direction: column; justify-content: space-between;
51
+ padding: 16mm 4mm; page-break-after: always;
52
+ border-top: 4px solid var(--accent);
53
+ }
54
+ .cover-top { display: flex; flex-direction: column; gap: 6mm; }
55
+ .cover-eyebrow {
56
+ font-size: 9pt; letter-spacing: 4px; text-transform: uppercase;
57
+ color: var(--accent); font-weight: 600;
58
+ }
59
+ .cover-title {
60
+ font-size: 32pt; font-weight: 700; line-height: 1.2;
61
+ letter-spacing: -0.5px; color: var(--ink); margin: 0;
62
+ }
63
+ .cover-subtitle {
64
+ font-size: 14pt; color: var(--ink-2); line-height: 1.5;
65
+ margin: 4mm 0 0; max-width: 150mm;
66
+ }
67
+ .cover-meta {
68
+ display: flex; gap: 24mm; font-size: 10pt; color: var(--ink-3);
69
+ border-top: 1px solid var(--rule); padding-top: 6mm;
70
+ }
71
+ .cover-meta dt {
72
+ font-size: 8pt; letter-spacing: 1.5px; text-transform: uppercase;
73
+ color: var(--ink-4); font-weight: 600; margin-bottom: 2mm;
74
+ }
75
+ .cover-meta dd { margin: 0; font-weight: 500; color: var(--ink); }
76
+
77
+ /* ── Body ────────────────────────────────────────────────────────────── */
78
+ .body { padding: 0 4mm; }
79
+
80
+ .body h1, .body h2, .body h3, .body h4 {
81
+ color: var(--ink); letter-spacing: -0.2px; line-height: 1.3;
82
+ page-break-after: avoid;
83
+ }
84
+ .body h1 {
85
+ font-size: 22pt; font-weight: 700; margin: 14mm 0 6mm;
86
+ padding-bottom: 3mm; border-bottom: 2px solid var(--accent);
87
+ page-break-before: always;
88
+ }
89
+ .body > h1:first-child { page-break-before: auto; margin-top: 0; }
90
+ .body h2 {
91
+ font-size: 15pt; font-weight: 700; margin: 10mm 0 4mm;
92
+ padding-left: 4mm; border-left: 3px solid var(--accent);
93
+ }
94
+ .body h3 { font-size: 12pt; font-weight: 600; margin: 7mm 0 3mm; }
95
+ .body h4 { font-size: 10.5pt; font-weight: 600; margin: 5mm 0 2mm; color: var(--ink-2); }
96
+
97
+ .body p { margin: 0 0 4mm; }
98
+ .body strong { color: var(--ink); font-weight: 600; }
99
+ .body em { font-style: italic; }
100
+ .body a { color: var(--accent); text-decoration: none; border-bottom: 0.5px solid currentColor; }
101
+
102
+ .body ul, .body ol { margin: 0 0 5mm; padding-left: 6mm; }
103
+ .body li { margin-bottom: 1.5mm; }
104
+ .body li > ul, .body li > ol { margin: 1.5mm 0 0; }
105
+
106
+ .body blockquote {
107
+ margin: 5mm 0; padding: 3mm 5mm;
108
+ background: var(--mute); border-left: 3px solid var(--accent);
109
+ color: var(--ink-2); border-radius: 2px;
110
+ }
111
+ .body blockquote p { margin: 0 0 2mm; }
112
+ .body blockquote p:last-child { margin: 0; }
113
+
114
+ /* ── Code ────────────────────────────────────────────────────────────── */
115
+ .body code {
116
+ font-family: "SF Mono", Menlo, Consolas, monospace; font-size: 9pt;
117
+ background: var(--code-bg); color: #c7254e; padding: 1px 5px;
118
+ border-radius: 3px; border: 0.5px solid var(--hairline);
119
+ }
120
+ .body pre {
121
+ background: var(--code-bg); border: 0.5px solid var(--hairline);
122
+ border-radius: 6px; padding: 4mm 5mm; overflow-x: auto;
123
+ margin: 5mm 0; font-size: 9pt; line-height: 1.5;
124
+ page-break-inside: avoid;
125
+ }
126
+ .body pre code {
127
+ background: transparent; color: var(--ink); border: 0; padding: 0;
128
+ font-size: inherit;
129
+ }
130
+
131
+ /* ── Tables ──────────────────────────────────────────────────────────── */
132
+ .body table {
133
+ width: 100%; border-collapse: collapse; margin: 5mm 0;
134
+ font-size: 9.5pt; page-break-inside: avoid;
135
+ border: 1px solid var(--rule); border-radius: 4px; overflow: hidden;
136
+ }
137
+ .body table thead th {
138
+ background: var(--accent); color: #fff; padding: 2.5mm 3mm;
139
+ text-align: left; font-weight: 600; font-size: 9pt;
140
+ letter-spacing: 0.2px;
141
+ }
142
+ .body table tbody td {
143
+ padding: 2mm 3mm; border-top: 1px solid var(--hairline);
144
+ color: var(--ink-2); vertical-align: top;
145
+ }
146
+ .body table tbody tr:nth-child(even) td { background: #fbfbfd; }
147
+
148
+ /* ── Images / figures ───────────────────────────────────────────────── */
149
+ .body img {
150
+ max-width: 100%; height: auto; border-radius: 4px;
151
+ display: block; margin: 5mm auto;
152
+ }
153
+
154
+ /* ── Hr ──────────────────────────────────────────────────────────────── */
155
+ .body hr {
156
+ border: 0; border-top: 1px solid var(--rule); margin: 8mm 0;
157
+ }
158
+
159
+ /* ── Footer rule ─────────────────────────────────────────────────────── */
160
+ .footer {
161
+ margin-top: 14mm; padding-top: 4mm; border-top: 1px solid var(--rule);
162
+ font-size: 8.5pt; color: var(--ink-4); text-align: center;
163
+ }
164
+
165
+ /* === Screen-emulation: open in browser → looks like the A4 PDF =========== */
166
+ @media screen {
167
+ html { background: #d0d0d0; }
168
+ body { margin: 0; padding: 20px 0; }
169
+ body > section {
170
+ width: 210mm; min-height: 297mm; margin: 0 auto 20px;
171
+ background: #fff; box-shadow: 0 4px 24px rgba(0,0,0,0.18);
172
+ box-sizing: border-box; overflow: hidden;
173
+ }
174
+ }
175
+ </style>
176
+ </head>
177
+ <body>
178
+
179
+ <section class="cover">
180
+ <div class="cover-top">
181
+ <div class="cover-eyebrow">REPORT · <!-- DATE --></div>
182
+ <h1 class="cover-title"><!-- TITLE --></h1>
183
+ <p class="cover-subtitle"><!-- SUBTITLE --></p>
184
+ </div>
185
+ <dl class="cover-meta">
186
+ <div>
187
+ <dt>Author</dt>
188
+ <dd><!-- AUTHOR --></dd>
189
+ </div>
190
+ <div>
191
+ <dt>Date</dt>
192
+ <dd><!-- DATE --></dd>
193
+ </div>
194
+ </dl>
195
+ </section>
196
+
197
+ <section class="body">
198
+ <!-- BODY_HTML -->
199
+ </section>
200
+
201
+ <div class="footer">— end of document —</div>
202
+
203
+ </body>
204
+ </html>
@@ -0,0 +1,136 @@
1
+ # translate-preserve-layout
2
+
3
+ > Distilled from reference examples m09 (Email -> Chinese-translated PDF, layout preserved). HTML parse
4
+ > -> **terminology freeze** -> translate -> Chromium print.
5
+
6
+ ## 1. When to use
7
+
8
+ - **EN keywords**: translate document, preserve layout, preserve formatting, email translation,
9
+ report translation, image-preserving translation
10
+ - **CN keywords**: 翻译保版、邮件翻译、报告翻译、保留排版、保留图片、译文 PDF、保持不变
11
+ - **Sample user asks**:
12
+ - "Translate this report inside an email to Chinese and save as a PDF; keep the content and the
13
+ icons intact."
14
+ - "Translate this report to Chinese preserving all images and layout."
15
+
16
+ ## 2. Pipeline
17
+
18
+ HTML parse -> terminology freeze -> translate -> Chromium print -> PDF
19
+
20
+ 1. Parse the source (`.eml` / `.html` / `.pdf` text layer) into structured paragraphs + image
21
+ references (**preserve byte-level** URL / data-uri / cid: references).
22
+ 2. Extract domain terms -> freeze them in `terminology.json` (after the first 3 iterations the file
23
+ is read-only for every later round).
24
+ 3. Translate per-paragraph with the frozen glossary; categorise by type: metadata / heading / body /
25
+ list_item / caption / footnote / disclaimer / table_cell.
26
+ 4. Emit HTML with the translated text + **original image references untouched** (no re-encoding).
27
+ 5. Playwright Chromium print -> PDF (preserves CJK / transparency / EXIF).
28
+
29
+ Why not the token pipeline: the source already has a rich layout (tables, figures, nested lists). A
30
+ token rebuild loses both spatial fidelity and image byte tracking. HTML -> HTML -> PDF is the
31
+ natural "layout-preserving" path.
32
+
33
+ ## 3. Document shape
34
+
35
+ - **Pages**: typically 5 A4 (varies; tracks the source).
36
+ - **Structure**: metadata (subject / from / to / date) -> header (logo) -> body (paragraphs +
37
+ headings + lists) -> exhibits (figures + captions + footnotes) -> team cards -> footer /
38
+ disclaimer.
39
+ - **Page size**: A4, 11-14 mm margins (match source).
40
+ - **Image preservation**: byte-level (no Pillow post-processing, no resize, transparency smask
41
+ preserved).
42
+
43
+ ## 4. Visual params
44
+
45
+ - **Palette**: match source (unless the user requests otherwise).
46
+ - **Typography**: PingFang SC / Hiragino Sans GB / Microsoft YaHei / Source Han Sans CN for body;
47
+ keep the source heading fonts.
48
+ - **Images**: keep `<img src="cid:...">` or `<img src="data:image/...">` exactly as-is;
49
+ `max-width: 88%` to prevent overflow.
50
+ - **Line-height**: minimum 1.6 (CJK needs breathing room; 1.5 is too tight and characters collide).
51
+ - **Exhibits**: `page-break-inside: avoid` + `max-height: 400pt` to prevent orphans.
52
+
53
+ ## 5. Skeleton
54
+
55
+ See [`skeleton.html`](skeleton.html) (HTML template, ~150 lines) +
56
+ [`terminology.template.json`](terminology.template.json) (terminology schema).
57
+
58
+ **Quick start**:
59
+
60
+ ```bash
61
+ # 1. Extract source
62
+ python3 -c "import html_parse; html_parse.extract('source.eml', out='/tmp/extracted/')"
63
+ # 2. Build terminology.json (settle within first 3 iterations, then freeze)
64
+ cp templates/translate-preserve-layout/terminology.template.json /tmp/extracted/terminology.json
65
+ # Fill in your domain terms.
66
+ # 3. Translate every paragraph using the frozen terminology.
67
+ python3 translate.py --in /tmp/extracted/ --terminology /tmp/extracted/terminology.json --out /tmp/translated/
68
+ # 4. Render HTML (skeleton + translated data).
69
+ cp templates/translate-preserve-layout/skeleton.html /tmp/translated/page.html
70
+ # Fill in placeholders.
71
+ # 5. Chromium print.
72
+ node packages/local-runtime/assets/skills/pdf/scripts/render_html.cjs /tmp/translated/page.html /tmp/translated/out.pdf
73
+ # 6. Verify image count.
74
+ src_imgs=$(pdfimages -list source.pdf | tail -n +3 | wc -l)
75
+ out_imgs=$(pdfimages -list /tmp/translated/out.pdf | tail -n +3 | wc -l)
76
+ [ "$src_imgs" = "$out_imgs" ] || echo "Warning: image count drift: src=$src_imgs out=$out_imgs"
77
+ ```
78
+
79
+
80
+ ## 7. Pitfalls (from m09 production)
81
+
82
+ - **Terminology drift** — fatal: the same term gets three different translations across iterations
83
+ (e.g. "Two Sessions" rendered three different ways in Chinese). **Freeze `terminology.json` after
84
+ the first 3 iterations; treat it as read-only afterwards.**
85
+ - **Lost images — P0 fail**: source has 6 images, output has 5 -> the acceptance gate fails. **Count
86
+ images via `pdfimages -list` before and after rendering; source must equal output.**
87
+ - **Image byte drift**: re-encoding through Pillow / base64 loses transparency + EXIF. **Skip
88
+ post-processing**; preserve `cid:` references and let Playwright render natively.
89
+ - **CJK line-height**: 1.5 is too tight — PingFang / Noto characters overlap. Minimum 1.6; verify
90
+ visually with `pdftotext`.
91
+ - **Header fields forgotten**: agents commonly skip Subject / From / Date / Footer. Mark them
92
+ explicitly with `is_translatable: true` in the schema.
93
+ - **Table cell width px -> mm fails**: use percentages or `max-width` constraints.
94
+ - **Caption / footnote orphans**: `page-break-inside: avoid` on `<figure>`.
95
+ - **Over-translating proper nouns**: agents invent Chinese names for English authors (e.g. "Andrew
96
+ Tilton" -> a fabricated Chinese name). **Mark authors / companies / places without standard CN
97
+ translations as `category: proper_noun, note: preserve English / no invented translations`.**
98
+ - **Quote preservation**: "around 5%" / "4.5-5.0%" — the Chinese version must keep proper Chinese
99
+ quotation marks. Note `preserve` in `terminology.json` and grep the rendered PDF to verify.
100
+
101
+ ## 8. Generalization
102
+
103
+ **Required placeholders**:
104
+
105
+ - TRANSLATED_TITLE / SUBJECT / FROM / TO / DATE / SECTION_HEADING_TRANSLATED.
106
+ - `paragraphs_translated[]` (categorised by type).
107
+ - `images[]` (with original cid: / data-uri).
108
+ - `terminology.json` (per-domain glossary; frozen after 3 iterations).
109
+ - Exhibit captions + footnotes (translated independently).
110
+
111
+ **Optional / swappable**:
112
+
113
+ - Target language (zh-CN / zh-TW / ja / ko) — change `lang=""` and the font cascade.
114
+ - Page size / margins (match source / override).
115
+ - Fonts (PingFang <-> Noto Sans CJK SC for Linux).
116
+ - Image reference style (cid: / data-uri / inline base64 — follow the source).
117
+
118
+ **Structural invariants**:
119
+
120
+ - `@page A4` + 11-14 mm margins (match source).
121
+ - CJK fonts FIRST in the cascade.
122
+ - `max-width: 88%` on `<img.exhibit>`.
123
+ - `page-break-inside: avoid` on `<figure>`.
124
+ - `line-height: 1.6` minimum.
125
+ - Preserve every heading level.
126
+ - The metadata block (subject / from / to / date) always sits at the top of the document.
127
+ - Author names mark `proper_noun` (preserve English; do not invent translations).
128
+
129
+ **Domain swappable**: finance (baseline) / legal / technical / medical / political — each domain
130
+ produces an independent `terminology.json`.
131
+
132
+ **Diversify every run.** REFORMAT is the one route where you should **not** invent new visuals — the
133
+ whole point is layout fidelity to the source. But per-domain `terminology.json`, target language,
134
+ and CJK font cascade still need to be re-picked per task: a finance translation for a HK firm and a
135
+ medical translation for a JP hospital should not share the same glossary or font stack. Always start
136
+ a fresh `terminology.json` from the source's domain.
@@ -0,0 +1,96 @@
1
+ <!DOCTYPE html>
2
+ <html lang="zh-CN">
3
+ <head>
4
+ <meta charset="utf-8">
5
+ <title><!-- TRANSLATED_TITLE --></title>
6
+ <style>
7
+ @page { size: A4; margin: 1.1cm 1.4cm; }
8
+ html, body {
9
+ font-family: "PingFang SC", "Hiragino Sans GB", "Heiti SC",
10
+ "Microsoft YaHei", "Source Han Sans CN", sans-serif;
11
+ font-size: 10.5pt; line-height: 1.6; color: #1a1a1a;
12
+ margin: 0; padding: 0;
13
+ }
14
+ h1.title { font-size: 18pt; font-weight: 700; margin: 0.6em 0 0.3em 0; page-break-after: avoid; }
15
+ h2.section-heading { font-size: 12pt; font-weight: 700; margin: 1em 0 0.4em 0; }
16
+ h3.disclaimer-heading { font-size: 10pt; font-weight: 700; margin: 1em 0 0.4em 0; color: #555; }
17
+ .meta { font-size: 9.5pt; color: #555; margin: 0.15em 0; }
18
+ .meta-label { color: #888; }
19
+ p.body { margin: 0.45em 0; text-align: justify; }
20
+ ul.bullets { margin: 0.3em 0 0.5em 0; padding-left: 1.4em; }
21
+ li.bullet { margin: 0.35em 0; text-align: justify; }
22
+ img.logo { max-height: 18mm; margin: 0.3em 0; }
23
+ img.exhibit { display: block; max-width: 88%; height: auto;
24
+ margin: 0.2em auto 0.3em; page-break-inside: avoid; }
25
+ figure { margin: 0.6em 0; page-break-inside: avoid; }
26
+ .caption { font-size: 10pt; font-weight: 600; color: #2a2a2a; margin: 0.9em 0 0.3em 0; }
27
+ .footnote { font-size: 8.5pt; color: #666; line-height: 1.4; margin: 0.15em 0; }
28
+ .author-name { font-size: 10.5pt; font-weight: 600; margin: 0.3em 0 0.06em 0; }
29
+ .author-contact { font-size: 8.5pt; color: #666; }
30
+ p.disclaimer { font-size: 8.5pt; color: #555; line-height: 1.4; }
31
+ table { border-collapse: collapse; width: 100%; margin: 0.5em 0; }
32
+ table, th, td { border: 0.5pt solid #aaa; padding: 4pt 6pt; vertical-align: top; }
33
+ th { background: #f0f0f0; font-weight: 600; }
34
+
35
+ /* === Screen-emulation: open in browser → looks like the A4 PDF =========== */
36
+ @media screen {
37
+ html { background: #d0d0d0; }
38
+ body { margin: 0; padding: 20px 0; }
39
+ body > section {
40
+ width: 210mm; min-height: 297mm; margin: 0 auto 20px;
41
+ background: #fff; box-shadow: 0 4px 24px rgba(0,0,0,0.18);
42
+ box-sizing: border-box; overflow: hidden;
43
+ }
44
+ }
45
+ </style>
46
+ </head>
47
+ <body>
48
+
49
+ <!-- ─── METADATA ─────────────────────────────────── -->
50
+ <div class="meta-section">
51
+ <p class="meta"><span class="meta-label">主题:</span><!-- SUBJECT_TRANSLATED --></p>
52
+ <p class="meta"><span class="meta-label">发件人:</span><!-- FROM_TRANSLATED --></p>
53
+ <p class="meta"><span class="meta-label">收件人:</span><!-- TO_TRANSLATED --></p>
54
+ <p class="meta"><span class="meta-label">日期:</span><!-- DATE_TRANSLATED --></p>
55
+ </div>
56
+
57
+ <!-- ─── LOGO (preserve original cid: or data-uri) ─── -->
58
+ <img class="logo" src="<!-- LOGO_CID_OR_DATAURI -->" alt="">
59
+
60
+ <!-- ─── MAIN TITLE ─────────────────────────────────── -->
61
+ <h1 class="title"><!-- TITLE_TRANSLATED --></h1>
62
+ <div class="byline"><!-- DATE_BYLINE_TRANSLATED --></div>
63
+
64
+ <!-- ─── SECTIONS (REPEAT for each Section/Heading) ── -->
65
+ <h2 class="section-heading"><!-- SECTION_HEADING_TRANSLATED --></h2>
66
+
67
+ <!-- REPEAT: paragraphs in section -->
68
+ <p class="body"><!-- PARAGRAPH_TRANSLATED --></p>
69
+
70
+ <!-- REPEAT: bullet lists in section -->
71
+ <ul class="bullets">
72
+ <li class="bullet"><!-- ITEM_TRANSLATED --></li>
73
+ <li class="bullet"><!-- ITEM_TRANSLATED --></li>
74
+ </ul>
75
+
76
+ <!-- ─── EXHIBITS (REPEAT for each chart/image) ────── -->
77
+ <figure>
78
+ <p class="caption"><!-- EXHIBIT_CAPTION_TRANSLATED --></p>
79
+ <img class="exhibit" src="<!-- ORIGINAL_IMG_CID_OR_DATAURI -->" alt="">
80
+ <p class="footnote"><!-- FOOTNOTE_TRANSLATED --></p>
81
+ <p class="footnote"><!-- SOURCE_LINE_TRANSLATED --></p>
82
+ </figure>
83
+
84
+ <!-- ─── TEAM (REPEAT for each author) ──────────────── -->
85
+ <h2 class="section-heading"><!-- TEAM_TITLE_TRANSLATED --></h2>
86
+ <p class="author-name"><!-- AUTHOR_NAME (preserve English) --></p>
87
+ <p class="author-contact"><!-- TITLE / PHONE / EMAIL --></p>
88
+
89
+ <!-- ─── DISCLAIMERS ────────────────────────────────── -->
90
+ <div class="disclaimer-section">
91
+ <h3 class="disclaimer-heading"><!-- DISCLAIMER_SECTION_TRANSLATED --></h3>
92
+ <p class="disclaimer"><!-- DISCLAIMER_TEXT_TRANSLATED --></p>
93
+ </div>
94
+
95
+ </body>
96
+ </html>
@@ -0,0 +1,66 @@
1
+ {
2
+ "_meta": {
3
+ "version": "v1-DRAFT",
4
+ "domain": "<!-- finance / legal / technical / medical / political -->",
5
+ "freeze_after_iteration": 3,
6
+ "freeze_status": "DRAFT",
7
+ "note": [
8
+ "Once freeze_status='FROZEN', NO new terms accepted.",
9
+ "All translation rounds MUST consult this glossary before producing any text.",
10
+ "Conflicts: report to user, do NOT silently re-translate."
11
+ ]
12
+ },
13
+
14
+ "policy": [
15
+ {
16
+ "term_en": "<!-- ENGLISH_TERM -->",
17
+ "term_cn": "<!-- TRANSLATED_TERM -->",
18
+ "category": "policy",
19
+ "note": "Star (*) marks required terms; describe context / first-use vs subsequent-use rule."
20
+ }
21
+ ],
22
+
23
+ "finance": [
24
+ {
25
+ "term_en": "<!-- ENGLISH_TERM -->",
26
+ "term_cn": "<!-- TRANSLATED_TERM -->",
27
+ "category": "finance",
28
+ "note": "Star (*) marks required terms; preserve abbreviations / currency conversions / etc."
29
+ }
30
+ ],
31
+
32
+ "technical": [
33
+ {
34
+ "term_en": "<!-- ENGLISH_TERM -->",
35
+ "term_cn": "<!-- TRANSLATED_TERM -->",
36
+ "category": "technical",
37
+ "note": "Preserve casing for code identifiers / API names."
38
+ }
39
+ ],
40
+
41
+ "proper_noun": [
42
+ {
43
+ "term_en": "<!-- AUTHOR_NAME -->",
44
+ "term_cn": "<!-- AUTHOR_NAME (same — preserve English) -->",
45
+ "category": "proper_noun",
46
+ "note": "Star (*) NEVER invent target-language names for English authors. Preserve English. Same rule for company names, product names, and place names without a standard target-language translation."
47
+ },
48
+ {
49
+ "term_en": "Shanghai",
50
+ "term_cn": "上海",
51
+ "category": "proper_noun",
52
+ "note": "Standard CN translation exists; use it."
53
+ }
54
+ ],
55
+
56
+ "punctuation": [
57
+ {
58
+ "rule": "preserve_chinese_quotes",
59
+ "description": "Chinese quotation marks 「」『』 must be preserved; do NOT replace with \"...\" "
60
+ },
61
+ {
62
+ "rule": "preserve_percent_ranges",
63
+ "description": "'around 5%' / '4.5-5.0%' keep number format + % sign + dash style"
64
+ }
65
+ ]
66
+ }