@1aboveio/skills 0.0.0-stage → 1.0.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/README.md +30 -2
- package/bin/cli.mjs +14 -0
- package/bin/select-core.mjs +172 -0
- package/package.json +146 -4
- package/skills/app-dev/airflow/LICENSE +3 -0
- package/skills/app-dev/airflow/SKILL.md +199 -0
- package/skills/app-dev/airflow/release-check.mjs +93 -0
- package/skills/app-dev/android-foundation/LICENSE +3 -0
- package/skills/app-dev/android-foundation/SKILL.md +192 -0
- package/skills/app-dev/android-foundation/assets/android-ci-job.yml +217 -0
- package/skills/app-dev/android-foundation/references/ci.md +87 -0
- package/skills/app-dev/android-foundation/references/gotchas.md +221 -0
- package/skills/app-dev/android-foundation/references/setup.md +164 -0
- package/skills/app-dev/android-foundation/release-check.mjs +93 -0
- package/skills/app-dev/android-foundation/scripts/device-run.sh +176 -0
- package/skills/app-dev/android-foundation/scripts/device-run.test.mjs +172 -0
- package/skills/app-dev/app-debug/LICENSE +3 -0
- package/skills/app-dev/app-debug/SKILL.md +110 -0
- package/skills/app-dev/app-debug/references/common-errors.md +128 -0
- package/skills/app-dev/app-debug/release-check.mjs +93 -0
- package/skills/app-dev/better-auth/LICENSE +3 -0
- package/skills/app-dev/better-auth/SKILL.md +598 -0
- package/skills/app-dev/better-auth/references/feishu-api.md +270 -0
- package/skills/app-dev/better-auth/release-check.mjs +93 -0
- package/skills/app-dev/data-catalog/LICENSE +3 -0
- package/skills/app-dev/data-catalog/SKILL.md +204 -0
- package/skills/app-dev/data-catalog/agents/openai.yaml +3 -0
- package/skills/app-dev/data-catalog/references/data-catalog-conventions.md +75 -0
- package/skills/app-dev/data-catalog/references/field-definitions.md +116 -0
- package/skills/app-dev/data-catalog/references/format.md +121 -0
- package/skills/app-dev/data-catalog/release-check.mjs +93 -0
- package/skills/app-dev/data-catalog/scripts/data-catalog.test.mjs +36 -0
- package/skills/app-dev/data-catalog/scripts/data_catalog.py +1392 -0
- package/skills/app-dev/data-catalog/scripts/persist-conventions-core.mjs +117 -0
- package/skills/app-dev/data-catalog/scripts/persist-conventions.mjs +17 -0
- package/skills/app-dev/data-catalog/scripts/test_data_catalog.py +571 -0
- package/skills/app-dev/ios-foundation/LICENSE +3 -0
- package/skills/app-dev/ios-foundation/SKILL.md +184 -0
- package/skills/app-dev/ios-foundation/references/setup.md +243 -0
- package/skills/app-dev/ios-foundation/release-check.mjs +93 -0
- package/skills/app-dev/monorepo/LICENSE +3 -0
- package/skills/app-dev/monorepo/SKILL.md +462 -0
- package/skills/app-dev/monorepo/release-check.mjs +93 -0
- package/skills/app-dev/nextjs-fullstack/LICENSE +3 -0
- package/skills/app-dev/nextjs-fullstack/SKILL.md +211 -0
- package/skills/app-dev/nextjs-fullstack/conventions.md +318 -0
- package/skills/app-dev/nextjs-fullstack/frontend-conventions.md +61 -0
- package/skills/app-dev/nextjs-fullstack/nextjs16.md +287 -0
- package/skills/app-dev/nextjs-fullstack/release-check.mjs +93 -0
- package/skills/app-dev/nextjs-fullstack/server-actions.md +409 -0
- package/skills/app-dev/prisma-setup/LICENSE +3 -0
- package/skills/app-dev/prisma-setup/SKILL.md +181 -0
- package/skills/app-dev/prisma-setup/nextjs.md +258 -0
- package/skills/app-dev/prisma-setup/release-check.mjs +93 -0
- package/skills/app-dev/prisma-setup/turborepo.md +301 -0
- package/skills/app-dev/pyspark/LICENSE +3 -0
- package/skills/app-dev/pyspark/SKILL.md +127 -0
- package/skills/app-dev/pyspark/assets/templates/etl.py +748 -0
- package/skills/app-dev/pyspark/assets/templates/utils/__init__.py +1 -0
- package/skills/app-dev/pyspark/assets/templates/utils/hudi_metadata.py +14 -0
- package/skills/app-dev/pyspark/references/diagnosis-and-profiling.md +169 -0
- package/skills/app-dev/pyspark/references/etl-contract.md +129 -0
- package/skills/app-dev/pyspark/references/production-validation.md +131 -0
- package/skills/app-dev/pyspark/references/reconciliation.md +38 -0
- package/skills/app-dev/pyspark/references/transformation-design.md +190 -0
- package/skills/app-dev/pyspark/references/velocity-feature-calculation.md +193 -0
- package/skills/app-dev/pyspark/release-check.mjs +93 -0
- package/skills/app-dev/pyspark/scripts/spark_eventlog_summary.py +223 -0
- package/skills/app-dev/python-backend/LICENSE +3 -0
- package/skills/app-dev/python-backend/SKILL.md +325 -0
- package/skills/app-dev/python-backend/assets/uv-install.sh +48 -0
- package/skills/app-dev/python-backend/references/uv-installs.md +83 -0
- package/skills/app-dev/python-backend/release-check.mjs +93 -0
- package/skills/app-dev/shadcn/LICENSE +3 -0
- package/skills/app-dev/shadcn/SKILL.md +120 -0
- package/skills/app-dev/shadcn/assets/shadcn-small.png +0 -0
- package/skills/app-dev/shadcn/assets/shadcn.png +0 -0
- package/skills/app-dev/shadcn/cli.md +411 -0
- package/skills/app-dev/shadcn/customization.md +224 -0
- package/skills/app-dev/shadcn/mcp.md +101 -0
- package/skills/app-dev/shadcn/release-check.mjs +93 -0
- package/skills/app-dev/shadcn/rules/base-vs-radix.md +323 -0
- package/skills/app-dev/shadcn/rules/component-selection.md +67 -0
- package/skills/app-dev/shadcn/rules/composition.md +195 -0
- package/skills/app-dev/shadcn/rules/data-table.md +201 -0
- package/skills/app-dev/shadcn/rules/forms.md +255 -0
- package/skills/app-dev/shadcn/rules/icons.md +103 -0
- package/skills/app-dev/shadcn/rules/styling.md +167 -0
- package/skills/app-dev/zod-v4/LICENSE +3 -0
- package/skills/app-dev/zod-v4/SKILL.md +286 -0
- package/skills/app-dev/zod-v4/release-check.mjs +93 -0
- package/skills/cicd/cloud-build/LICENSE +3 -0
- package/skills/cicd/cloud-build/SKILL.md +707 -0
- package/skills/cicd/cloud-build/release-check.mjs +93 -0
- package/skills/cicd/cloud-debug/LICENSE +3 -0
- package/skills/cicd/cloud-debug/SKILL.md +315 -0
- package/skills/cicd/cloud-debug/references/build-failures.md +238 -0
- package/skills/cicd/cloud-debug/references/deploy-failures.md +376 -0
- package/skills/cicd/cloud-debug/references/pipeline-failures.md +378 -0
- package/skills/cicd/cloud-debug/release-check.mjs +93 -0
- package/skills/cicd/cloud-deploy/LICENSE +3 -0
- package/skills/cicd/cloud-deploy/SKILL.md +230 -0
- package/skills/cicd/cloud-deploy/references/config-templates.md +257 -0
- package/skills/cicd/cloud-deploy/release-check.mjs +93 -0
- package/skills/cicd/docker/LICENSE +3 -0
- package/skills/cicd/docker/SKILL.md +151 -0
- package/skills/cicd/docker/release-check.mjs +93 -0
- package/skills/cicd/github-actions/LICENSE +3 -0
- package/skills/cicd/github-actions/SKILL.md +111 -0
- package/skills/cicd/github-actions/references/audit-profile-optimize.md +150 -0
- package/skills/cicd/github-actions/references/ci-case-studies.md +141 -0
- package/skills/cicd/github-actions/references/conditional-ci.md +214 -0
- package/skills/cicd/github-actions/references/debugging.md +13 -0
- package/skills/cicd/github-actions/references/pipeline.md +87 -0
- package/skills/cicd/github-actions/references/post-deploy-and-publishing.md +33 -0
- package/skills/cicd/github-actions/references/runners.md +253 -0
- package/skills/cicd/github-actions/references/security.md +29 -0
- package/skills/cicd/github-actions/references/speed-and-audit.md +115 -0
- package/skills/cicd/github-actions/references/two-pass-reading.md +92 -0
- package/skills/cicd/github-actions/release-check.mjs +93 -0
- package/skills/cicd/github-actions/scripts/ci-run-audit-core.mjs +612 -0
- package/skills/cicd/github-actions/scripts/ci-run-audit.mjs +4 -0
- package/skills/cicd/github-actions/scripts/ci-run-audit.test.mjs +637 -0
- package/skills/cicd/github-flow/LICENSE +3 -0
- package/skills/cicd/github-flow/SKILL.md +123 -0
- package/skills/cicd/github-flow/references/ci-conventions.md +14 -0
- package/skills/cicd/github-flow/release-check.mjs +93 -0
- package/skills/cicd/github-flow/scripts/flow-core.mjs +105 -0
- package/skills/cicd/github-flow/scripts/flow.mjs +81 -0
- package/skills/cicd/github-flow/scripts/flow.test.mjs +114 -0
- package/skills/cicd/github-flow/scripts/persist-conventions-core.mjs +117 -0
- package/skills/cicd/github-flow/scripts/persist-conventions.mjs +49 -0
- package/skills/cicd/github-flow/scripts/persist-conventions.test.mjs +108 -0
- package/skills/cicd/google-cloud/LICENSE +3 -0
- package/skills/cicd/google-cloud/SKILL.md +119 -0
- package/skills/cicd/google-cloud/references/gcs.md +469 -0
- package/skills/cicd/google-cloud/references/iam.md +451 -0
- package/skills/cicd/google-cloud/references/project.md +349 -0
- package/skills/cicd/google-cloud/references/secrets.md +336 -0
- package/skills/cicd/google-cloud/references/vpc.md +312 -0
- package/skills/cicd/google-cloud/release-check.mjs +93 -0
- package/skills/cicd/google-cloud/scripts/create-sa.sh +36 -0
- package/skills/cicd/google-cloud/scripts/gcp-config.sh +31 -0
- package/skills/cicd/google-cloud/scripts/grant-iap.sh +41 -0
- package/skills/cicd/google-cloud/scripts/setup-secrets.sh +48 -0
- package/skills/cicd/mergify/LICENSE +3 -0
- package/skills/cicd/mergify/SKILL.md +102 -0
- package/skills/cicd/mergify/assets/templates/mergify.yml +215 -0
- package/skills/cicd/mergify/assets/templates/ruleset.json +46 -0
- package/skills/cicd/mergify/references/branch-protection.md +282 -0
- package/skills/cicd/mergify/references/configuration.md +274 -0
- package/skills/cicd/mergify/references/diagnosis.md +109 -0
- package/skills/cicd/mergify/references/stacks.md +84 -0
- package/skills/cicd/mergify/references/traps.md +119 -0
- package/skills/cicd/mergify/references/watch-contract.md +274 -0
- package/skills/cicd/mergify/release-check.mjs +93 -0
- package/skills/cicd/mergify/scripts/audit-core.mjs +208 -0
- package/skills/cicd/mergify/scripts/audit.mjs +4 -0
- package/skills/cicd/mergify/scripts/audit.test.mjs +201 -0
- package/skills/cicd/mergify/scripts/entrypoints.test.mjs +106 -0
- package/skills/cicd/mergify/scripts/pr-620-mergify-comments.fixture.json +30 -0
- package/skills/cicd/mergify/scripts/stack-push-core.mjs +258 -0
- package/skills/cicd/mergify/scripts/stack-push.mjs +4 -0
- package/skills/cicd/mergify/scripts/stack-push.test.mjs +233 -0
- package/skills/cicd/mergify/scripts/watch-pr-delivery-core.mjs +1065 -0
- package/skills/cicd/mergify/scripts/watch-pr-delivery.mjs +4 -0
- package/skills/cicd/mergify/scripts/watch-pr-delivery.test.mjs +1826 -0
- package/skills/cicd/podman/LICENSE +3 -0
- package/skills/cicd/podman/SKILL.md +71 -0
- package/skills/cicd/podman/agents/openai.yaml +4 -0
- package/skills/cicd/podman/assets/templates/podman-compose-socket-directory.yml +6 -0
- package/skills/cicd/podman/assets/templates/podman-service-override.conf +3 -0
- package/skills/cicd/podman/references/compose-compatibility.md +70 -0
- package/skills/cicd/podman/references/networking-and-ports.md +74 -0
- package/skills/cicd/podman/references/rootless-services-and-sockets.md +156 -0
- package/skills/cicd/podman/references/troubleshooting.md +98 -0
- package/skills/cicd/podman/release-check.mjs +93 -0
- package/skills/content/article-review/LICENSE +3 -0
- package/skills/content/article-review/SKILL.md +66 -0
- package/skills/content/article-review/references/report-format.md +68 -0
- package/skills/content/article-review/references/template-guide.md +79 -0
- package/skills/content/article-review/references/template-wechat-payments.md +125 -0
- package/skills/content/article-review/release-check.mjs +93 -0
- package/skills/content/article-to-image/LICENSE +3 -0
- package/skills/content/article-to-image/SKILL.md +91 -0
- package/skills/content/article-to-image/references/formats.md +53 -0
- package/skills/content/article-to-image/release-check.mjs +93 -0
- package/skills/content/flowchart-svg/LICENSE +3 -0
- package/skills/content/flowchart-svg/SKILL.md +43 -0
- package/skills/content/flowchart-svg/release-check.mjs +93 -0
- package/skills/content/flowchart-svg/scripts/export_png.sh +8 -0
- package/skills/content/image-gen/LICENSE +3 -0
- package/skills/content/image-gen/SKILL.md +192 -0
- package/skills/content/image-gen/release-check.mjs +93 -0
- package/skills/content/image-gen/scripts/credentials.mjs +217 -0
- package/skills/content/image-gen/scripts/credentials.test.mjs +212 -0
- package/skills/content/image-gen/scripts/generate.mjs +240 -0
- package/skills/content/image-gen/scripts/options.mjs +293 -0
- package/skills/content/image-gen/scripts/options.test.mjs +245 -0
- package/skills/content/mermaid/LICENSE +3 -0
- package/skills/content/mermaid/SKILL.md +635 -0
- package/skills/content/mermaid/release-check.mjs +93 -0
- package/skills/content/wechat-article-writer/LICENSE +3 -0
- package/skills/content/wechat-article-writer/SKILL.md +92 -0
- package/skills/content/wechat-article-writer/references/style-selector.md +133 -0
- package/skills/content/wechat-article-writer/references/writing-rules.md +152 -0
- package/skills/content/wechat-article-writer/release-check.mjs +93 -0
- package/skills/content/wechat-article-writer/templates/wechat-comparison.md +52 -0
- package/skills/content/wechat-article-writer/templates/wechat-howto.md +51 -0
- package/skills/content/wechat-article-writer/templates/wechat-insight.md +50 -0
- package/skills/content/wechat-article-writer/templates/wechat-pitfall.md +52 -0
- package/skills/content/wechat-publisher/LICENSE +3 -0
- package/skills/content/wechat-publisher/SKILL.md +171 -0
- package/skills/content/wechat-publisher/references/api.md +105 -0
- package/skills/content/wechat-publisher/references/layout-rules.md +57 -0
- package/skills/content/wechat-publisher/references/wechat-safe-template.html +86 -0
- package/skills/content/wechat-publisher/release-check.mjs +93 -0
- package/skills/content/wechat-publisher/scripts/md_to_wechat_html.py +194 -0
- package/skills/content/wechat-publisher/scripts/publish.py +239 -0
- package/skills/content/wechat-search/LICENSE +3 -0
- package/skills/content/wechat-search/SKILL.md +211 -0
- package/skills/content/wechat-search/release-check.mjs +93 -0
- package/skills/content/wechat-search/scripts/start-chrome.sh +83 -0
- package/skills/content/xai-search/LICENSE +3 -0
- package/skills/content/xai-search/SKILL.md +79 -0
- package/skills/content/xai-search/release-check.mjs +93 -0
- package/skills/content/xai-search/scripts/xai_search.sh +187 -0
- package/skills/content/xai-search/tests/smoke_test.sh +36 -0
- package/skills/core/distill-writing/LICENSE +3 -0
- package/skills/core/distill-writing/SKILL.md +74 -0
- package/skills/core/distill-writing/references/extraction.md +95 -0
- package/skills/core/distill-writing/references/updating.md +46 -0
- package/skills/core/distill-writing/release-check.mjs +93 -0
- package/skills/core/doc-to-md/LICENSE +3 -0
- package/skills/core/doc-to-md/SKILL.md +78 -0
- package/skills/core/doc-to-md/release-check.mjs +93 -0
- package/skills/core/doc-to-md/scripts/convert.py +157 -0
- package/skills/core/editorial-review/LICENSE +3 -0
- package/skills/core/editorial-review/SKILL.md +79 -0
- package/skills/core/editorial-review/references/checklist.md +94 -0
- package/skills/core/editorial-review/release-check.mjs +93 -0
- package/skills/core/house-style/LICENSE +3 -0
- package/skills/core/house-style/SKILL.md +33 -0
- package/skills/core/house-style/references/defaults.md +66 -0
- package/skills/core/house-style/references/rules.md +267 -0
- package/skills/core/house-style/references/sources.md +27 -0
- package/skills/core/house-style/references/style-en.md +131 -0
- package/skills/core/house-style/references/style-zh.md +141 -0
- package/skills/core/house-style/references/terminology-zh.md +223 -0
- package/skills/core/house-style/release-check.mjs +93 -0
- package/skills/core/house-style/templates/brd.md +103 -0
- package/skills/core/house-style/templates/commercial-proposal.md +93 -0
- package/skills/core/house-style/templates/compliance-policy.md +109 -0
- package/skills/core/house-style/templates/gap-analysis.md +105 -0
- package/skills/core/house-style/templates/general.md +63 -0
- package/skills/core/house-style/templates/integration-guide.md +98 -0
- package/skills/core/house-style/templates/prd.md +81 -0
- package/skills/core/house-style/templates/risk-operations-procedure.md +94 -0
- package/skills/core/house-style/templates/technical-spec.md +96 -0
- package/skills/core/polish-cn/LICENSE +3 -0
- package/skills/core/polish-cn/SKILL.md +102 -0
- package/skills/core/polish-cn/references/brief.md +93 -0
- package/skills/core/polish-cn/references/models.md +76 -0
- package/skills/core/polish-cn/release-check.mjs +93 -0
- package/skills/core/polish-cn/scripts/polish-cn.test.mjs +244 -0
- package/skills/core/polish-cn/scripts/polish_blocks.py +489 -0
- package/skills/core/reg-parser/LICENSE +3 -0
- package/skills/core/reg-parser/SKILL.md +212 -0
- package/skills/core/reg-parser/references/checklist-schema.md +223 -0
- package/skills/core/reg-parser/references/checklists/hk-amlo-checklist.json +1306 -0
- package/skills/core/reg-parser/references/checklists/hk-amlo-checklist.md +469 -0
- package/skills/core/reg-parser/references/checklists/hk-fi-corporate-onboarding-cdd-checklist.json +634 -0
- package/skills/core/reg-parser/references/checklists/hk-fi-corporate-onboarding-cdd-checklist.md +233 -0
- package/skills/core/reg-parser/references/checklists/hk-mso-guideline-checklist.json +2194 -0
- package/skills/core/reg-parser/references/checklists/hk-mso-guideline-checklist.md +771 -0
- package/skills/core/reg-parser/references/checklists/kyc-aml-checklist.md +258 -0
- package/skills/core/reg-parser/references/checklists/visa-vars-checklist.md +1058 -0
- package/skills/core/reg-parser/references/mandates/hk-amlo-cap615.md +389 -0
- package/skills/core/reg-parser/references/mandates/visa-vars.md +205 -0
- package/skills/core/reg-parser/release-check.mjs +93 -0
- package/skills/core/reg-parser/scripts/compare_checklist.py +230 -0
- package/skills/core/reg-parser/scripts/dump_checklist.py +361 -0
- package/skills/core/reg-parser/scripts/preprocess-mandate.sh +187 -0
- package/skills/core/reg-parser/scripts/reg-parser.test.mjs +165 -0
- package/skills/core/reg-parser/scripts/test_quarantine.sh +105 -0
- package/skills/core/reg-parser/scripts/validate_checklist.py +563 -0
- package/skills/core/reg-parser/scripts/validate_mandate.py +273 -0
- package/skills/core/terminology/LICENSE +3 -0
- package/skills/core/terminology/SKILL.md +62 -0
- package/skills/core/terminology/references/format.md +50 -0
- package/skills/core/terminology/references/init.md +32 -0
- package/skills/core/terminology/release-check.mjs +93 -0
- package/skills/core/write-doc/LICENSE +3 -0
- package/skills/core/write-doc/SKILL.md +141 -0
- package/skills/core/write-doc/references/bilingual.md +60 -0
- package/skills/core/write-doc/release-check.mjs +93 -0
- package/skills/engineering/better-review/LICENSE +3 -0
- package/skills/engineering/better-review/SKILL.md +249 -0
- package/skills/engineering/better-review/agents/openai.yaml +9 -0
- package/skills/engineering/better-review/references/domain-hazards.md +53 -0
- package/skills/engineering/better-review/references/passes.md +147 -0
- package/skills/engineering/better-review/references/result.md +151 -0
- package/skills/engineering/better-review/release-check.mjs +93 -0
- package/skills/engineering/better-review/scripts/pr-context.mjs +212 -0
- package/skills/engineering/better-review/scripts/pr-context.test.mjs +168 -0
- package/skills/engineering/better-review/scripts/rereview-scope.mjs +503 -0
- package/skills/engineering/better-review/scripts/rereview-scope.test.mjs +587 -0
- package/skills/engineering/better-review/scripts/scan-diff.mjs +365 -0
- package/skills/engineering/better-review/scripts/scan-diff.test.mjs +414 -0
- package/skills/engineering/better-review/scripts/vendor-sync.test.mjs +96 -0
- package/skills/engineering/e2e-test/LICENSE +3 -0
- package/skills/engineering/e2e-test/SKILL.md +98 -0
- package/skills/engineering/e2e-test/assets/ci-gates.cloudbuild.yaml +24 -0
- package/skills/engineering/e2e-test/references/authoring/auth-flows.md +159 -0
- package/skills/engineering/e2e-test/references/authoring/playwright-config.md +73 -0
- package/skills/engineering/e2e-test/references/authoring/playwright-patterns.md +144 -0
- package/skills/engineering/e2e-test/references/ci-integration.md +25 -0
- package/skills/engineering/e2e-test/references/ci-playwright-container.md +290 -0
- package/skills/engineering/e2e-test/references/presentation-sweep.md +104 -0
- package/skills/engineering/e2e-test/references/reviewing.md +41 -0
- package/skills/engineering/e2e-test/references/route-manifest.md +51 -0
- package/skills/engineering/e2e-test/release-check.mjs +93 -0
- package/skills/engineering/e2e-test/scripts/detect-routes-nextjs.mjs +200 -0
- package/skills/engineering/e2e-test/scripts/presentation-checks.mjs +171 -0
- package/skills/engineering/e2e-test/scripts/presentation-checks.test.mjs +106 -0
- package/skills/engineering/e2e-test/scripts/presentation-perceivability.mjs +179 -0
- package/skills/engineering/e2e-test/scripts/presentation-perceivability.test.mjs +117 -0
- package/skills/engineering/e2e-test/scripts/presentation-reachability.mjs +154 -0
- package/skills/engineering/e2e-test/scripts/presentation-reachability.test.mjs +69 -0
- package/skills/engineering/e2e-test/scripts/presentation-render-health.mjs +141 -0
- package/skills/engineering/e2e-test/scripts/presentation-render-health.test.mjs +98 -0
- package/skills/engineering/e2e-test/scripts/presentation-sweep.mjs +147 -0
- package/skills/engineering/e2e-test/scripts/presentation-sweep.test.mjs +71 -0
- package/skills/engineering/e2e-test/scripts/presentation-temporal.mjs +127 -0
- package/skills/engineering/e2e-test/scripts/presentation-temporal.test.mjs +59 -0
- package/skills/engineering/e2e-test/scripts/project-route-manifest.mjs +82 -0
- package/skills/engineering/e2e-test/scripts/project-route-manifest.test.mjs +76 -0
- package/skills/engineering/e2e-test/scripts/validate-manifest.mjs +106 -0
- package/skills/engineering/engineering-runtime/LICENSE +3 -0
- package/skills/engineering/engineering-runtime/SKILL.md +11 -0
- package/skills/engineering/engineering-runtime/agents/openai.yaml +6 -0
- package/skills/engineering/engineering-runtime/coherence/workflow.json +597 -0
- package/skills/engineering/engineering-runtime/engineering-runtime.test.mjs +68 -0
- package/skills/engineering/engineering-runtime/release-check.mjs +93 -0
- package/skills/engineering/engineering-runtime/scripts/exact-head-artifact.mjs +131 -0
- package/skills/engineering/engineering-runtime/scripts/head-check-set.mjs +398 -0
- package/skills/engineering/engineering-runtime/scripts/invocation-policy.mjs +187 -0
- package/skills/engineering/engineering-runtime/scripts/invocation-policy.test.mjs +95 -0
- package/skills/engineering/engineering-runtime/scripts/main-module.mjs +79 -0
- package/skills/engineering/engineering-runtime/scripts/main-module.test.mjs +288 -0
- package/skills/engineering/engineering-runtime/scripts/mergify-yaml.mjs +11 -0
- package/skills/engineering/engineering-runtime/scripts/package-lock.json +43 -0
- package/skills/engineering/engineering-runtime/scripts/package.json +10 -0
- package/skills/engineering/engineering-runtime/scripts/required-check-plan.mjs +223 -0
- package/skills/engineering/engineering-runtime/scripts/required-check-plan.test.mjs +96 -0
- package/skills/engineering/engineering-runtime/scripts/review-completion.mjs +56 -0
- package/skills/engineering/engineering-runtime/scripts/workflow-coherence.mjs +595 -0
- package/skills/engineering/engineering-runtime/scripts/workflow-policy.mjs +189 -0
- package/skills/engineering/engineering-runtime/scripts/yaml-mapping.mjs +18 -0
- package/skills/engineering/ensure-coverage/LICENSE +3 -0
- package/skills/engineering/ensure-coverage/SKILL.md +129 -0
- package/skills/engineering/ensure-coverage/references/breadth/coverage-ledger.md +92 -0
- package/skills/engineering/ensure-coverage/references/breadth/inventory-contract.md +85 -0
- package/skills/engineering/ensure-coverage/references/breadth/surface-baseline.md +44 -0
- package/skills/engineering/ensure-coverage/references/breadth/surface-discovery.md +16 -0
- package/skills/engineering/ensure-coverage/references/depth/characterization.md +68 -0
- package/skills/engineering/ensure-coverage/references/depth/coverage.config.example.json +19 -0
- package/skills/engineering/ensure-coverage/references/depth/grading.md +35 -0
- package/skills/engineering/ensure-coverage/references/depth/mock-policy.md +57 -0
- package/skills/engineering/ensure-coverage/references/depth/test-smells.md +39 -0
- package/skills/engineering/ensure-coverage/references/enforcement/ci-contract.md +44 -0
- package/skills/engineering/ensure-coverage/references/examples/coverage-ledger.md +110 -0
- package/skills/engineering/ensure-coverage/references/examples/refund-flow.md +35 -0
- package/skills/engineering/ensure-coverage/references/presentation/axis.md +64 -0
- package/skills/engineering/ensure-coverage/references/process/audit-mode.md +27 -0
- package/skills/engineering/ensure-coverage/references/process/output-template.md +139 -0
- package/skills/engineering/ensure-coverage/references/process/test-strategy.md +56 -0
- package/skills/engineering/ensure-coverage/release-check.mjs +93 -0
- package/skills/engineering/ensure-coverage/schemas/coverage-config.schema.json +67 -0
- package/skills/engineering/ensure-coverage/schemas/coverage-file.schema.json +140 -0
- package/skills/engineering/ensure-coverage/scripts/README.md +99 -0
- package/skills/engineering/ensure-coverage/scripts/adapters/nextjs-inventory.mjs +182 -0
- package/skills/engineering/ensure-coverage/scripts/adapters/nextjs-inventory.test.mjs +96 -0
- package/skills/engineering/ensure-coverage/scripts/check-quarantine-expiry.mjs +105 -0
- package/skills/engineering/ensure-coverage/scripts/check-quarantine-expiry.test.mjs +47 -0
- package/skills/engineering/ensure-coverage/scripts/ci-audit.mjs +137 -0
- package/skills/engineering/ensure-coverage/scripts/ci-audit.test.mjs +86 -0
- package/skills/engineering/ensure-coverage/scripts/coverage-ledger.mjs +674 -0
- package/skills/engineering/ensure-coverage/scripts/coverage-ledger.test.mjs +447 -0
- package/skills/engineering/ensure-coverage/scripts/design-parity.mjs +591 -0
- package/skills/engineering/ensure-coverage/scripts/design-parity.test.mjs +552 -0
- package/skills/engineering/ensure-coverage/scripts/lint-tests.mjs +282 -0
- package/skills/engineering/ensure-coverage/scripts/lint-tests.test.mjs +289 -0
- package/skills/engineering/ensure-coverage/scripts/mock-policy-config.mjs +176 -0
- package/skills/engineering/ensure-coverage/scripts/mock-policy-config.test.mjs +119 -0
- package/skills/engineering/ensure-coverage/scripts/package.json +19 -0
- package/skills/engineering/golden-path/LICENSE +3 -0
- package/skills/engineering/golden-path/SKILL.md +230 -0
- package/skills/engineering/golden-path/agents/openai.yaml +3 -0
- package/skills/engineering/golden-path/assets/golden-paths.example.json +57 -0
- package/skills/engineering/golden-path/references/contract.md +239 -0
- package/skills/engineering/golden-path/references/migration.md +111 -0
- package/skills/engineering/golden-path/release-check.mjs +93 -0
- package/skills/engineering/golden-path/scripts/golden-path-core.mjs +1779 -0
- package/skills/engineering/golden-path/scripts/golden-path.mjs +6 -0
- package/skills/engineering/golden-path/scripts/golden-path.test.mjs +1457 -0
- package/skills/engineering/harness-runtime/LICENSE +3 -0
- package/skills/engineering/harness-runtime/SKILL.md +19 -0
- package/skills/engineering/harness-runtime/agents/openai.yaml +6 -0
- package/skills/engineering/harness-runtime/bin/discover-models.mjs +4 -0
- package/skills/engineering/harness-runtime/bin/model-catalog.mjs +4 -0
- package/skills/engineering/harness-runtime/contracts.md +15 -0
- package/skills/engineering/harness-runtime/discover-models.mjs +392 -0
- package/skills/engineering/harness-runtime/discover-models.test.mjs +363 -0
- package/skills/engineering/harness-runtime/fixtures/native-question-schemas.json +33 -0
- package/skills/engineering/harness-runtime/fixtures/question-responses.json +54 -0
- package/skills/engineering/harness-runtime/harness-runtime.test.mjs +967 -0
- package/skills/engineering/harness-runtime/index.mjs +767 -0
- package/skills/engineering/harness-runtime/model-catalog-seed.test.mjs +829 -0
- package/skills/engineering/harness-runtime/model-catalog.mjs +787 -0
- package/skills/engineering/harness-runtime/model-catalog.test.mjs +366 -0
- package/skills/engineering/harness-runtime/native-question-contracts.md +37 -0
- package/skills/engineering/harness-runtime/references/model-catalog-seed.json +408 -0
- package/skills/engineering/harness-runtime/references/model-catalog.md +57 -0
- package/skills/engineering/harness-runtime/release-check.mjs +93 -0
- package/skills/engineering/resolve-issues/LICENSE +3 -0
- package/skills/engineering/resolve-issues/SKILL.md +250 -0
- package/skills/engineering/resolve-issues/agents/openai.yaml +9 -0
- package/skills/engineering/resolve-issues/plugin-hooks.json +17 -0
- package/skills/engineering/resolve-issues/references/canary.md +28 -0
- package/skills/engineering/resolve-issues/references/ci.md +105 -0
- package/skills/engineering/resolve-issues/references/done.md +25 -0
- package/skills/engineering/resolve-issues/references/dropbox.md +90 -0
- package/skills/engineering/resolve-issues/references/expire.md +318 -0
- package/skills/engineering/resolve-issues/references/exploration.md +202 -0
- package/skills/engineering/resolve-issues/references/implementation.md +303 -0
- package/skills/engineering/resolve-issues/references/preflight.md +445 -0
- package/skills/engineering/resolve-issues/references/review.md +228 -0
- package/skills/engineering/resolve-issues/references/shared-modules.md +44 -0
- package/skills/engineering/resolve-issues/references/task-plan.md +264 -0
- package/skills/engineering/resolve-issues/release-check.mjs +93 -0
- package/skills/engineering/resolve-issues/scripts/cleanup-runs.mjs +364 -0
- package/skills/engineering/resolve-issues/scripts/cleanup-runs.test.mjs +280 -0
- package/skills/engineering/resolve-issues/scripts/discover-models.mjs +9 -0
- package/skills/engineering/resolve-issues/scripts/dropbox.mjs +473 -0
- package/skills/engineering/resolve-issues/scripts/dropbox.test.mjs +346 -0
- package/skills/engineering/resolve-issues/scripts/findings-reuse.mjs +98 -0
- package/skills/engineering/resolve-issues/scripts/findings-reuse.test.mjs +88 -0
- package/skills/engineering/resolve-issues/scripts/github-reviews.mjs +384 -0
- package/skills/engineering/resolve-issues/scripts/github-reviews.test.mjs +264 -0
- package/skills/engineering/resolve-issues/scripts/install-hooks.mjs +135 -0
- package/skills/engineering/resolve-issues/scripts/install-hooks.test.mjs +79 -0
- package/skills/engineering/resolve-issues/scripts/issue-tree.mjs +162 -0
- package/skills/engineering/resolve-issues/scripts/issue-tree.test.mjs +107 -0
- package/skills/engineering/resolve-issues/scripts/manual-invocation.test.mjs +14 -0
- package/skills/engineering/resolve-issues/scripts/model-catalog.mjs +9 -0
- package/skills/engineering/resolve-issues/scripts/next-actions-capacity.test.mjs +149 -0
- package/skills/engineering/resolve-issues/scripts/next-actions.mjs +856 -0
- package/skills/engineering/resolve-issues/scripts/next-actions.test.mjs +915 -0
- package/skills/engineering/resolve-issues/scripts/plan-sync.mjs +269 -0
- package/skills/engineering/resolve-issues/scripts/plan-sync.test.mjs +156 -0
- package/skills/engineering/resolve-issues/scripts/preflight-models.mjs +736 -0
- package/skills/engineering/resolve-issues/scripts/preflight-models.test.mjs +448 -0
- package/skills/engineering/resolve-issues/scripts/ready-check.mjs +185 -0
- package/skills/engineering/resolve-issues/scripts/ready-check.test.mjs +217 -0
- package/skills/engineering/resolve-issues/scripts/rehydrate.mjs +98 -0
- package/skills/engineering/resolve-issues/scripts/rehydrate.test.mjs +91 -0
- package/skills/engineering/resolve-issues/scripts/review-verdict.mjs +509 -0
- package/skills/engineering/resolve-issues/scripts/review-verdict.test.mjs +1060 -0
- package/skills/engineering/resolve-issues/scripts/size-check.mjs +492 -0
- package/skills/engineering/resolve-issues/scripts/size-check.test.mjs +458 -0
- package/skills/engineering/resolve-release/LICENSE +3 -0
- package/skills/engineering/resolve-release/SKILL.md +215 -0
- package/skills/engineering/resolve-release/agents/openai.yaml +8 -0
- package/skills/engineering/resolve-release/flows/cloud-run-canary.md +13 -0
- package/skills/engineering/resolve-release/flows/cloud-run.md +7 -0
- package/skills/engineering/resolve-release/flows/root-tag-npm.md +13 -0
- package/skills/engineering/resolve-release/flows/workspace-npm.md +22 -0
- package/skills/engineering/resolve-release/references/canary.md +51 -0
- package/skills/engineering/resolve-release/references/candidate.md +41 -0
- package/skills/engineering/resolve-release/references/cut.md +131 -0
- package/skills/engineering/resolve-release/references/dark-launch.md +66 -0
- package/skills/engineering/resolve-release/references/flows.md +150 -0
- package/skills/engineering/resolve-release/references/preflight.md +154 -0
- package/skills/engineering/resolve-release/references/prepared-metadata.md +260 -0
- package/skills/engineering/resolve-release/references/promotion.md +82 -0
- package/skills/engineering/resolve-release/references/publish.md +232 -0
- package/skills/engineering/resolve-release/references/workspace-npm.md +103 -0
- package/skills/engineering/resolve-release/release-check.mjs +93 -0
- package/skills/engineering/resolve-release/scripts/apply.mjs +212 -0
- package/skills/engineering/resolve-release/scripts/apply.test.mjs +99 -0
- package/skills/engineering/resolve-release/scripts/dark-flags.mjs +134 -0
- package/skills/engineering/resolve-release/scripts/dark-flags.test.mjs +100 -0
- package/skills/engineering/resolve-release/scripts/flow.mjs +500 -0
- package/skills/engineering/resolve-release/scripts/flow.test.mjs +340 -0
- package/skills/engineering/resolve-release/scripts/green-head.mjs +231 -0
- package/skills/engineering/resolve-release/scripts/green-head.test.mjs +101 -0
- package/skills/engineering/resolve-release/scripts/npm-version-absence.mjs +138 -0
- package/skills/engineering/resolve-release/scripts/npm-version-absence.test.mjs +426 -0
- package/skills/engineering/resolve-release/scripts/plan-npm.test.mjs +659 -0
- package/skills/engineering/resolve-release/scripts/plan-toml-boundary.test.mjs +317 -0
- package/skills/engineering/resolve-release/scripts/plan-uv.test.mjs +291 -0
- package/skills/engineering/resolve-release/scripts/plan.mjs +806 -0
- package/skills/engineering/resolve-release/scripts/plan.test.mjs +428 -0
- package/skills/engineering/rush-issues/LICENSE +3 -0
- package/skills/engineering/rush-issues/SKILL.md +58 -0
- package/skills/engineering/rush-issues/agents/openai.yaml +8 -0
- package/skills/engineering/rush-issues/rehydrate.mjs +10 -0
- package/skills/engineering/rush-issues/release-check.mjs +93 -0
- package/skills/engineering/rush-release/LICENSE +3 -0
- package/skills/engineering/rush-release/SKILL.md +35 -0
- package/skills/engineering/rush-release/agents/openai.yaml +8 -0
- package/skills/engineering/rush-release/release-check.mjs +93 -0
- package/skills/engineering/test-quality/LICENSE +3 -0
- package/skills/engineering/test-quality/SKILL.md +79 -0
- package/skills/engineering/test-quality/references/audit.md +80 -0
- package/skills/engineering/test-quality/references/lint.md +24 -0
- package/skills/engineering/test-quality/references/principles.md +143 -0
- package/skills/engineering/test-quality/references/testing-conventions.md +9 -0
- package/skills/engineering/test-quality/release-check.mjs +93 -0
- package/skills/engineering/test-quality/scripts/lint-tests.mjs +574 -0
- package/skills/engineering/test-quality/scripts/lint-tests.test.mjs +591 -0
- package/skills/engineering/test-quality/scripts/mock-policy-config.mjs +176 -0
- package/skills/engineering/test-quality/scripts/mock-policy-config.test.mjs +119 -0
- package/skills/engineering/test-quality/scripts/persist-conventions-core.mjs +117 -0
- package/skills/engineering/test-quality/scripts/persist-conventions.mjs +17 -0
- package/skills/engineering/test-quality/scripts/persist-conventions.test.mjs +104 -0
- package/skills/risk-compliance/compliance-audit/LICENSE +3 -0
- package/skills/risk-compliance/compliance-audit/SKILL.md +439 -0
- package/skills/risk-compliance/compliance-audit/references/findings-schema.md +293 -0
- package/skills/risk-compliance/compliance-audit/references/normalization-rules.md +45 -0
- package/skills/risk-compliance/compliance-audit/references/vars-checklist.md +1068 -0
- package/skills/risk-compliance/compliance-audit/references/vars-findings-schema.md +398 -0
- package/skills/risk-compliance/compliance-audit/release-check.mjs +93 -0
- package/skills/risk-compliance/compliance-audit/scripts/compliance-audit.test.mjs +14 -0
- package/skills/risk-compliance/compliance-audit/scripts/export_tracker_xlsx.py +221 -0
- package/skills/risk-compliance/compliance-audit/scripts/reconcile_tracker.py +458 -0
- package/skills/risk-compliance/compliance-audit/scripts/test_export_tracker_xlsx.py +97 -0
- package/skills/risk-compliance/compliance-audit/scripts/test_validate_tracker.py +157 -0
- package/skills/risk-compliance/compliance-audit/scripts/validate_tracker.py +829 -0
- package/skills/risk-compliance/contract-compare/LICENSE +3 -0
- package/skills/risk-compliance/contract-compare/SKILL.md +199 -0
- package/skills/risk-compliance/contract-compare/references/comparison-dimensions.md +209 -0
- package/skills/risk-compliance/contract-compare/release-check.mjs +93 -0
- package/skills/risk-compliance/contract-review/LICENSE +3 -0
- package/skills/risk-compliance/contract-review/SKILL.md +240 -0
- package/skills/risk-compliance/contract-review/references/review-criteria.md +223 -0
- package/skills/risk-compliance/contract-review/release-check.mjs +93 -0
- package/skills/risk-compliance/doc-authenticity/LICENSE +3 -0
- package/skills/risk-compliance/doc-authenticity/SKILL.md +160 -0
- package/skills/risk-compliance/doc-authenticity/agents/openai.yaml +8 -0
- package/skills/risk-compliance/doc-authenticity/manual-invocation.test.mjs +12 -0
- package/skills/risk-compliance/doc-authenticity/references/agreement.md +66 -0
- package/skills/risk-compliance/doc-authenticity/references/bank-statement.md +150 -0
- package/skills/risk-compliance/doc-authenticity/references/forensic-signals.md +157 -0
- package/skills/risk-compliance/doc-authenticity/references/image-signals.md +114 -0
- package/skills/risk-compliance/doc-authenticity/references/invoice.md +66 -0
- package/skills/risk-compliance/doc-authenticity/references/issuer-profiles.md +86 -0
- package/skills/risk-compliance/doc-authenticity/references/verdict-and-report.md +95 -0
- package/skills/risk-compliance/doc-authenticity/references/verdict.schema.json +81 -0
- package/skills/risk-compliance/doc-authenticity/release-check.mjs +93 -0
- package/skills/risk-compliance/doc-authenticity/scripts/image_forensics.py +294 -0
- package/skills/risk-compliance/doc-authenticity/scripts/pdf_forensics.py +401 -0
- package/skills/risk-compliance/doc-authenticity/scripts/validate_codes.py +224 -0
- package/skills/risk-compliance/doc-authenticity/scripts/validate_verdict.py +308 -0
- package/skills/risk-compliance/doc-authenticity/scripts/validate_verdict.test.mjs +212 -0
- package/skills/risk-compliance/fraud-analysis/LICENSE +3 -0
- package/skills/risk-compliance/fraud-analysis/SKILL.md +114 -0
- package/skills/risk-compliance/fraud-analysis/references/archetypes/authorized-payment-scam.md +41 -0
- package/skills/risk-compliance/fraud-analysis/references/archetypes/first-party-fraud.md +44 -0
- package/skills/risk-compliance/fraud-analysis/references/archetypes/third-party-fraud.md +27 -0
- package/skills/risk-compliance/fraud-analysis/references/contexts/bank-transfer.md +24 -0
- package/skills/risk-compliance/fraud-analysis/references/contexts/card-payment.md +30 -0
- package/skills/risk-compliance/fraud-analysis/references/contexts/payment-collection.md +20 -0
- package/skills/risk-compliance/fraud-analysis/references/contexts/payout.md +20 -0
- package/skills/risk-compliance/fraud-analysis/references/feature-engineering.md +158 -0
- package/skills/risk-compliance/fraud-analysis/references/mechanisms/account-takeover.md +36 -0
- package/skills/risk-compliance/fraud-analysis/references/report-rationale.md +45 -0
- package/skills/risk-compliance/fraud-analysis/references/report-template.md +190 -0
- package/skills/risk-compliance/fraud-analysis/references/review-checklist.md +175 -0
- package/skills/risk-compliance/fraud-analysis/references/taxonomy.md +79 -0
- package/skills/risk-compliance/fraud-analysis/references/terminology.md +108 -0
- package/skills/risk-compliance/fraud-analysis/references/workflow.md +175 -0
- package/skills/risk-compliance/fraud-analysis/release-check.mjs +93 -0
- package/skills/risk-compliance/payment-analysis/LICENSE +3 -0
- package/skills/risk-compliance/payment-analysis/SKILL.md +180 -0
- package/skills/risk-compliance/payment-analysis/references/auth-rate-actions.md +30 -0
- package/skills/risk-compliance/payment-analysis/references/chargebacks.md +208 -0
- package/skills/risk-compliance/payment-analysis/references/chinese-polish.md +51 -0
- package/skills/risk-compliance/payment-analysis/references/event-layers.md +127 -0
- package/skills/risk-compliance/payment-analysis/references/fx.md +59 -0
- package/skills/risk-compliance/payment-analysis/references/journey.md +79 -0
- package/skills/risk-compliance/payment-analysis/references/metrics.md +67 -0
- package/skills/risk-compliance/payment-analysis/references/report-template.md +119 -0
- package/skills/risk-compliance/payment-analysis/references/terminology.md +95 -0
- package/skills/risk-compliance/payment-analysis/references/visualization.md +56 -0
- package/skills/risk-compliance/payment-analysis/release-check.mjs +93 -0
- package/skills/risk-compliance/report-writing/LICENSE +3 -0
- package/skills/risk-compliance/report-writing/SKILL.md +220 -0
- package/skills/risk-compliance/report-writing/references/audit-report-template.md +121 -0
- package/skills/risk-compliance/report-writing/references/external-assessment-template.md +167 -0
- package/skills/risk-compliance/report-writing/references/management-report-template.md +145 -0
- package/skills/risk-compliance/report-writing/references/vars-report-template.md +224 -0
- package/skills/risk-compliance/report-writing/release-check.mjs +93 -0
- package/skills/risk-compliance/similar-domain/LICENSE +3 -0
- package/skills/risk-compliance/similar-domain/SKILL.md +203 -0
- package/skills/risk-compliance/similar-domain/references/entities.md +67 -0
- package/skills/risk-compliance/similar-domain/references/fingerprints.md +134 -0
- package/skills/risk-compliance/similar-domain/references/pivots.md +82 -0
- package/skills/risk-compliance/similar-domain/references/report-template.md +93 -0
- package/skills/risk-compliance/similar-domain/references/scoring.md +130 -0
- package/skills/risk-compliance/similar-domain/references/terminology.md +41 -0
- package/skills/risk-compliance/similar-domain/references/workflow.md +85 -0
- package/skills/risk-compliance/similar-domain/release-check.mjs +93 -0
- package/skills/risk-compliance/tld-detection/LICENSE +3 -0
- package/skills/risk-compliance/tld-detection/SKILL.md +245 -0
- package/skills/risk-compliance/tld-detection/agents/openai.yaml +9 -0
- package/skills/risk-compliance/tld-detection/references/chinese-polish.md +55 -0
- package/skills/risk-compliance/tld-detection/references/clean.md +51 -0
- package/skills/risk-compliance/tld-detection/references/clustering.md +235 -0
- package/skills/risk-compliance/tld-detection/references/decision.md +189 -0
- package/skills/risk-compliance/tld-detection/references/fx-conversion.md +232 -0
- package/skills/risk-compliance/tld-detection/references/report-template.md +272 -0
- package/skills/risk-compliance/tld-detection/references/streams.md +141 -0
- package/skills/risk-compliance/tld-detection/references/terminology.md +95 -0
- package/skills/risk-compliance/tld-detection/references/workflow.md +95 -0
- package/skills/risk-compliance/tld-detection/release-check.mjs +93 -0
- package/skills/risk-compliance/tld-detection/scripts/detect_ladders.py +390 -0
- package/skills/risk-compliance/tld-detection/scripts/detect_ladders.test.mjs +14 -0
- package/skills/risk-compliance/tld-detection/scripts/detect_streams.py +650 -0
- package/skills/risk-compliance/tld-detection/scripts/detect_streams.test.mjs +14 -0
- package/skills/risk-compliance/tld-detection/tests/test_detect_ladders.py +134 -0
- package/skills/risk-compliance/tld-detection/tests/test_detect_streams.py +520 -0
|
@@ -0,0 +1,489 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Extract prose blocks from Markdown, check polish proposals keep every protected token, apply them.
|
|
3
|
+
|
|
4
|
+
extract DOC.md --out blocks.json
|
|
5
|
+
check blocks.json proposals.json [--protect TERM ...] [--protect-file FILE] [--terminology FILE]
|
|
6
|
+
[--partial] [--out FILE]
|
|
7
|
+
apply DOC.md blocks.json proposals.json [--protect ...] [--reject ID ...] [--record FILE]
|
|
8
|
+
[--model ID] [--model-note TEXT]
|
|
9
|
+
|
|
10
|
+
blocks.json: {"source": "DOC.md", "blocks": [{"id", "kind", "prefix", "text", "sha", "lines"}]}
|
|
11
|
+
proposals.json: {"blocks": {"<id>": {"sha": "<block sha>", "text": "<polished text, one line>"}},
|
|
12
|
+
"kept": {"<id>": "<reason>"}, "notes": [...]}
|
|
13
|
+
|
|
14
|
+
--terminology reads TERMINOLOGY.md. Each row is one concept: its preferred terms (简体, 繁體) and its
|
|
15
|
+
Avoid terms without a sense note count as mentions of that concept. A rewrite must keep the number
|
|
16
|
+
of mentions per concept, and may swap an Avoid term for a preferred one but never add one.
|
|
17
|
+
Every block id must appear once, in "blocks" or "kept" (--partial waives this for a retry round).
|
|
18
|
+
A caller with its own narrative source may write blocks.json itself (id, text, sha) and use check only.
|
|
19
|
+
Exit codes: 0 ok, 1 a proposal was rejected, a block is unreviewed, or the document changed; 2 bad input.
|
|
20
|
+
"""
|
|
21
|
+
import argparse
|
|
22
|
+
import hashlib
|
|
23
|
+
import json
|
|
24
|
+
import re
|
|
25
|
+
import sys
|
|
26
|
+
from collections import Counter
|
|
27
|
+
from pathlib import Path
|
|
28
|
+
|
|
29
|
+
NUMBER = re.compile(r"\d+(?:[.,:/-]\d+)*%?")
|
|
30
|
+
ASCII_WORD = re.compile(r"[A-Za-z][A-Za-z0-9_.*/:+-]*")
|
|
31
|
+
SYMBOL = re.compile(r"[+\-−±~≈<>≤≥¥¥$€£₩₹|]")
|
|
32
|
+
INLINE_CODE = re.compile(r"`[^`\n]+`")
|
|
33
|
+
IMAGE = re.compile(r"!\[[^\]]*\]\(([^)\s]+)(?:\s[^)]*)?\)")
|
|
34
|
+
LINK_TARGET = re.compile(r"\]\(([^)\s]+)(?:\s[^)]*)?\)")
|
|
35
|
+
HEADING = re.compile(r"^(#{1,6}\s+)(.*)$")
|
|
36
|
+
LIST_ITEM = re.compile(r"^(\s*(?:[-*+]|\d+[.)])\s+(?:\[[ xX]\]\s+)?)(.*)$")
|
|
37
|
+
QUOTE = re.compile(r"^(\s*>\s?)(.*)$")
|
|
38
|
+
FENCE = re.compile(r"^\s*(```|~~~)")
|
|
39
|
+
TABLE_RULE = re.compile(r"^\s*\|?\s*:?-{3,}:?\s*(\|\s*:?-{3,}:?\s*)+\|?\s*$")
|
|
40
|
+
LINK_DEFINITION = re.compile(r"^\s{0,3}\[[^\]]+\]:\s")
|
|
41
|
+
BLOCK_START = re.compile(r"^\s*(#{1,6}\s|[-*+]\s|\d+[.)]\s|>|\||```|~~~|<|[-*_]{3,}\s*$)")
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
def sha(text):
|
|
45
|
+
return hashlib.sha256(text.encode("utf-8")).hexdigest()[:12]
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
def fail(message, code=2):
|
|
49
|
+
print(f"polish_blocks: {message}", file=sys.stderr)
|
|
50
|
+
sys.exit(code)
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
def read_json(path):
|
|
54
|
+
try:
|
|
55
|
+
return json.loads(Path(path).read_text(encoding="utf-8"))
|
|
56
|
+
except (OSError, json.JSONDecodeError) as error:
|
|
57
|
+
fail(f"cannot read {path}: {error}")
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
def read_doc(path):
|
|
61
|
+
"""Return the document's lines without line endings, and its line ending."""
|
|
62
|
+
with open(path, encoding="utf-8", newline="") as handle:
|
|
63
|
+
text = handle.read()
|
|
64
|
+
eol = "\r\n" if "\r\n" in text else "\n"
|
|
65
|
+
return text.replace("\r\n", "\n").split("\n"), eol
|
|
66
|
+
|
|
67
|
+
|
|
68
|
+
def write_doc(path, lines, eol):
|
|
69
|
+
with open(path, "w", encoding="utf-8", newline="") as handle:
|
|
70
|
+
handle.write(eol.join(lines))
|
|
71
|
+
|
|
72
|
+
|
|
73
|
+
def skipped_lines(lines):
|
|
74
|
+
"""Line indexes that are never prose: front matter, fences, indented code, tables, HTML, rules."""
|
|
75
|
+
skip = set()
|
|
76
|
+
start = 0
|
|
77
|
+
if lines and lines[0].strip() == "---":
|
|
78
|
+
for j in range(1, len(lines)):
|
|
79
|
+
if lines[j].strip() in ("---", "..."):
|
|
80
|
+
skip.update(range(0, j + 1))
|
|
81
|
+
start = j + 1
|
|
82
|
+
break
|
|
83
|
+
fence = None
|
|
84
|
+
html = None # "comment" until -->, "block" until a blank line
|
|
85
|
+
for k in range(start, len(lines)):
|
|
86
|
+
line, stripped = lines[k], lines[k].strip()
|
|
87
|
+
if fence:
|
|
88
|
+
skip.add(k)
|
|
89
|
+
match = FENCE.match(line)
|
|
90
|
+
if match and match.group(1) == fence:
|
|
91
|
+
fence = None
|
|
92
|
+
continue
|
|
93
|
+
if html:
|
|
94
|
+
skip.add(k)
|
|
95
|
+
if (html == "comment" and "-->" in line) or (html == "block" and not stripped):
|
|
96
|
+
html = None
|
|
97
|
+
continue
|
|
98
|
+
match = FENCE.match(line)
|
|
99
|
+
if match:
|
|
100
|
+
fence = match.group(1)
|
|
101
|
+
skip.add(k)
|
|
102
|
+
continue
|
|
103
|
+
if stripped.startswith("<!--"):
|
|
104
|
+
skip.add(k)
|
|
105
|
+
html = None if "-->" in stripped else "comment"
|
|
106
|
+
continue
|
|
107
|
+
if stripped.startswith("<"):
|
|
108
|
+
skip.add(k)
|
|
109
|
+
html = "block"
|
|
110
|
+
continue
|
|
111
|
+
indented = line.startswith((" ", "\t"))
|
|
112
|
+
if indented and stripped and (k == start or not lines[k - 1].strip()
|
|
113
|
+
or ((k - 1) in skip and lines[k - 1].startswith((" ", "\t")))):
|
|
114
|
+
skip.add(k) # indented code; an indented list paragraph is skipped too, never edited
|
|
115
|
+
continue
|
|
116
|
+
if stripped.startswith("|") or TABLE_RULE.match(line) or LINK_DEFINITION.match(line) \
|
|
117
|
+
or re.fullmatch(r"[-*_]{3,}", stripped):
|
|
118
|
+
skip.add(k)
|
|
119
|
+
continue
|
|
120
|
+
if "|" in line and k + 1 < len(lines) and TABLE_RULE.match(lines[k + 1]):
|
|
121
|
+
skip.add(k)
|
|
122
|
+
continue
|
|
123
|
+
if "|" in line and (k - 1) in skip and (TABLE_RULE.match(lines[k - 1]) or "|" in lines[k - 1]) \
|
|
124
|
+
and lines[k - 1].strip():
|
|
125
|
+
skip.add(k)
|
|
126
|
+
return skip
|
|
127
|
+
|
|
128
|
+
|
|
129
|
+
def extract(lines):
|
|
130
|
+
skip = skipped_lines(lines)
|
|
131
|
+
blocks = []
|
|
132
|
+
current = None
|
|
133
|
+
|
|
134
|
+
def close():
|
|
135
|
+
nonlocal current
|
|
136
|
+
if current:
|
|
137
|
+
current["text"] = "\n".join(current.pop("parts"))
|
|
138
|
+
current["sha"] = sha(current["text"])
|
|
139
|
+
current["id"] = f"b{len(blocks) + 1:03d}"
|
|
140
|
+
blocks.append(current)
|
|
141
|
+
current = None
|
|
142
|
+
|
|
143
|
+
for index, line in enumerate(lines):
|
|
144
|
+
if index in skip or not line.strip():
|
|
145
|
+
close()
|
|
146
|
+
continue
|
|
147
|
+
heading, item, quote = HEADING.match(line), LIST_ITEM.match(line), QUOTE.match(line)
|
|
148
|
+
if heading or item or quote:
|
|
149
|
+
close()
|
|
150
|
+
kind = "heading" if heading else "list-item" if item else "quote"
|
|
151
|
+
prefix, text = (heading or item or quote).groups()
|
|
152
|
+
current = {"kind": kind, "prefix": prefix, "parts": [text], "lines": [index + 1, index + 1]}
|
|
153
|
+
if heading:
|
|
154
|
+
close()
|
|
155
|
+
continue
|
|
156
|
+
if current and (current["kind"] == "paragraph" or (current["kind"] == "list-item" and line.startswith(" "))):
|
|
157
|
+
current["parts"].append(line.strip() if current["kind"] == "list-item" else line)
|
|
158
|
+
current["lines"][1] = index + 1
|
|
159
|
+
continue
|
|
160
|
+
close()
|
|
161
|
+
current = {"kind": "paragraph", "prefix": "", "parts": [line], "lines": [index + 1, index + 1]}
|
|
162
|
+
close()
|
|
163
|
+
return blocks
|
|
164
|
+
|
|
165
|
+
|
|
166
|
+
def read_text(path):
|
|
167
|
+
try:
|
|
168
|
+
return Path(path).read_text(encoding="utf-8")
|
|
169
|
+
except OSError as error:
|
|
170
|
+
fail(f"cannot read {path}: {error}")
|
|
171
|
+
|
|
172
|
+
|
|
173
|
+
ABSENT = {"", "—", "–", "-", "n/a", "none"}
|
|
174
|
+
LANGUAGE = {"简体": "简体", "簡體": "简体", "zh-hans": "简体", "繁體": "繁體", "繁体": "繁體", "zh-hant": "繁體"}
|
|
175
|
+
|
|
176
|
+
|
|
177
|
+
def split_terms(cell, scoped=True):
|
|
178
|
+
"""Terms in a cell, split on 、 , ; . With scoped=False, drop terms carrying a sense note in brackets."""
|
|
179
|
+
parts, depth, current = [], 0, ""
|
|
180
|
+
for char in cell:
|
|
181
|
+
depth += char in "(("
|
|
182
|
+
depth -= char in "))"
|
|
183
|
+
if depth <= 0 and char in "、,,;;":
|
|
184
|
+
parts.append(current)
|
|
185
|
+
current, depth = "", 0
|
|
186
|
+
else:
|
|
187
|
+
current += char
|
|
188
|
+
parts.append(current)
|
|
189
|
+
terms = []
|
|
190
|
+
for part in parts:
|
|
191
|
+
part = part.strip()
|
|
192
|
+
has_note = re.search(r"[((][^))]*[))]", part)
|
|
193
|
+
part = re.sub(r"[((][^))]*[))]", "", part).strip()
|
|
194
|
+
if part.lower() in ABSENT or (has_note and not scoped):
|
|
195
|
+
continue
|
|
196
|
+
terms.append(part)
|
|
197
|
+
return terms
|
|
198
|
+
|
|
199
|
+
|
|
200
|
+
def header_name(cell):
|
|
201
|
+
cell = cell.strip()
|
|
202
|
+
for prefix, name in LANGUAGE.items():
|
|
203
|
+
if cell.lower().startswith(prefix):
|
|
204
|
+
return name
|
|
205
|
+
return "Avoid" if cell.lower() in ("avoid", "避免") else cell
|
|
206
|
+
|
|
207
|
+
|
|
208
|
+
def table_cells(line):
|
|
209
|
+
inner = line.strip()
|
|
210
|
+
inner = inner[1:] if inner.startswith("|") else inner
|
|
211
|
+
inner = inner[:-1] if inner.endswith("|") and not inner.endswith("\\|") else inner
|
|
212
|
+
return [cell.strip().replace("\\|", "|") for cell in re.split(r"(?<!\\)\|", inner)]
|
|
213
|
+
|
|
214
|
+
|
|
215
|
+
def terminology(path):
|
|
216
|
+
"""Concept rows from every table with a 简体 or 繁體 column and an Avoid column.
|
|
217
|
+
|
|
218
|
+
Returns (concepts, avoided): concepts maps each counted term to its row's concept id; avoided
|
|
219
|
+
holds the Avoid terms without a sense note. A term preferred in one row is never an Avoid term.
|
|
220
|
+
"""
|
|
221
|
+
rows = []
|
|
222
|
+
header = None
|
|
223
|
+
for line in read_text(path).splitlines():
|
|
224
|
+
if not line.strip().startswith("|"):
|
|
225
|
+
header = None
|
|
226
|
+
continue
|
|
227
|
+
cells = table_cells(line)
|
|
228
|
+
if header is None:
|
|
229
|
+
header = [header_name(cell) for cell in cells]
|
|
230
|
+
continue
|
|
231
|
+
if TABLE_RULE.match(line):
|
|
232
|
+
continue
|
|
233
|
+
row = dict(zip(header, cells))
|
|
234
|
+
if "Avoid" not in row or not ({"简体", "繁體"} & set(row)):
|
|
235
|
+
continue
|
|
236
|
+
preferred = [t for column in ("简体", "繁體") for t in split_terms(row.get(column, ""))]
|
|
237
|
+
if preferred:
|
|
238
|
+
rows.append((preferred, split_terms(row["Avoid"], scoped=False)))
|
|
239
|
+
concepts, avoided = {}, set()
|
|
240
|
+
for index, (preferred, _) in enumerate(rows):
|
|
241
|
+
for term in preferred:
|
|
242
|
+
concepts.setdefault(term, f"c{index + 1}")
|
|
243
|
+
for index, (_, avoid) in enumerate(rows):
|
|
244
|
+
for term in avoid:
|
|
245
|
+
if term not in concepts:
|
|
246
|
+
concepts[term] = f"c{index + 1}"
|
|
247
|
+
avoided.add(term)
|
|
248
|
+
return concepts, avoided
|
|
249
|
+
|
|
250
|
+
|
|
251
|
+
def protected_terms(args):
|
|
252
|
+
"""Caller terms (exact counts), terminology concepts (mentions per concept), and avoided terms."""
|
|
253
|
+
terms = list(args.protect or [])
|
|
254
|
+
if args.protect_file:
|
|
255
|
+
terms += [t.strip() for t in read_text(args.protect_file).splitlines() if t.strip() and not t.startswith("#")]
|
|
256
|
+
concepts, avoided = ({}, set())
|
|
257
|
+
if args.terminology:
|
|
258
|
+
concepts, avoided = terminology(args.terminology)
|
|
259
|
+
return sorted(set(terms), key=len, reverse=True), concepts, sorted(avoided, key=len, reverse=True)
|
|
260
|
+
|
|
261
|
+
|
|
262
|
+
def tokens(text, terms, concepts=None):
|
|
263
|
+
found = Counter()
|
|
264
|
+
for code in INLINE_CODE.findall(text):
|
|
265
|
+
found[("code", code)] += 1
|
|
266
|
+
rest = INLINE_CODE.sub(" ", text)
|
|
267
|
+
for target in IMAGE.findall(rest):
|
|
268
|
+
found[("image", target)] += 1
|
|
269
|
+
rest = IMAGE.sub(" ", rest)
|
|
270
|
+
for target in LINK_TARGET.findall(rest):
|
|
271
|
+
found[("link", target)] += 1
|
|
272
|
+
rest = LINK_TARGET.sub("] ", rest)
|
|
273
|
+
concepts = concepts or {}
|
|
274
|
+
for term in sorted(set(terms) | set(concepts), key=len, reverse=True):
|
|
275
|
+
count = rest.count(term)
|
|
276
|
+
if count:
|
|
277
|
+
found[("concept", concepts[term]) if term in concepts else ("term", term)] += count
|
|
278
|
+
rest = rest.replace(term, " ")
|
|
279
|
+
for number in NUMBER.findall(rest):
|
|
280
|
+
found[("number", number)] += 1
|
|
281
|
+
rest = NUMBER.sub(" ", rest)
|
|
282
|
+
for word in ASCII_WORD.findall(rest):
|
|
283
|
+
found[("word", word)] += 1
|
|
284
|
+
for symbol in SYMBOL.findall(ASCII_WORD.sub(" ", rest)):
|
|
285
|
+
found[("symbol", symbol)] += 1
|
|
286
|
+
return found
|
|
287
|
+
|
|
288
|
+
|
|
289
|
+
def describe(counter):
|
|
290
|
+
return ", ".join(f"{kind} {value!r} x{count}" for (kind, value), count in sorted(counter.items()))
|
|
291
|
+
|
|
292
|
+
|
|
293
|
+
def check(blocks, proposals, terms, concepts=None, avoided=()):
|
|
294
|
+
by_id = {block["id"]: block for block in blocks}
|
|
295
|
+
accepted, rejected = {}, {}
|
|
296
|
+
for block_id, proposal in proposals["blocks"].items():
|
|
297
|
+
block = by_id.get(block_id)
|
|
298
|
+
if block is None:
|
|
299
|
+
rejected[block_id] = "unknown block id"
|
|
300
|
+
continue
|
|
301
|
+
if not isinstance(proposal, dict) or not isinstance(proposal.get("text"), str):
|
|
302
|
+
rejected[block_id] = "proposal needs a text string"
|
|
303
|
+
continue
|
|
304
|
+
if proposal.get("sha") != block["sha"]:
|
|
305
|
+
rejected[block_id] = f"sha {proposal.get('sha')!r} does not match block sha {block['sha']!r}"
|
|
306
|
+
continue
|
|
307
|
+
new = proposal["text"].strip()
|
|
308
|
+
if not new:
|
|
309
|
+
rejected[block_id] = "empty text: polish never deletes a block (cuts belong to editorial-review)"
|
|
310
|
+
continue
|
|
311
|
+
if "\n" in new or "\r" in new:
|
|
312
|
+
rejected[block_id] = "text must be one line: no line breaks"
|
|
313
|
+
continue
|
|
314
|
+
if BLOCK_START.match(new) and not BLOCK_START.match(block["text"]):
|
|
315
|
+
rejected[block_id] = "text starts with Markdown block syntax; return the text without its prefix"
|
|
316
|
+
continue
|
|
317
|
+
before, after = tokens(block["text"], terms, concepts), tokens(new, terms, concepts)
|
|
318
|
+
if before != after:
|
|
319
|
+
missing, added = before - after, after - before
|
|
320
|
+
parts = []
|
|
321
|
+
if missing:
|
|
322
|
+
parts.append(f"missing {describe(missing)}")
|
|
323
|
+
if added:
|
|
324
|
+
parts.append(f"added {describe(added)}")
|
|
325
|
+
rejected[block_id] = "protected tokens changed: " + "; ".join(parts) + names(missing + added, concepts)
|
|
326
|
+
continue
|
|
327
|
+
added = [term for term in avoided if new.count(term) > block["text"].count(term)]
|
|
328
|
+
if added:
|
|
329
|
+
rejected[block_id] = "adds a term TERMINOLOGY.md avoids: " + ", ".join(added)
|
|
330
|
+
continue
|
|
331
|
+
if new != block["text"]:
|
|
332
|
+
accepted[block_id] = new
|
|
333
|
+
return accepted, rejected
|
|
334
|
+
|
|
335
|
+
|
|
336
|
+
def names(counter, concepts):
|
|
337
|
+
ids = {value for kind, value in counter if kind == "concept"}
|
|
338
|
+
if not ids:
|
|
339
|
+
return ""
|
|
340
|
+
by_id = {}
|
|
341
|
+
for term, concept in (concepts or {}).items():
|
|
342
|
+
by_id.setdefault(concept, []).append(term)
|
|
343
|
+
return " (" + "; ".join(f"{cid} = {'/'.join(by_id.get(cid, []))}" for cid in sorted(ids)) + ")"
|
|
344
|
+
|
|
345
|
+
|
|
346
|
+
def avoided_present(blocks, avoided):
|
|
347
|
+
return {block["id"]: found for block in blocks
|
|
348
|
+
if (found := [term for term in avoided if term in block["text"]])}
|
|
349
|
+
|
|
350
|
+
|
|
351
|
+
def load_check_inputs(args):
|
|
352
|
+
blocks_doc = read_json(args.blocks)
|
|
353
|
+
blocks = blocks_doc.get("blocks") if isinstance(blocks_doc, dict) else None
|
|
354
|
+
if not isinstance(blocks, list) or not all(isinstance(b, dict) and {"id", "text", "sha"} <= set(b) for b in blocks):
|
|
355
|
+
fail(f"{args.blocks} needs an object with a blocks list of id, text and sha")
|
|
356
|
+
proposals = read_json(args.proposals)
|
|
357
|
+
if not isinstance(proposals, dict) or not isinstance(proposals.get("blocks"), dict):
|
|
358
|
+
fail(f"{args.proposals} needs an object with a blocks object keyed by block id")
|
|
359
|
+
kept = proposals.setdefault("kept", {})
|
|
360
|
+
if not isinstance(kept, dict) or not isinstance(proposals.setdefault("notes", []), list):
|
|
361
|
+
fail(f"{args.proposals}: kept must be an object and notes a list")
|
|
362
|
+
return blocks, proposals
|
|
363
|
+
|
|
364
|
+
|
|
365
|
+
def coverage(blocks, proposals):
|
|
366
|
+
rewritten, kept = set(proposals["blocks"]), set(proposals["kept"])
|
|
367
|
+
known = {block["id"] for block in blocks}
|
|
368
|
+
unreviewed = [block["id"] for block in blocks if block["id"] not in rewritten | kept]
|
|
369
|
+
problems = sorted(rewritten & kept) + sorted(f"{key} (unknown id in kept)" for key in kept - known)
|
|
370
|
+
return unreviewed, problems
|
|
371
|
+
|
|
372
|
+
|
|
373
|
+
def report(accepted, rejected, unreviewed, both, out=None, avoided=None):
|
|
374
|
+
result = {"accepted": sorted(accepted), "rejected": rejected, "unreviewed": unreviewed, "partitionProblems": both,
|
|
375
|
+
"avoidedTermsInSource": avoided or {}}
|
|
376
|
+
text = json.dumps(result, ensure_ascii=False, indent=2) + "\n"
|
|
377
|
+
if out:
|
|
378
|
+
Path(out).write_text(text, encoding="utf-8")
|
|
379
|
+
print(text, end="")
|
|
380
|
+
print(f"polish_blocks: {len(accepted)} accepted, {len(rejected)} rejected, {len(unreviewed)} unreviewed, "
|
|
381
|
+
f"{len(both)} partition problems", file=sys.stderr)
|
|
382
|
+
|
|
383
|
+
|
|
384
|
+
def cmd_extract(args):
|
|
385
|
+
lines, _ = read_doc(args.doc)
|
|
386
|
+
blocks = extract(lines)
|
|
387
|
+
Path(args.out).write_text(json.dumps({"source": str(args.doc), "blocks": blocks}, ensure_ascii=False, indent=2) + "\n",
|
|
388
|
+
encoding="utf-8")
|
|
389
|
+
print(f"polish_blocks: {len(blocks)} prose blocks from {args.doc}", file=sys.stderr)
|
|
390
|
+
|
|
391
|
+
|
|
392
|
+
def cmd_check(args):
|
|
393
|
+
blocks, proposals = load_check_inputs(args)
|
|
394
|
+
terms, concepts, avoided = protected_terms(args)
|
|
395
|
+
accepted, rejected = check(blocks, proposals, terms, concepts, avoided)
|
|
396
|
+
unreviewed, both = coverage(blocks, proposals)
|
|
397
|
+
if args.partial:
|
|
398
|
+
unreviewed = []
|
|
399
|
+
report(accepted, rejected, unreviewed, both, args.out, avoided_present(blocks, avoided))
|
|
400
|
+
sys.exit(1 if rejected or unreviewed or both else 0)
|
|
401
|
+
|
|
402
|
+
|
|
403
|
+
def cmd_apply(args):
|
|
404
|
+
blocks, proposals = load_check_inputs(args)
|
|
405
|
+
for block_id in args.reject or []:
|
|
406
|
+
if block_id in proposals["blocks"]:
|
|
407
|
+
proposals["kept"][block_id] = "rejected by caller"
|
|
408
|
+
proposals["blocks"].pop(block_id)
|
|
409
|
+
terms, concepts, avoided = protected_terms(args)
|
|
410
|
+
accepted, rejected = check(blocks, proposals, terms, concepts, avoided)
|
|
411
|
+
unreviewed, both = coverage(blocks, proposals)
|
|
412
|
+
if rejected or unreviewed or both:
|
|
413
|
+
report(accepted, rejected, unreviewed, both)
|
|
414
|
+
fail("every block needs one accepted proposal or a kept reason; fix, re-ask or --reject first", 1)
|
|
415
|
+
lines, eol = read_doc(args.doc)
|
|
416
|
+
for block in blocks:
|
|
417
|
+
start, end = block.get("lines", [0, 0])
|
|
418
|
+
if not start:
|
|
419
|
+
fail(f"{block['id']} has no line range; apply works only on blocks from extract")
|
|
420
|
+
if sha(extract_text(lines, block)) != block["sha"]:
|
|
421
|
+
fail(f"{args.doc} changed since extract at {block['id']} (lines {start}-{end}); extract again", 1)
|
|
422
|
+
original = list(lines)
|
|
423
|
+
for block in sorted(blocks, key=lambda b: b["lines"][0], reverse=True):
|
|
424
|
+
if block["id"] in accepted:
|
|
425
|
+
start, end = block["lines"]
|
|
426
|
+
lines[start - 1:end] = [block.get("prefix", "") + accepted[block["id"]]]
|
|
427
|
+
if not non_prose_equal(original, lines):
|
|
428
|
+
fail("non-prose lines changed during apply", 1)
|
|
429
|
+
write_doc(args.doc, lines, eol)
|
|
430
|
+
record = {
|
|
431
|
+
"document": str(args.doc),
|
|
432
|
+
"model": args.model,
|
|
433
|
+
"modelNote": args.model_note,
|
|
434
|
+
"blocks": len(blocks),
|
|
435
|
+
"applied": sorted(accepted),
|
|
436
|
+
"rejectedByCaller": sorted(args.reject or []),
|
|
437
|
+
"notes": proposals["notes"],
|
|
438
|
+
}
|
|
439
|
+
if args.record:
|
|
440
|
+
Path(args.record).write_text(json.dumps(record, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
|
|
441
|
+
print(f"polish_blocks: applied {len(accepted)} of {len(blocks)} blocks to {args.doc}", file=sys.stderr)
|
|
442
|
+
|
|
443
|
+
|
|
444
|
+
def extract_text(lines, block):
|
|
445
|
+
start, end = block["lines"]
|
|
446
|
+
span = lines[start - 1:end]
|
|
447
|
+
if block.get("kind") == "paragraph":
|
|
448
|
+
return "\n".join(span)
|
|
449
|
+
first = span[0][len(block.get("prefix", "")):] if span else ""
|
|
450
|
+
rest = [line.strip() for line in span[1:]]
|
|
451
|
+
return "\n".join([first, *rest]) if rest else first
|
|
452
|
+
|
|
453
|
+
|
|
454
|
+
def non_prose_equal(before, after):
|
|
455
|
+
keep = lambda lines: [lines[i] for i in sorted(skipped_lines(lines))]
|
|
456
|
+
return keep(before) == keep(after)
|
|
457
|
+
|
|
458
|
+
|
|
459
|
+
def main():
|
|
460
|
+
parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
|
|
461
|
+
sub = parser.add_subparsers(dest="command", required=True)
|
|
462
|
+
p = sub.add_parser("extract")
|
|
463
|
+
p.add_argument("doc")
|
|
464
|
+
p.add_argument("--out", required=True)
|
|
465
|
+
p.set_defaults(run=cmd_extract)
|
|
466
|
+
for name, run in (("check", cmd_check), ("apply", cmd_apply)):
|
|
467
|
+
p = sub.add_parser(name)
|
|
468
|
+
if name == "apply":
|
|
469
|
+
p.add_argument("doc")
|
|
470
|
+
p.add_argument("blocks")
|
|
471
|
+
p.add_argument("proposals")
|
|
472
|
+
p.add_argument("--protect", action="append", help="a term whose count must not change (repeatable)")
|
|
473
|
+
p.add_argument("--protect-file", help="one protected term per line")
|
|
474
|
+
p.add_argument("--terminology", help="TERMINOLOGY.md: protect preferred terms, refuse added Avoid terms")
|
|
475
|
+
if name == "check":
|
|
476
|
+
p.add_argument("--partial", action="store_true", help="a retry round: do not require every block")
|
|
477
|
+
p.add_argument("--out")
|
|
478
|
+
else:
|
|
479
|
+
p.add_argument("--reject", action="append", help="a block id to keep unchanged (repeatable)")
|
|
480
|
+
p.add_argument("--record")
|
|
481
|
+
p.add_argument("--model", help="the provider and the model id the call result reported")
|
|
482
|
+
p.add_argument("--model-note", help="fallback reason, or why no Chinese model ran")
|
|
483
|
+
p.set_defaults(run=run)
|
|
484
|
+
args = parser.parse_args()
|
|
485
|
+
args.run(args)
|
|
486
|
+
|
|
487
|
+
|
|
488
|
+
if __name__ == "__main__":
|
|
489
|
+
main()
|