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.
- package/ALRAN_TOOLS_NOTICES.md +64 -0
- package/LICENSE +27 -0
- package/LICENSE-STATUS.md +21 -0
- package/NOTICE +6 -0
- package/README.md +289 -2
- package/THIRD_PARTY_NOTICES.md +113 -0
- package/alran-tools.js +3 -0
- package/assets/agents/_default/prompt-auto_classifier.md +185 -0
- package/assets/agents/_default/prompt-auto_classifier_extras.md +17 -0
- package/assets/agents/_default/prompt-base-all.md +133 -0
- package/assets/agents/_default/prompt-base-all.md.hbs +228 -0
- package/assets/agents/_default/prompt-base-windows.md +5 -0
- package/assets/agents/_default/prompt-base-windows.md.hbs +5 -0
- package/assets/agents/_default/prompt-base-worker.md +10 -0
- package/assets/agents/_default/prompt-base-worker.md.hbs +27 -0
- package/assets/agents/_default/prompt-compact.md +76 -0
- package/assets/agents/_default/prompt-compact_continue.md +9 -0
- package/assets/agents/_default/prompt-git.md +8 -0
- package/assets/agents/_default/prompt-goal.md +13 -0
- package/assets/agents/_default/prompt-session-branch.md +3 -0
- package/assets/agents/_default/prompt-session-branch.md.hbs +30 -0
- package/assets/agents/_default/prompt-session-root.md +3 -0
- package/assets/agents/_default/prompt-session-root.md.hbs +32 -0
- package/assets/agents/_default/prompt-title.md +11 -0
- package/assets/agents/_default/prompt-tool_agent.md +22 -0
- package/assets/agents/_migration/README.md +20 -0
- package/assets/agents/_migration/coder/PERSONA.md +11 -0
- package/assets/agents/_migration/coder/system-prompt.md.hbs +42 -0
- package/assets/agents/_migration/general/PERSONA.md +11 -0
- package/assets/agents/_migration/general/system-prompt.md.hbs +49 -0
- package/assets/agents/_v2/AGENT_CONTEXT.md.hbs +245 -0
- package/assets/agents/_v2/PTC_TOOL_CALLS.md.hbs +35 -0
- package/assets/agents/_v2/coding/SYSTEM.md.hbs +173 -0
- package/assets/agents/_v2/explore.md.hbs +38 -0
- package/assets/agents/_v2/tui/SYSTEM.md.hbs +211 -0
- package/assets/agents/_v2/verifier.md.hbs +32 -0
- package/assets/agents/_v2/work/SYSTEM.md.hbs +186 -0
- package/assets/agents/_v2/worker.md.hbs +27 -0
- package/assets/agents/alran/PERSONA.md +7 -0
- package/assets/agents/alran/features/cron.md.hbs +0 -0
- package/assets/agents/alran/features/delegation.md.hbs +56 -0
- package/assets/agents/alran/features/memory.md.hbs +61 -0
- package/assets/agents/alran/features/recoverable-deletion.md.hbs +10 -0
- package/assets/agents/alran/features/task-management.md.hbs +11 -0
- package/assets/agents/alran/features/web-search.md.hbs +11 -0
- package/assets/agents/alran/modes/coding/online/PERSONA.md.hbs +20 -0
- package/assets/agents/alran/modes/coding/online/SYSTEM.md.hbs +158 -0
- package/assets/agents/alran/modes/work/online/PERSONA.md.hbs +20 -0
- package/assets/agents/alran/modes/work/online/SYSTEM.md.hbs +160 -0
- package/assets/agents/alran/prompt-session-root.md +4 -0
- package/assets/agents/alran/prompt-session-root.md.hbs +4 -0
- package/assets/agents/alran/skills/alran-code-product/SKILL.md +72 -0
- package/assets/agents/alran/skills/alran-code-product/references/account-models.md +61 -0
- package/assets/agents/alran/skills/alran-code-product/references/agents.md +34 -0
- package/assets/agents/alran/skills/alran-code-product/references/extensions.md +46 -0
- package/assets/agents/alran/skills/alran-code-product/references/workflows.md +56 -0
- package/assets/agents/alran/skills/control-in-app-browser/SKILL.md +590 -0
- package/assets/agents/alran/system-prompt.md.hbs +97 -0
- package/assets/agents/builtin-agents.json +1 -0
- package/assets/agents/desktop-task/archive-title/system-en.md +1 -0
- package/assets/agents/desktop-task/checkpoint/system.md +19 -0
- package/assets/agents/desktop-task/output-revision/system.md +1 -0
- package/assets/agents/desktop-task/retry/continuation.md +4 -0
- package/assets/agents/desktop-task/session-title/system.md +41 -0
- package/assets/agents/explore/PERSONA.md +8 -0
- package/assets/agents/explore/agent.md +14 -0
- package/assets/agents/explore/system-prompt.md.hbs +35 -0
- package/assets/agents/greeting.md +61 -0
- package/assets/agents/managed-prompts.json +47 -0
- package/assets/agents/prompt-exemptions.json +36 -0
- package/assets/agents/verifier/PERSONA.md +8 -0
- package/assets/agents/verifier/agent.md +17 -0
- package/assets/agents/verifier/system-prompt.md.hbs +28 -0
- package/assets/agents/worker/PERSONA.md +8 -0
- package/assets/agents/worker/agent.md +18 -0
- package/assets/agents/worker/system-prompt.md.hbs +22 -0
- package/assets/agents/workflow/code-review/review-candidates.md +120 -0
- package/assets/agents/workflow/code-review/reviewer-system.md +75 -0
- package/assets/agents/workflow/goal/budget-limit.md +16 -0
- package/assets/agents/workflow/goal/continuation.md +62 -0
- package/assets/agents/workflow/goal/objective-updated.md +16 -0
- package/assets/agents/workflow/goal/recovery-terminal-audit.md +13 -0
- package/assets/agents/workflow/goal/recovery.md +11 -0
- package/assets/agents/workflow/goal/terminal-audit.md +10 -0
- package/assets/agents/workflow/plan-mode/agent-entry.md +72 -0
- package/assets/agents/workflow/prompt-hook/system.md +0 -0
- package/assets/models-dev-catalog.json.gz +0 -0
- package/assets/prompts/code-review/review-candidates.md +120 -0
- package/assets/prompts/code-review/reviewer-system.md +75 -0
- package/assets/skills/alran-tools-master/SKILL.md +127 -0
- package/assets/skills/code-review/SKILL.md +51 -0
- package/assets/skills/cu-desktop/SKILL.md +255 -0
- package/assets/skills/deep-research/SKILL.md +30 -0
- package/assets/skills/deploy-website/SKILL.md +52 -0
- package/assets/skills/docx/LICENSE +21 -0
- package/assets/skills/docx/SKILL.md +259 -0
- package/assets/skills/docx/assets/styles/academic_styles.xml +250 -0
- package/assets/skills/docx/assets/styles/corporate_styles.xml +284 -0
- package/assets/skills/docx/assets/styles/default_styles.xml +449 -0
- package/assets/skills/docx/assets/xsd/aesthetic-rules.xsd +470 -0
- package/assets/skills/docx/assets/xsd/business-rules.xsd +130 -0
- package/assets/skills/docx/assets/xsd/common-types.xsd +159 -0
- package/assets/skills/docx/assets/xsd/wml-subset.xsd +589 -0
- package/assets/skills/docx/docs/acceptance-checklists/create.md +7 -0
- package/assets/skills/docx/docs/acceptance-checklists/edit.md +6 -0
- package/assets/skills/docx/docs/acceptance-checklists/layout-repair.md +7 -0
- package/assets/skills/docx/docs/acceptance-checklists/template.md +6 -0
- package/assets/skills/docx/docs/acceptance.md +139 -0
- package/assets/skills/docx/docs/anti-patterns.md +14 -0
- package/assets/skills/docx/docs/backends.md +116 -0
- package/assets/skills/docx/docs/evidence.md +73 -0
- package/assets/skills/docx/docs/failure-taxonomy.md +71 -0
- package/assets/skills/docx/docs/index.md +50 -0
- package/assets/skills/docx/docs/rendered-delivery.md +125 -0
- package/assets/skills/docx/docs/router.md +122 -0
- package/assets/skills/docx/docs/tables-and-numbering.md +27 -0
- package/assets/skills/docx/docs/task-apply-template.md +141 -0
- package/assets/skills/docx/docs/task-compare-two-docx.md +48 -0
- package/assets/skills/docx/docs/task-create.md +124 -0
- package/assets/skills/docx/docs/task-edit-fill.md +69 -0
- package/assets/skills/docx/docs/task-read-content.md +148 -0
- package/assets/skills/docx/docs/task-read-rendered.md +78 -0
- package/assets/skills/docx/docs/task-read-structure.md +93 -0
- package/assets/skills/docx/docs/task-repair-layout.md +70 -0
- package/assets/skills/docx/docs/template-dsl.md +32 -0
- package/assets/skills/docx/docs/track-changes.md +15 -0
- package/assets/skills/docx/docs/xml-patch-dsl.md +33 -0
- package/assets/skills/docx/references/cjk_typography.md +357 -0
- package/assets/skills/docx/references/cjk_university_template_guide.md +184 -0
- package/assets/skills/docx/references/comments_guide.md +191 -0
- package/assets/skills/docx/references/design_good_bad_examples.md +829 -0
- package/assets/skills/docx/references/design_principles.md +819 -0
- package/assets/skills/docx/references/openxml_element_order.md +308 -0
- package/assets/skills/docx/references/openxml_encyclopedia_part1.md +4061 -0
- package/assets/skills/docx/references/openxml_encyclopedia_part2.md +2820 -0
- package/assets/skills/docx/references/openxml_encyclopedia_part3.md +3381 -0
- package/assets/skills/docx/references/openxml_namespaces.md +82 -0
- package/assets/skills/docx/references/openxml_units.md +72 -0
- package/assets/skills/docx/references/sample-patch-plans.json +22 -0
- package/assets/skills/docx/references/sample-task-intents.json +5 -0
- package/assets/skills/docx/references/sample-template-manifests.json +21 -0
- package/assets/skills/docx/references/scenario_a_create.md +284 -0
- package/assets/skills/docx/references/scenario_b_edit_content.md +295 -0
- package/assets/skills/docx/references/scenario_c_apply_template.md +456 -0
- package/assets/skills/docx/references/track_changes_guide.md +200 -0
- package/assets/skills/docx/references/troubleshooting.md +506 -0
- package/assets/skills/docx/references/typography_guide.md +294 -0
- package/assets/skills/docx/references/xsd_validation_guide.md +158 -0
- package/assets/skills/docx/scripts/build_patch_plan.py +29 -0
- package/assets/skills/docx/scripts/diff_docx_structure.py +61 -0
- package/assets/skills/docx/scripts/doc_to_docx.ps1 +85 -0
- package/assets/skills/docx/scripts/doc_to_docx.sh +40 -0
- package/assets/skills/docx/scripts/docx_preview.ps1 +76 -0
- package/assets/skills/docx/scripts/docx_preview.sh +37 -0
- package/assets/skills/docx/scripts/docx_to_pdf.py +87 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/AlranAIDocx.Cli.csproj +19 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/Program.cs +18 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/AlranAIDocx.Core.csproj +15 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/AnalyzeCommand.cs +147 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ApplyTemplateCommand.cs +322 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/CreateCommand.cs +324 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/DiffCommand.cs +155 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/EditContentCommand.cs +487 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/FixOrderCommand.cs +108 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/MergeRunsCommand.cs +122 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ValidateCommand.cs +107 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/CommentSynchronizer.cs +169 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/ElementOrder.cs +80 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/NamespaceConstants.cs +42 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/RunMerger.cs +81 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/StyleAnalyzer.cs +81 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/TrackChangesHelper.cs +99 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/UnitConverter.cs +23 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples.cs +1832 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch1.cs +910 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch2.cs +999 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch3.cs +1048 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch4.cs +1038 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/CharacterFormattingSamples.cs +1020 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/DocumentCreationSamples.cs +1121 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FieldAndTocSamples.cs +624 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FootnoteAndCommentSamples.cs +675 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/HeaderFooterSamples.cs +838 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ImageSamples.cs +917 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ListAndNumberingSamples.cs +826 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ParagraphFormattingSamples.cs +1199 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/StyleSystemSamples.cs +1487 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TableSamples.cs +1163 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TrackChangesSamples.cs +595 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/CjkHelper.cs +39 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/FontDefaults.cs +24 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/PageSizes.cs +20 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/BusinessRuleValidator.cs +224 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/GateCheckValidator.cs +148 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/ValidationResult.cs +23 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/XsdValidator.cs +69 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.slnx +4 -0
- package/assets/skills/docx/scripts/env_check.ps1 +327 -0
- package/assets/skills/docx/scripts/env_check.sh +340 -0
- package/assets/skills/docx/scripts/extract_docx_text.py +1075 -0
- package/assets/skills/docx/scripts/pack_docx.py +31 -0
- package/assets/skills/docx/scripts/read_docx_structure.py +1032 -0
- package/assets/skills/docx/scripts/render_docx_pages.py +147 -0
- package/assets/skills/docx/scripts/rendered_report.py +609 -0
- package/assets/skills/docx/scripts/setup.ps1 +542 -0
- package/assets/skills/docx/scripts/setup.sh +537 -0
- package/assets/skills/docx/scripts/unpack_docx.py +29 -0
- package/assets/skills/docx/scripts/validate_template_manifest.py +60 -0
- package/assets/skills/docx/scripts/verify_anchor_atomicity.py +87 -0
- package/assets/skills/edit-deployed-website/SKILL.md +27 -0
- package/assets/skills/init/SKILL.md +135 -0
- package/assets/skills/llm-call/SKILL.md +48 -0
- package/assets/skills/llm-call/scripts/llm_call.py +458 -0
- package/assets/skills/pdf/SKILL.md +280 -0
- package/assets/skills/pdf/docs/advanced-reference.md +711 -0
- package/assets/skills/pdf/docs/create-guide.md +437 -0
- package/assets/skills/pdf/docs/design-guide.md +204 -0
- package/assets/skills/pdf/docs/forms-guide.md +462 -0
- package/assets/skills/pdf/docs/html-pdf-spec.md +500 -0
- package/assets/skills/pdf/docs/latex-academic-thesis-guide.md +233 -0
- package/assets/skills/pdf/docs/latex-technical-book-guide.md +112 -0
- package/assets/skills/pdf/docs/pitfalls-index.md +792 -0
- package/assets/skills/pdf/docs/read-guide.md +358 -0
- package/assets/skills/pdf/docs/reformat-guide.md +238 -0
- package/assets/skills/pdf/docs/skill-readme-archive.md +151 -0
- package/assets/skills/pdf/docs/troubleshooting.md +86 -0
- package/assets/skills/pdf/docs/vision-guide.md +188 -0
- package/assets/skills/pdf/scripts/__init__.py +0 -0
- package/assets/skills/pdf/scripts/_pdf_read_lib.py +284 -0
- package/assets/skills/pdf/scripts/fill/__init__.py +0 -0
- package/assets/skills/pdf/scripts/fill/acroform_apply.py +153 -0
- package/assets/skills/pdf/scripts/fill/overlay_apply.py +109 -0
- package/assets/skills/pdf/scripts/lib/__init__.py +0 -0
- package/assets/skills/pdf/scripts/lib/acroform_io.py +170 -0
- package/assets/skills/pdf/scripts/lib/cli_utils.py +41 -0
- package/assets/skills/pdf/scripts/lib/geometry.py +79 -0
- package/assets/skills/pdf/scripts/make.sh +388 -0
- package/assets/skills/pdf/scripts/merge.py +112 -0
- package/assets/skills/pdf/scripts/pdf_inspect/__init__.py +0 -0
- package/assets/skills/pdf/scripts/pdf_inspect/acroform_inspect.py +52 -0
- package/assets/skills/pdf/scripts/pdf_inspect/acroform_probe.py +57 -0
- package/assets/skills/pdf/scripts/pdf_inspect/layout_scan.py +164 -0
- package/assets/skills/pdf/scripts/read_pdf_vision.py +473 -0
- package/assets/skills/pdf/scripts/reformat_parse.py +181 -0
- package/assets/skills/pdf/scripts/render/__init__.py +0 -0
- package/assets/skills/pdf/scripts/render/overlay_preview.py +86 -0
- package/assets/skills/pdf/scripts/render/page_rasterize.py +85 -0
- package/assets/skills/pdf/scripts/render_html.cjs +205 -0
- package/assets/skills/pdf/scripts/validate/__init__.py +0 -0
- package/assets/skills/pdf/scripts/validate/geometry_lint.py +124 -0
- package/assets/skills/pdf/templates/INDEX.md +90 -0
- package/assets/skills/pdf/templates/bilingual-menu-premium/README.md +175 -0
- package/assets/skills/pdf/templates/bilingual-menu-premium/skeleton.html +343 -0
- package/assets/skills/pdf/templates/brand-guide-2page/README.md +140 -0
- package/assets/skills/pdf/templates/brand-guide-2page/skeleton.html +264 -0
- package/assets/skills/pdf/templates/data-viz-report/README.md +234 -0
- package/assets/skills/pdf/templates/data-viz-report/skeleton.html +835 -0
- package/assets/skills/pdf/templates/form-fill-acroform/README.md +195 -0
- package/assets/skills/pdf/templates/form-fill-acroform/field_values.template.json +118 -0
- package/assets/skills/pdf/templates/latex-academic-thesis/README.md +146 -0
- package/assets/skills/pdf/templates/latex-academic-thesis/source.tex +334 -0
- package/assets/skills/pdf/templates/latex-technical-book/README.md +130 -0
- package/assets/skills/pdf/templates/latex-technical-book/README.template-source.md +62 -0
- package/assets/skills/pdf/templates/latex-technical-book/source.tex +439 -0
- package/assets/skills/pdf/templates/multi-article-aggregator/README.md +148 -0
- package/assets/skills/pdf/templates/multi-article-aggregator/pipeline.md +223 -0
- package/assets/skills/pdf/templates/multilang-research-report/README.md +136 -0
- package/assets/skills/pdf/templates/multilang-research-report/skeleton.html +242 -0
- package/assets/skills/pdf/templates/reformat-default/README.md +136 -0
- package/assets/skills/pdf/templates/reformat-default/skeleton.html +204 -0
- package/assets/skills/pdf/templates/translate-preserve-layout/README.md +136 -0
- package/assets/skills/pdf/templates/translate-preserve-layout/skeleton.html +96 -0
- package/assets/skills/pdf/templates/translate-preserve-layout/terminology.template.json +66 -0
- package/assets/skills/pptx/SKILL.md +283 -0
- package/assets/skills/pptx/references/design-system.md +424 -0
- package/assets/skills/pptx/references/editing.md +162 -0
- package/assets/skills/pptx/references/element-map.md +229 -0
- package/assets/skills/pptx/references/pitfalls.md +205 -0
- package/assets/skills/pptx/references/pptxgenjs.md +420 -0
- package/assets/skills/pptx/references/preview-selection-writeback.md +65 -0
- package/assets/skills/pptx/references/python-pptx-recipes.md +63 -0
- package/assets/skills/pptx/references/slide-types.md +413 -0
- package/assets/skills/pptx/scripts/alran-ppt-map.cjs +280 -0
- package/assets/skills/pptx/scripts/audit_pptx.py +708 -0
- package/assets/skills/pptx/scripts/extract_comments.py +468 -0
- package/assets/skills/pptx/scripts/extract_images.py +226 -0
- package/assets/skills/pptx/scripts/extract_pptx.py +285 -0
- package/assets/skills/pptx/scripts/pdf2png.swift +203 -0
- package/assets/skills/pptx/scripts/pptx-screenshot.sh +105 -0
- package/assets/skills/resume-codex/SKILL.md +53 -0
- package/assets/skills/resume-codex/scripts/session-reader.mjs +445 -0
- package/assets/skills/skill-creator/SKILL.md +188 -0
- package/assets/skills/skill-creator/references/anti-patterns.md +149 -0
- package/assets/skills/skill-creator/references/commands-macos-linux.md +38 -0
- package/assets/skills/skill-creator/references/commands-windows-powershell.md +48 -0
- package/assets/skills/skill-creator/references/description-rubric.md +83 -0
- package/assets/skills/skill-creator/references/skill-template.md +101 -0
- package/assets/skills/skill-creator/references/when-to-bundle-scripts.md +139 -0
- package/assets/skills/skill-creator/scripts/lint-skill.js +226 -0
- package/assets/skills/skill-refiner/SKILL.md +137 -0
- package/assets/skills/visual-page/SKILL.md +194 -0
- package/assets/skills/x-link-reader/SKILL.md +108 -0
- package/assets/skills/xlsx/SKILL.md +498 -0
- package/assets/skills/xlsx/docs/advanced-reference.md +410 -0
- package/assets/skills/xlsx/docs/conventions-guide.md +217 -0
- package/assets/skills/xlsx/docs/create-edit-guide.md +410 -0
- package/assets/skills/xlsx/docs/pitfalls-index.md +759 -0
- package/assets/skills/xlsx/docs/raw-xml-escape-hatch.md +201 -0
- package/assets/skills/xlsx/docs/recalc-guide.md +295 -0
- package/assets/skills/xlsx/scripts/office/helpers/__init__.py +0 -0
- package/assets/skills/xlsx/scripts/office/helpers/merge_runs.py +199 -0
- package/assets/skills/xlsx/scripts/office/helpers/simplify_redlines.py +197 -0
- package/assets/skills/xlsx/scripts/office/pack.py +159 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
- package/assets/skills/xlsx/scripts/office/schemas/mce/mc.xsd +75 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2010.xsd +560 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2012.xsd +67 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2018.xsd +14 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cex-2018.xsd +20 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cid-2016.xsd +13 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-symex-2015.xsd +8 -0
- package/assets/skills/xlsx/scripts/office/soffice.py +191 -0
- package/assets/skills/xlsx/scripts/office/unpack.py +132 -0
- package/assets/skills/xlsx/scripts/office/validate.py +117 -0
- package/assets/skills/xlsx/scripts/office/validators/__init__.py +15 -0
- package/assets/skills/xlsx/scripts/office/validators/base.py +851 -0
- package/assets/skills/xlsx/scripts/office/validators/docx.py +446 -0
- package/assets/skills/xlsx/scripts/office/validators/pptx.py +275 -0
- package/assets/skills/xlsx/scripts/office/validators/redlining.py +247 -0
- package/assets/skills/xlsx/scripts/recalc.py +450 -0
- package/chunks/account-commands-JZ6NXTTK.js +2 -0
- package/chunks/anthropic-MN33DP4E.js +2 -0
- package/chunks/application-ITGAJ4HC.js +2 -0
- package/chunks/auth-command-V3RVPLZO.js +2 -0
- package/chunks/azure-openai-responses-OWHMUNKC.js +2 -0
- package/chunks/chunk-2TF6JAQM.js +2 -0
- package/chunks/chunk-33CNY6GP.js +2 -0
- package/chunks/chunk-3AODGLMF.js +2 -0
- package/chunks/chunk-44VPC5LA.js +38 -0
- package/chunks/chunk-4CN3IJFH.js +2 -0
- package/chunks/chunk-4PDIO3M6.js +2 -0
- package/chunks/chunk-4X22UJQH.js +164 -0
- package/chunks/chunk-6255CZPL.js +2 -0
- package/chunks/chunk-6P4UKHGR.js +2 -0
- package/chunks/chunk-7QLAXRD2.js +1085 -0
- package/chunks/chunk-7XYOYZX2.js +2 -0
- package/chunks/chunk-A7GMJNA2.js +29 -0
- package/chunks/chunk-AGUSPIUP.js +2 -0
- package/chunks/chunk-BQ3CF3KE.js +2 -0
- package/chunks/chunk-C3CMJAAV.js +3 -0
- package/chunks/chunk-CJM7ZJ6W.js +7 -0
- package/chunks/chunk-CSOUJVKM.js +2 -0
- package/chunks/chunk-D66ZSHXR.js +2 -0
- package/chunks/chunk-D7MGU75P.js +2 -0
- package/chunks/chunk-E3GLGDGC.js +5 -0
- package/chunks/chunk-ENHOPPS7.js +16 -0
- package/chunks/chunk-EOR6EDNR.js +2 -0
- package/chunks/chunk-EYK25HWR.js +2 -0
- package/chunks/chunk-F46IELF5.js +2 -0
- package/chunks/chunk-FC4M2B7E.js +2 -0
- package/chunks/chunk-FSNYOJPJ.js +2 -0
- package/chunks/chunk-FUERW2DW.js +3 -0
- package/chunks/chunk-FXOH6TEQ.js +21 -0
- package/chunks/chunk-GP52JZMY.js +2 -0
- package/chunks/chunk-GRXX6I72.js +2 -0
- package/chunks/chunk-GSYHBK5Q.js +6 -0
- package/chunks/chunk-HNWBFJNO.js +2 -0
- package/chunks/chunk-IIE366LR.js +6706 -0
- package/chunks/chunk-IWK7PZP7.js +207 -0
- package/chunks/chunk-J3KCPYZT.js +2 -0
- package/chunks/chunk-KCLRJQ53.js +59 -0
- package/chunks/chunk-LU4RPLJ3.js +2 -0
- package/chunks/chunk-LZJYNT32.js +2 -0
- package/chunks/chunk-M7GW4VMR.js +27 -0
- package/chunks/chunk-MACBL5HF.js +2 -0
- package/chunks/chunk-N5NTXCJI.js +2 -0
- package/chunks/chunk-N5SVBCUB.js +7 -0
- package/chunks/chunk-N6W7ZL26.js +2 -0
- package/chunks/chunk-NWB7LFOK.js +131 -0
- package/chunks/chunk-OIQ336YE.js +16 -0
- package/chunks/chunk-OQNU3VPS.js +30 -0
- package/chunks/chunk-OTDNOWXG.js +16 -0
- package/chunks/chunk-PNXZWSWT.js +3 -0
- package/chunks/chunk-QFUV5PX6.js +2 -0
- package/chunks/chunk-QIN5ZBE2.js +2 -0
- package/chunks/chunk-QKBN5CGI.js +2 -0
- package/chunks/chunk-QPGTKSIQ.js +2 -0
- package/chunks/chunk-SIOLUFGG.js +2 -0
- package/chunks/chunk-TW23QKAD.js +3 -0
- package/chunks/chunk-U3RMPDXU.js +2 -0
- package/chunks/chunk-U7U3DJHF.js +2 -0
- package/chunks/chunk-VLXX22YO.js +2 -0
- package/chunks/chunk-WHD2XVT2.js +2 -0
- package/chunks/chunk-WTAJMYF2.js +249 -0
- package/chunks/chunk-WWNUAU4P.js +29 -0
- package/chunks/chunk-WYANV3IX.js +4 -0
- package/chunks/chunk-XAGZ6ZEU.js +9 -0
- package/chunks/chunk-XFCC2CI2.js +24 -0
- package/chunks/chunk-XQK7JM66.js +2 -0
- package/chunks/chunk-YLQXZBEL.js +2 -0
- package/chunks/chunk-YPV2X2RG.js +2 -0
- package/chunks/chunk-Z6BHCXKT.js +25 -0
- package/chunks/chunk-Z6HBNJCA.js +8 -0
- package/chunks/chunk-ZQKVUPKA.js +2 -0
- package/chunks/chunk-ZQOALVGL.js +2 -0
- package/chunks/clipboard-image-PQPC4EHR.js +2 -0
- package/chunks/data-dir-LDVKDCJ2.js +2 -0
- package/chunks/dist-2BRD4JFU.js +11 -0
- package/chunks/dist-EXKHRFQO.js +5 -0
- package/chunks/emscripten-module-RD6P2XH5.js +2 -0
- package/chunks/emscripten-module-WYNDFH3N.js +2 -0
- package/chunks/emscripten-module-XPTEOIWW.js +2 -0
- package/chunks/emscripten-module-ZS3PMSDF.js +2 -0
- package/chunks/ffi-IO7WZQNG.js +2 -0
- package/chunks/ffi-M5UP5J6C.js +2 -0
- package/chunks/ffi-ORLOPBB3.js +2 -0
- package/chunks/ffi-OUPK6AY6.js +2 -0
- package/chunks/google-UJAPMFAB.js +2 -0
- package/chunks/google-vertex-VLSF55PW.js +2 -0
- package/chunks/install-source-JTIUC4G4.js +2 -0
- package/chunks/launcher-FCZ3EDBF.js +61 -0
- package/chunks/lifecycle-GY435YMF.js +2 -0
- package/chunks/main-TQGGRHTS.js +13 -0
- package/chunks/mistral-ZJZUEF2X.js +3 -0
- package/chunks/module-6F3E5H7Y-BN7QWGYB.js +2 -0
- package/chunks/module-asyncify-R6PWJ6ZV-P4FWSBAY.js +2 -0
- package/chunks/multipart-parser-L6M455MS.js +2 -0
- package/chunks/network-proxy-U72JCK2I.js +2 -0
- package/chunks/openai-codex-responses-FPCDNRL5.js +2 -0
- package/chunks/openai-completions-D32YW6KL.js +2 -0
- package/chunks/openai-responses-ZCGSENM4.js +2 -0
- package/chunks/openrouter-G2EHY5BD.js +2 -0
- package/chunks/otel-OHXIZ666.js +2 -0
- package/chunks/package-contract-GVXTMJ3N.js +2 -0
- package/chunks/pdfjs-SHZAF7PF.js +107 -0
- package/chunks/photon_rs-C52RL4CI.js +3 -0
- package/chunks/plugin-command-OSAFHS7C.js +2 -0
- package/chunks/provider-command-SKTCHD4E.js +2 -0
- package/chunks/questionnaire-bridge-ISQOCYWY.js +2 -0
- package/chunks/run-acp-command-SG2BDMFJ.js +2 -0
- package/chunks/run-exec-command-5ADSQR2Z.js +15 -0
- package/chunks/skills-command-XXXEZAG6.js +2 -0
- package/chunks/src-DNIDEMVV.js +2 -0
- package/chunks/src-IBHIRTD7.js +2 -0
- package/chunks/telemetry-J7ZLGF5X.js +2 -0
- package/chunks/telemetry-command-COQG2AKK.js +5 -0
- package/chunks/tools-WDBB2JKV.js +2 -0
- package/chunks/undici-TUGHZJSA.js +2 -0
- package/chunks/update-NB6OD572.js +14 -0
- package/chunks/update-hint-ED7O67WU.js +3 -0
- package/chunks/wechat-onboard-UWXQW2HT.js +2 -0
- package/cli.js +5 -0
- package/configs/data-minimal.yaml +50 -0
- package/embedded/alran-tools/cli.mjs +4961 -0
- package/embedded/alran-tools/manifest.json +25 -0
- package/emscripten-module.wasm +0 -0
- package/image-preview-worker.js +2 -0
- package/internal-bin/alran-tools +9 -0
- package/internal-bin/alran-tools.cmd +8 -0
- package/matrix-mcp-stdio.js +4 -0
- package/native/darwin/prebuilds/darwin-arm64/darwin-modifiers.node +0 -0
- package/native/darwin/prebuilds/darwin-x64/darwin-modifiers.node +0 -0
- package/native/win32/prebuilds/win32-arm64/win32-console-mode.node +0 -0
- package/native/win32/prebuilds/win32-x64/win32-console-mode.node +0 -0
- package/package.json +38 -4
- package/photon_rs_bg.wasm +0 -0
- package/quickjs-worker.js +152 -0
- package/vendor/java-proxy-agent/build.ts +97 -0
- package/vendor/java-proxy-agent/srt-proxy-agent.jar +0 -0
- package/vendor/seccomp/arm64/apply-seccomp +0 -0
- package/vendor/seccomp/build.ts +74 -0
- package/vendor/seccomp/x64/apply-seccomp +0 -0
- package/vendor/srt-win/arm64/srt-win.exe +0 -0
- package/vendor/srt-win/build.ts +40 -0
- 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 --> · Date: <!-- DATE --> · <!-- 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 & 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 & 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 & 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 & 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 --> · <!-- DATE --> · Last review: <!-- LAST_REVIEW_DATE --></p>
|
|
239
|
+
</section>
|
|
240
|
+
|
|
241
|
+
</body>
|
|
242
|
+
</html>
|