@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,473 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// Collect a run's small, non-blocking problems in one file and post them as grouped issues
|
|
3
|
+
// after the main work is done.
|
|
4
|
+
//
|
|
5
|
+
// dropbox.mjs check --git <workspace> --base <ref> --file <path> [--line <n>]
|
|
6
|
+
// dropbox.mjs add --dropbox <run>/dropbox.json --unit <id> --source review|implementer
|
|
7
|
+
// --kind <kind> --file <path> [--line <n>] --summary <text> [--pr <url>]
|
|
8
|
+
// [--finding <id>] [--severity P2] [--blocks <#n|owner/name#n|url>]...
|
|
9
|
+
// [--decision] [--git <workspace> --base <ref>]
|
|
10
|
+
// dropbox.mjs from-review --dropbox <run>/dropbox.json --review <run>/reviews/<unit>-r<N>.json
|
|
11
|
+
// [--pr <url>] [--git <review clone> --base <ref>]
|
|
12
|
+
// dropbox.mjs plan --dropbox <run>/dropbox.json [--git <dir> --ref <origin/target>]
|
|
13
|
+
// dropbox.mjs post --dropbox <run>/dropbox.json --repo <owner/name> [--git <dir> --ref <origin/target>]
|
|
14
|
+
// [--only G1,G2 | --ids D3,D4] [--label ready-for-agent]
|
|
15
|
+
// dropbox.mjs mark --dropbox <run>/dropbox.json --id <D3> (--drop <reason> | --decision)
|
|
16
|
+
// dropbox.mjs pending --runs <repo>/.resolve-issues/rush
|
|
17
|
+
//
|
|
18
|
+
// check: is the location inside the unit's own change (lines the diff from the merge-base with
|
|
19
|
+
// --base adds or changes, working tree included; a file the diff adds counts whole; without
|
|
20
|
+
// --line, any change to the file counts)? Prints { inDiff, do }: `inDiff` true means fix it in this unit.
|
|
21
|
+
// add: append one entry; the coordinator is the only writer. An implementer entry inside the
|
|
22
|
+
// unit's diff is refused (`refused` in the output) because the unit caused it. A review entry inside the diff
|
|
23
|
+
// is kept and marked `inDiff`: the review loop never fixes P2. The same location, kind and
|
|
24
|
+
// summary (or, for a review, the same unit and finding id) is one entry. `--decision` records
|
|
25
|
+
// a question for the human: never posted, listed in the handback. Prints { id, duplicate, inDiff }.
|
|
26
|
+
// from-review: add every P2 in a review result that has no followUpUrl or dropboxId, and
|
|
27
|
+
// write the entry id back to the finding as `dropboxId`, so review-verdict.mjs sees it disposed.
|
|
28
|
+
// P3 is skipped: never added, never filed.
|
|
29
|
+
// The unit's diff is taken at the review's `head`, so the clone's checkout does not matter.
|
|
30
|
+
// plan: print the issues `post` would file. Entries group by parent PR, and entries on the
|
|
31
|
+
// same file with the same kind join one group across PRs. With --git and --ref, an entry whose
|
|
32
|
+
// file no longer exists at --ref is dropped.
|
|
33
|
+
// post: file each pending group as one issue labeled --label (default ready-for-agent). An entry
|
|
34
|
+
// already in an open issue (matched by its fingerprint marker) is not filed again. Writes each
|
|
35
|
+
// entry's `postedUrl` back. --only posts the named groups; --ids posts just those entries,
|
|
36
|
+
// grouped among themselves (file an urgent entry now). Decisions are never posted.
|
|
37
|
+
// mark: drop an entry (with the reason) or turn it into a decision, after routing it.
|
|
38
|
+
// pending: list runs whose dropbox still has unposted entries (decisions excluded: they are
|
|
39
|
+
// reported in their own run's handback). Prints { runs }: empty when none.
|
|
40
|
+
//
|
|
41
|
+
// Exit 0 whenever it ran and answered (the outcome is in the output); exit 2 for a bad command,
|
|
42
|
+
// an unreadable file, or a git or gh failure.
|
|
43
|
+
|
|
44
|
+
import { execFileSync } from 'node:child_process'
|
|
45
|
+
import { createHash } from 'node:crypto'
|
|
46
|
+
import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs'
|
|
47
|
+
import { join } from 'node:path'
|
|
48
|
+
|
|
49
|
+
import { isMainModule } from '../../engineering-runtime/scripts/main-module.mjs'
|
|
50
|
+
|
|
51
|
+
export const DROPBOX_VERSION = 1
|
|
52
|
+
export const DEFAULT_LABEL = 'ready-for-agent'
|
|
53
|
+
export const KINDS = Object.freeze(['bug', 'test', 'docs', 'typing', 'refactor', 'ci', 'perf', 'other'])
|
|
54
|
+
export const SOURCES = Object.freeze(['review', 'implementer'])
|
|
55
|
+
const SUMMARY_MAX = 280
|
|
56
|
+
const MARKER = 'dropbox-fp'
|
|
57
|
+
|
|
58
|
+
export class DropboxError extends Error {}
|
|
59
|
+
|
|
60
|
+
const isText = (value) => typeof value === 'string' && value.trim() !== ''
|
|
61
|
+
|
|
62
|
+
// --- the unit's diff ---------------------------------------------------------------------
|
|
63
|
+
|
|
64
|
+
function realGit(dir, args) {
|
|
65
|
+
try {
|
|
66
|
+
return execFileSync('git', ['-C', dir, ...args], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] })
|
|
67
|
+
} catch (error) {
|
|
68
|
+
throw new DropboxError(`git ${args[0]} failed in ${dir}: ${String(error.stderr || error.message).trim()}`)
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
// New-side line ranges from `git diff -U0` hunks; a pure deletion adds no lines.
|
|
73
|
+
export function changedRanges(diffText) {
|
|
74
|
+
const ranges = []
|
|
75
|
+
for (const m of diffText.matchAll(/^@@ -\d+(?:,\d+)? \+(\d+)(?:,(\d+))? @@/gm)) {
|
|
76
|
+
const start = Number(m[1])
|
|
77
|
+
const count = m[2] === undefined ? 1 : Number(m[2])
|
|
78
|
+
if (count > 0) ranges.push([start, start + count - 1])
|
|
79
|
+
}
|
|
80
|
+
return ranges
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
// Without `head`, the working tree is compared, so an implementer's uncommitted work counts.
|
|
84
|
+
// A file the unit added or deleted counts whole. A file that exists neither at the merge-base nor
|
|
85
|
+
// in the unit is a wrong path, never "outside the diff".
|
|
86
|
+
export function inUnitDiff({ dir, base, head, file, line }, git = realGit) {
|
|
87
|
+
if (line !== undefined && !(Number.isSafeInteger(line) && line >= 1)) throw new DropboxError('--line must be a positive integer')
|
|
88
|
+
let mergeBase
|
|
89
|
+
try {
|
|
90
|
+
mergeBase = git(dir, ['merge-base', base, head ?? 'HEAD']).trim()
|
|
91
|
+
} catch (error) {
|
|
92
|
+
throw new DropboxError(`${error.message}\nFetch the PR head and the base into ${dir} first.`)
|
|
93
|
+
}
|
|
94
|
+
const range = head ? [mergeBase, head] : [mergeBase]
|
|
95
|
+
const status = git(dir, ['diff', '--name-status', ...range, '--', file]).trim()
|
|
96
|
+
if (!status) {
|
|
97
|
+
const exists = (rev) => { try { git(dir, ['cat-file', '-e', `${rev}:${file}`]); return true } catch { return false } }
|
|
98
|
+
if (!exists(mergeBase) && !exists(head ?? 'HEAD')) throw new DropboxError(`${file} exists neither at the merge-base nor in the unit; give a repository-relative path, without :line`)
|
|
99
|
+
return false
|
|
100
|
+
}
|
|
101
|
+
if (/^[AD]\s/.test(status) || line === undefined) return true
|
|
102
|
+
return changedRanges(git(dir, ['diff', '-U0', '--no-color', ...range, '--', file]))
|
|
103
|
+
.some(([from, to]) => line >= from && line <= to)
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
// --- the dropbox file ----------------------------------------------------------------------
|
|
107
|
+
|
|
108
|
+
export function emptyDropbox() {
|
|
109
|
+
return { version: DROPBOX_VERSION, entries: [] }
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
export function readDropbox(path) {
|
|
113
|
+
if (!existsSync(path)) return emptyDropbox()
|
|
114
|
+
let box
|
|
115
|
+
try {
|
|
116
|
+
box = JSON.parse(readFileSync(path, 'utf8'))
|
|
117
|
+
} catch (error) {
|
|
118
|
+
throw new DropboxError(`cannot read ${path}: ${error.message}`)
|
|
119
|
+
}
|
|
120
|
+
if (box?.version !== DROPBOX_VERSION || !Array.isArray(box.entries)) throw new DropboxError(`${path} is not a version ${DROPBOX_VERSION} dropbox`)
|
|
121
|
+
return box
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
const writeJson = (path, value) => writeFileSync(path, `${JSON.stringify(value, null, 2)}\n`)
|
|
125
|
+
|
|
126
|
+
// Local absolute paths never reach a public issue.
|
|
127
|
+
export function sanitize(text) {
|
|
128
|
+
const clean = String(text).replace(/(?<![\w.~-])(?:\/Users|\/home|\/private\/tmp|\/tmp|[A-Z]:\\Users)[/\\][^\s`'")\]]+/g, '<local path>').replace(/\s+/g, ' ').trim()
|
|
129
|
+
return clean.length > SUMMARY_MAX ? `${clean.slice(0, SUMMARY_MAX - 1)}…` : clean
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
// Lines shift between runs, so the line is not part of what makes two entries the same problem.
|
|
133
|
+
export function fingerprint({ file, kind, summary }) {
|
|
134
|
+
const key = [file ?? '', kind, sanitize(summary).toLowerCase()].join('\u0000')
|
|
135
|
+
return createHash('sha256').update(key).digest('hex').slice(0, 12)
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
function validateEntry(input) {
|
|
139
|
+
const problems = []
|
|
140
|
+
if (!isText(input.unit)) problems.push('--unit is required')
|
|
141
|
+
if (!SOURCES.includes(input.source)) problems.push(`--source must be one of ${SOURCES.join(', ')}`)
|
|
142
|
+
if (!input.decision && !KINDS.includes(input.kind)) problems.push(`--kind must be one of ${KINDS.join(', ')}`)
|
|
143
|
+
if (!input.decision && !isText(input.file)) problems.push('--file is required: an entry an agent can fix names where it is')
|
|
144
|
+
if (isText(input.file) && (/^(?:\/|[A-Za-z]:[\\/]|~)/.test(input.file) || /:\d+$/.test(input.file))) problems.push('--file must be repository-relative, with the line in --line')
|
|
145
|
+
if (input.line !== undefined && !(Number.isSafeInteger(input.line) && input.line >= 1)) problems.push('--line must be a positive integer')
|
|
146
|
+
if (!isText(input.summary)) problems.push('--summary is required')
|
|
147
|
+
if (input.severity !== undefined && input.severity !== 'P2') problems.push('--severity must be P2; a P0/P1 never goes in the dropbox and a P3 is skipped')
|
|
148
|
+
if (problems.length) throw new DropboxError(problems.join('\n'))
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
// Adds one entry, or returns the existing one it duplicates. `inDiff` is computed by the
|
|
152
|
+
// caller (null when no workspace was given).
|
|
153
|
+
export function addEntry(box, input, inDiff = null) {
|
|
154
|
+
validateEntry(input)
|
|
155
|
+
if (input.source === 'implementer' && inDiff === true) {
|
|
156
|
+
return { refused: true, reason: 'inside the unit\'s own change: fix it in this unit' }
|
|
157
|
+
}
|
|
158
|
+
const entry = {
|
|
159
|
+
route: input.decision ? 'decision' : 'dropbox',
|
|
160
|
+
unit: input.unit,
|
|
161
|
+
source: input.source,
|
|
162
|
+
kind: input.decision ? 'decision' : input.kind,
|
|
163
|
+
file: input.file ?? null,
|
|
164
|
+
line: input.line ?? null,
|
|
165
|
+
summary: sanitize(input.summary),
|
|
166
|
+
pr: input.pr ?? null,
|
|
167
|
+
finding: input.finding ?? null,
|
|
168
|
+
severity: input.severity ?? null,
|
|
169
|
+
blocks: (input.blocks ?? []).map((ref) => (/^\d+$/.test(String(ref)) ? `#${ref}` : String(ref))),
|
|
170
|
+
inDiff,
|
|
171
|
+
}
|
|
172
|
+
entry.fingerprint = fingerprint(entry)
|
|
173
|
+
const same = box.entries.find((e) => e.fingerprint === entry.fingerprint
|
|
174
|
+
|| (entry.finding && e.source === 'review' && e.unit === entry.unit && e.finding === entry.finding))
|
|
175
|
+
if (same) {
|
|
176
|
+
for (const ref of entry.blocks) if (!same.blocks.includes(ref)) same.blocks.push(ref)
|
|
177
|
+
return { id: same.id, duplicate: true, inDiff: same.inDiff }
|
|
178
|
+
}
|
|
179
|
+
entry.id = `D${box.entries.length + 1}`
|
|
180
|
+
entry.status = 'pending'
|
|
181
|
+
box.entries.push({ id: entry.id, ...entry })
|
|
182
|
+
return { id: entry.id, duplicate: false, inDiff }
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
// --- grouping and posting -----------------------------------------------------------------
|
|
186
|
+
|
|
187
|
+
// Groups by parent PR; the same file and kind join across PRs. A group's id follows its first
|
|
188
|
+
// entry's (D3 leads G3), so `plan` and `post` name the same group even after some are filed.
|
|
189
|
+
export function groupEntries(entries) {
|
|
190
|
+
const parent = entries.map((_, i) => i)
|
|
191
|
+
const find = (i) => (parent[i] === i ? i : (parent[i] = find(parent[i])))
|
|
192
|
+
const link = (keyOf) => {
|
|
193
|
+
const first = new Map()
|
|
194
|
+
entries.forEach((e, i) => {
|
|
195
|
+
const key = keyOf(e)
|
|
196
|
+
if (key === null) return
|
|
197
|
+
if (first.has(key)) parent[find(i)] = find(first.get(key))
|
|
198
|
+
else first.set(key, i)
|
|
199
|
+
})
|
|
200
|
+
}
|
|
201
|
+
link((e) => e.pr || null)
|
|
202
|
+
link((e) => (e.file ? `${e.file}\u0000${e.kind}` : null))
|
|
203
|
+
const groups = new Map()
|
|
204
|
+
entries.forEach((e, i) => {
|
|
205
|
+
const root = find(i)
|
|
206
|
+
if (!groups.has(root)) groups.set(root, [])
|
|
207
|
+
groups.get(root).push(e)
|
|
208
|
+
})
|
|
209
|
+
return [...groups.values()].map((members) => ({ id: members[0].id.replace(/^D/, 'G'), entries: members }))
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
const prRef = (url) => {
|
|
213
|
+
const m = String(url ?? '').match(/\/pull\/(\d+)/)
|
|
214
|
+
return m ? `#${m[1]}` : null
|
|
215
|
+
}
|
|
216
|
+
const issueRef = (ref) => {
|
|
217
|
+
const url = String(ref).match(/^https:\/\/github\.com\/([^/]+\/[^/]+)\/issues\/(\d+)/)
|
|
218
|
+
return url ? `${url[1]}#${url[2]}` : String(ref)
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
export function issueFor(group) {
|
|
222
|
+
const { entries } = group
|
|
223
|
+
const prs = [...new Set(entries.map((e) => prRef(e.pr)).filter(Boolean))]
|
|
224
|
+
const kinds = [...new Set(entries.map((e) => e.kind))]
|
|
225
|
+
const files = [...new Set(entries.map((e) => e.file))]
|
|
226
|
+
let title
|
|
227
|
+
if (entries.length === 1) title = entries[0].summary
|
|
228
|
+
else if (files.length === 1) title = `${entries.length} ${kinds.join('/')} follow-ups in ${files[0]}`
|
|
229
|
+
else if (prs.length === 1) title = `${entries.length} follow-ups from ${prs[0]}`
|
|
230
|
+
else title = `${entries.length} ${kinds.join('/')} follow-ups`
|
|
231
|
+
title = title.length > 120 ? `${title.slice(0, 119)}…` : title
|
|
232
|
+
|
|
233
|
+
const lines = ['Non-blocking problems found while delivering other work. Each is outside the change that found it, or a review note the review loop does not fix.', '']
|
|
234
|
+
for (const e of entries) {
|
|
235
|
+
const where = e.line ? `${e.file}:${e.line}` : e.file
|
|
236
|
+
const from = [prRef(e.pr) && `from ${prRef(e.pr)}`, e.finding && `finding ${e.finding}`, e.inDiff && 'added by that PR'].filter(Boolean).join(', ')
|
|
237
|
+
lines.push(`- [ ] \`${where}\` (${e.kind}) ${e.summary}${from ? ` (${from})` : ''}`)
|
|
238
|
+
}
|
|
239
|
+
const blocks = [...new Set(entries.flatMap((e) => e.blocks.map(issueRef)))]
|
|
240
|
+
if (blocks.length) lines.push('', ...blocks.map((ref) => `Blocks ${ref}`))
|
|
241
|
+
lines.push('', `<!-- ${entries.map((e) => `${MARKER}:${e.fingerprint}`).join(' ')} -->`)
|
|
242
|
+
return { title, body: lines.join('\n') }
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
// Entries still to post, after dropping those whose file is gone at `ref`.
|
|
246
|
+
export function planPost(box, { dir, ref } = {}, git = realGit) {
|
|
247
|
+
if (Boolean(dir) !== Boolean(ref)) throw new DropboxError('give --git and --ref together, or neither')
|
|
248
|
+
const dropped = []
|
|
249
|
+
for (const e of box.entries) {
|
|
250
|
+
if (e.status !== 'pending' || e.route !== 'dropbox' || !dir || !ref) continue
|
|
251
|
+
try {
|
|
252
|
+
git(dir, ['cat-file', '-e', `${ref}:${e.file}`])
|
|
253
|
+
} catch {
|
|
254
|
+
e.status = 'dropped'
|
|
255
|
+
e.reason = `${e.file} no longer exists at ${ref}`
|
|
256
|
+
dropped.push(e.id)
|
|
257
|
+
}
|
|
258
|
+
}
|
|
259
|
+
const pending = box.entries.filter((e) => e.status === 'pending' && e.route === 'dropbox')
|
|
260
|
+
const groups = groupEntries(pending).map((g) => ({ ...g, issue: issueFor(g) }))
|
|
261
|
+
const decisions = box.entries.filter((e) => e.route === 'decision')
|
|
262
|
+
return { groups, dropped, decisions }
|
|
263
|
+
}
|
|
264
|
+
|
|
265
|
+
function realGh(args, input) {
|
|
266
|
+
try {
|
|
267
|
+
return execFileSync('gh', args, { encoding: 'utf8', input, stdio: ['pipe', 'pipe', 'pipe'] })
|
|
268
|
+
} catch (error) {
|
|
269
|
+
throw new DropboxError(`gh ${args[0]} ${args[1] ?? ''} failed: ${String(error.stderr || error.message).trim()}`)
|
|
270
|
+
}
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
// Fingerprint -> URL of the open issue that already carries it.
|
|
274
|
+
// Read by label, not by search: GitHub search does not reliably match text inside a comment.
|
|
275
|
+
export function filedFingerprints(repo, label = DEFAULT_LABEL, gh = realGh) {
|
|
276
|
+
const issues = JSON.parse(gh(['issue', 'list', '-R', repo, '--state', 'open', '--label', label, '--limit', '1000', '--json', 'url,body']))
|
|
277
|
+
const filed = new Map()
|
|
278
|
+
const marker = new RegExp(`${MARKER}:([0-9a-f]{12})`, 'g')
|
|
279
|
+
for (const issue of issues) for (const m of String(issue.body ?? '').matchAll(marker)) filed.set(m[1], issue.url)
|
|
280
|
+
return filed
|
|
281
|
+
}
|
|
282
|
+
|
|
283
|
+
export function post(box, { repo, dir, ref, only, ids, label = DEFAULT_LABEL }, { gh = realGh, git = realGit } = {}) {
|
|
284
|
+
if (!/^[^/\s]+\/[^/\s]+$/.test(repo ?? '')) throw new DropboxError('--repo <owner/name> is required')
|
|
285
|
+
if (only && ids) throw new DropboxError('give --only or --ids, not both')
|
|
286
|
+
for (const id of ids ?? []) {
|
|
287
|
+
const e = box.entries.find((x) => x.id === id)
|
|
288
|
+
if (!e) throw new DropboxError(`no entry ${id}`)
|
|
289
|
+
if (e.route !== 'dropbox') throw new DropboxError(`${id} is a decision; decisions are reported in the handback, never posted`)
|
|
290
|
+
}
|
|
291
|
+
// Group ids are the ones `plan` printed: resolve --only before skipping filed entries.
|
|
292
|
+
const { groups: planned, dropped, decisions } = planPost(box, { dir, ref }, git)
|
|
293
|
+
for (const id of only ?? []) if (!planned.some((g) => g.id === id)) throw new DropboxError(`no group ${id}; run plan again`)
|
|
294
|
+
const chosen = ids ?? (only ? planned.filter((g) => only.includes(g.id)).flatMap((g) => g.entries.map((e) => e.id)) : null)
|
|
295
|
+
const filed = filedFingerprints(repo, label, gh)
|
|
296
|
+
const known = []
|
|
297
|
+
for (const e of box.entries) {
|
|
298
|
+
if (e.status === 'pending' && e.route === 'dropbox' && filed.has(e.fingerprint)) {
|
|
299
|
+
e.status = 'posted'
|
|
300
|
+
e.postedUrl = filed.get(e.fingerprint)
|
|
301
|
+
known.push(e.id)
|
|
302
|
+
}
|
|
303
|
+
}
|
|
304
|
+
const remaining = box.entries.filter((e) => e.status === 'pending' && e.route === 'dropbox' && (!chosen || chosen.includes(e.id)))
|
|
305
|
+
const groups = groupEntries(remaining).map((g) => ({ ...g, issue: issueFor(g) }))
|
|
306
|
+
const posted = []
|
|
307
|
+
for (const group of groups) {
|
|
308
|
+
const url = gh(['issue', 'create', '-R', repo, '--title', group.issue.title, '--label', label, '--body-file', '-'], group.issue.body).trim()
|
|
309
|
+
for (const e of group.entries) {
|
|
310
|
+
e.status = 'posted'
|
|
311
|
+
e.postedUrl = url
|
|
312
|
+
}
|
|
313
|
+
posted.push({ group: group.id, url, entries: group.entries.map((e) => e.id) })
|
|
314
|
+
}
|
|
315
|
+
return { posted, alreadyFiled: known, dropped, decisions: decisions.map(({ id, unit, summary }) => ({ id, unit, summary })) }
|
|
316
|
+
}
|
|
317
|
+
|
|
318
|
+
export function markEntry(box, { id, drop, decision }) {
|
|
319
|
+
const e = box.entries.find((x) => x.id === id)
|
|
320
|
+
if (!e) throw new DropboxError(`no entry ${id}`)
|
|
321
|
+
if (e.status === 'posted') throw new DropboxError(`${id} is already posted at ${e.postedUrl}`)
|
|
322
|
+
if (isText(drop) === Boolean(decision)) throw new DropboxError('mark needs --drop <reason> or --decision')
|
|
323
|
+
if (decision) e.route = 'decision'
|
|
324
|
+
else {
|
|
325
|
+
e.status = 'dropped'
|
|
326
|
+
e.reason = sanitize(drop)
|
|
327
|
+
}
|
|
328
|
+
return { id, status: e.status, route: e.route }
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
// --- review results -------------------------------------------------------------------------
|
|
332
|
+
|
|
333
|
+
export function fromReview(box, review, { pr, inDiffOf = () => null } = {}) {
|
|
334
|
+
const added = []
|
|
335
|
+
for (const f of Array.isArray(review?.findings) ? review.findings : []) {
|
|
336
|
+
if (f?.severity !== 'P2' || isText(f.followUpUrl) || isText(f.dropboxId)) continue
|
|
337
|
+
const input = {
|
|
338
|
+
unit: String(review.unit ?? ''),
|
|
339
|
+
source: 'review',
|
|
340
|
+
kind: KINDS.includes(f.kind) ? f.kind : kindOfPass(f.pass),
|
|
341
|
+
file: f.file,
|
|
342
|
+
line: Number.isSafeInteger(f.line) ? f.line : undefined,
|
|
343
|
+
summary: f.summary,
|
|
344
|
+
pr,
|
|
345
|
+
finding: f.id,
|
|
346
|
+
severity: f.severity,
|
|
347
|
+
}
|
|
348
|
+
const result = addEntry(box, input, isText(f.file) ? inDiffOf(f.file, input.line, review.head) : null)
|
|
349
|
+
f.dropboxId = result.id
|
|
350
|
+
added.push(result.id)
|
|
351
|
+
}
|
|
352
|
+
return added
|
|
353
|
+
}
|
|
354
|
+
|
|
355
|
+
function kindOfPass(pass) {
|
|
356
|
+
return { correctness: 'bug', tests: 'test', standards: 'refactor', spec: 'other' }[pass] ?? 'other'
|
|
357
|
+
}
|
|
358
|
+
|
|
359
|
+
// --- other runs -----------------------------------------------------------------------------
|
|
360
|
+
|
|
361
|
+
export function pendingRuns(runsDir) {
|
|
362
|
+
if (!existsSync(runsDir)) return []
|
|
363
|
+
const out = []
|
|
364
|
+
for (const entry of readdirSync(runsDir, { withFileTypes: true })) {
|
|
365
|
+
const path = join(runsDir, entry.name, 'dropbox.json')
|
|
366
|
+
if (!entry.isDirectory() || !existsSync(path)) continue
|
|
367
|
+
const box = readDropbox(path)
|
|
368
|
+
const pending = box.entries.filter((e) => e.status === 'pending' && e.route === 'dropbox')
|
|
369
|
+
if (pending.length) out.push({ run: entry.name, dropbox: path, pending: pending.length })
|
|
370
|
+
}
|
|
371
|
+
return out
|
|
372
|
+
}
|
|
373
|
+
|
|
374
|
+
// --- command line ---------------------------------------------------------------------------
|
|
375
|
+
|
|
376
|
+
const USAGE = 'usage: dropbox.mjs check|add|from-review|plan|post|mark|pending [options]; see the header'
|
|
377
|
+
|
|
378
|
+
export function parseArgs(argv) {
|
|
379
|
+
const [command, ...rest] = argv
|
|
380
|
+
const opts = { command, blocks: [] }
|
|
381
|
+
for (let i = 0; i < rest.length; i++) {
|
|
382
|
+
const flag = rest[i]
|
|
383
|
+
if (!flag.startsWith('--')) throw new DropboxError(USAGE)
|
|
384
|
+
const key = flag.slice(2)
|
|
385
|
+
if (key === 'decision') { opts.decision = true; continue }
|
|
386
|
+
const value = rest[++i]
|
|
387
|
+
if (value === undefined) throw new DropboxError(`${flag} needs a value`)
|
|
388
|
+
if (key === 'blocks') opts.blocks.push(value)
|
|
389
|
+
else opts[key] = value
|
|
390
|
+
}
|
|
391
|
+
if (opts.line !== undefined) opts.line = Number(opts.line)
|
|
392
|
+
if (opts.only !== undefined) opts.only = opts.only.split(',')
|
|
393
|
+
if (opts.ids !== undefined) opts.ids = opts.ids.split(',')
|
|
394
|
+
return opts
|
|
395
|
+
}
|
|
396
|
+
|
|
397
|
+
function need(opts, ...keys) {
|
|
398
|
+
const missing = keys.filter((k) => !isText(opts[k]))
|
|
399
|
+
if (missing.length) throw new DropboxError(`${opts.command} needs ${missing.map((k) => `--${k}`).join(', ')}`)
|
|
400
|
+
}
|
|
401
|
+
|
|
402
|
+
export function run(opts, deps = {}) {
|
|
403
|
+
const git = deps.git ?? realGit
|
|
404
|
+
const diffCheck = (file, line, head) => (opts.git && opts.base ? inUnitDiff({ dir: opts.git, base: opts.base, head, file, line }, git) : null)
|
|
405
|
+
switch (opts.command) {
|
|
406
|
+
case 'check': {
|
|
407
|
+
need(opts, 'git', 'base', 'file')
|
|
408
|
+
validateEntry({ unit: '-', source: 'implementer', kind: 'other', summary: '-', file: opts.file, line: opts.line })
|
|
409
|
+
const inside = inUnitDiff({ dir: opts.git, base: opts.base, file: opts.file, line: opts.line }, git)
|
|
410
|
+
return { out: { inDiff: inside, do: inside ? 'fix it in this unit' : 'outside this unit: it may go in the dropbox' } }
|
|
411
|
+
}
|
|
412
|
+
case 'add': {
|
|
413
|
+
need(opts, 'dropbox')
|
|
414
|
+
if (opts.source === 'implementer' && !opts.decision) need(opts, 'git', 'base')
|
|
415
|
+
const box = readDropbox(opts.dropbox)
|
|
416
|
+
const inDiff = opts.file ? diffCheck(opts.file, opts.line) : null
|
|
417
|
+
const result = addEntry(box, opts, inDiff)
|
|
418
|
+
if (result.refused) return { out: result }
|
|
419
|
+
writeJson(opts.dropbox, box)
|
|
420
|
+
return { out: result }
|
|
421
|
+
}
|
|
422
|
+
case 'from-review': {
|
|
423
|
+
need(opts, 'dropbox', 'review')
|
|
424
|
+
const box = readDropbox(opts.dropbox)
|
|
425
|
+
let review
|
|
426
|
+
try {
|
|
427
|
+
review = JSON.parse(readFileSync(opts.review, 'utf8'))
|
|
428
|
+
} catch (error) {
|
|
429
|
+
throw new DropboxError(`cannot read ${opts.review}: ${error.message}`)
|
|
430
|
+
}
|
|
431
|
+
const added = fromReview(box, review, { pr: opts.pr, inDiffOf: diffCheck })
|
|
432
|
+
writeJson(opts.dropbox, box)
|
|
433
|
+
writeJson(opts.review, review)
|
|
434
|
+
return { out: { added } }
|
|
435
|
+
}
|
|
436
|
+
case 'plan': {
|
|
437
|
+
need(opts, 'dropbox')
|
|
438
|
+
const box = readDropbox(opts.dropbox)
|
|
439
|
+
return { out: planPost(box, { dir: opts.git, ref: opts.ref }, git) }
|
|
440
|
+
}
|
|
441
|
+
case 'post': {
|
|
442
|
+
need(opts, 'dropbox', 'repo')
|
|
443
|
+
const box = readDropbox(opts.dropbox)
|
|
444
|
+
const result = post(box, { ...opts, dir: opts.git }, { gh: deps.gh ?? realGh, git })
|
|
445
|
+
writeJson(opts.dropbox, box)
|
|
446
|
+
return { out: result }
|
|
447
|
+
}
|
|
448
|
+
case 'mark': {
|
|
449
|
+
need(opts, 'dropbox', 'id')
|
|
450
|
+
const box = readDropbox(opts.dropbox)
|
|
451
|
+
const result = markEntry(box, opts)
|
|
452
|
+
writeJson(opts.dropbox, box)
|
|
453
|
+
return { out: result }
|
|
454
|
+
}
|
|
455
|
+
case 'pending': {
|
|
456
|
+
need(opts, 'runs')
|
|
457
|
+
const runs = pendingRuns(opts.runs)
|
|
458
|
+
return { out: { runs } }
|
|
459
|
+
}
|
|
460
|
+
default:
|
|
461
|
+
throw new DropboxError(USAGE)
|
|
462
|
+
}
|
|
463
|
+
}
|
|
464
|
+
|
|
465
|
+
if (isMainModule(import.meta.url)) {
|
|
466
|
+
try {
|
|
467
|
+
const { out } = run(parseArgs(process.argv.slice(2)))
|
|
468
|
+
process.stdout.write(`${JSON.stringify(out, null, 2)}\n`)
|
|
469
|
+
} catch (error) {
|
|
470
|
+
process.stderr.write(`${error instanceof DropboxError ? error.message : error.stack}\n`)
|
|
471
|
+
process.exitCode = 2
|
|
472
|
+
}
|
|
473
|
+
}
|