@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,232 @@
|
|
|
1
|
+
# Publish
|
|
2
|
+
|
|
3
|
+
> Read when: the cut is committed; pushing it, merging the metadata PR, tagging the verified merged SHA, and watching the publisher.
|
|
4
|
+
|
|
5
|
+
This tag-triggered path is not the package-scoped dispatcher path. For
|
|
6
|
+
independently versioned npm workspaces, use [workspace-npm.md](workspace-npm.md)
|
|
7
|
+
and let the publish workflow create each package tag and release.
|
|
8
|
+
|
|
9
|
+
Push the cut, tag it, and watch the publisher. A pushed final tag that fails to
|
|
10
|
+
publish **burns the version**. A Cloud Run RC tag that fails burns that RC
|
|
11
|
+
ordinal, not the final version. Do not move or delete either tag to "reuse" it.
|
|
12
|
+
|
|
13
|
+
The invocation, recorded as the plan receipt in [cut.md](cut.md), already
|
|
14
|
+
authorizes every action in this procedure and [promotion.md](promotion.md). Do
|
|
15
|
+
not insert a confirmation before the branch push, PR queue, candidate
|
|
16
|
+
validation, traffic shift, rollback, tag push, GitHub Release, or publisher
|
|
17
|
+
watch. A provider or repository gate either passes and the sequence continues,
|
|
18
|
+
or fails and the run hands back. If resolving a failure would change the
|
|
19
|
+
recorded identity or action set, return to planning, record the replacement
|
|
20
|
+
plan, and continue.
|
|
21
|
+
|
|
22
|
+
On callback or resume, open `.git/<invoked-skill>-authorization.json` and re-read
|
|
23
|
+
the named provider run, artifact, and live coordinates. Require exact repository,
|
|
24
|
+
SHA, version/tag, operation, mutation, profile, target, and freshness matches.
|
|
25
|
+
Otherwise mark the permission `invalidated` or `failed` and do nothing. On a
|
|
26
|
+
match, mark it `executable`, then `consumed` immediately before mutation. Never
|
|
27
|
+
replay it. After partial execution, keep it consumed, record the failure, and
|
|
28
|
+
hand back.
|
|
29
|
+
|
|
30
|
+
For human-approved prepared-metadata reuse, first require every stage output
|
|
31
|
+
and the distinct fresh receipt from [prepared-metadata.md](prepared-metadata.md).
|
|
32
|
+
Do not read the failed attempt's receipt or copy its permissions. Use the new
|
|
33
|
+
receipt path on resume, not the fixed normal-cut path below. Bind operational
|
|
34
|
+
`<mergedSha>` to `plan.releaseSourceSha` (the newly frozen, reviewed CI-green
|
|
35
|
+
main target); `metadata.mergeSha` is historical only. Skip section 1 and section
|
|
36
|
+
2's new-cut tree comparison, not the main/CI/provider gates. No new metadata PR
|
|
37
|
+
is created. Both routes then use section 3 and the same promotion procedure.
|
|
38
|
+
|
|
39
|
+
## 1. Push and merge the metadata PR
|
|
40
|
+
|
|
41
|
+
Push the immutable cut head, then open a PR against `main`. Do not create or
|
|
42
|
+
push the release tag yet:
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
git push origin HEAD:refs/heads/release/<tag>
|
|
46
|
+
gh pr create --base main --head release/<tag> \
|
|
47
|
+
--title "chore(release): <nextVersion>" \
|
|
48
|
+
--body "Metadata-only GitHub Flow release cut from <candidateSha>."
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
Deliver that PR through the repository's configured merge queue and its
|
|
52
|
+
stateful watcher when a queue exists (Mergify: the `mergify` skill's
|
|
53
|
+
`scripts/watch-pr-delivery.mjs`). Without one, require the repository's
|
|
54
|
+
documented PR merge policy and green required checks on the exact head;
|
|
55
|
+
never pretend a command comment proves queue admission. A conflict with `main`
|
|
56
|
+
is a replan from current `main`, never a rebase of the cut. Freeze the
|
|
57
|
+
provider-reported merge commit as `<mergedSha>` and independently verify the
|
|
58
|
+
PR's head was `<cutSha>`. A squash merge is refused because `<cutSha>` would
|
|
59
|
+
not be an ancestor of `<mergedSha>`.
|
|
60
|
+
|
|
61
|
+
If `main` is genuinely unprotected and direct pushes are the repository's
|
|
62
|
+
documented release path, a successful fast-forward of `<cutSha>` to `main`
|
|
63
|
+
may use `<cutSha>` as `<mergedSha>`. Never infer this from local state: re-fetch
|
|
64
|
+
and verify the remote ref.
|
|
65
|
+
|
|
66
|
+
## 2. Verify the merged main SHA
|
|
67
|
+
|
|
68
|
+
The release tag must name a commit reachable from the remote default branch.
|
|
69
|
+
This is the ancestry gate used by release publishers to refuse off-main
|
|
70
|
+
releases:
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
git fetch origin main
|
|
74
|
+
git merge-base --is-ancestor "<cutSha>" "<mergedSha>"
|
|
75
|
+
git merge-base --is-ancestor "<mergedSha>" origin/main
|
|
76
|
+
test "$(git rev-parse "<cutSha>^{tree}")" = \
|
|
77
|
+
"$(git rev-parse "<mergedSha>^{tree}")"
|
|
78
|
+
test "$(git show "<mergedSha>:package.json" | jq -r .version)" = "<nextVersion>"
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
The tree equality check proves the provider merge introduced no post-freeze
|
|
82
|
+
`main` changes beyond the approved cut. If it fails, do not tag: abandon the
|
|
83
|
+
unpublished cut and restart candidate selection and planning from current
|
|
84
|
+
`main`. Use the repository's declared version file in the `git show` check
|
|
85
|
+
when it is not `package.json`. Re-read the exact required queue/CI result for
|
|
86
|
+
`<mergedSha>` before tagging. A green cut head is not evidence for a different
|
|
87
|
+
merge commit.
|
|
88
|
+
|
|
89
|
+
## Node Pre-Tag Registry Gate
|
|
90
|
+
|
|
91
|
+
For v2 `pre-tag` npm reuse, perform this read-only check after source verification
|
|
92
|
+
and applicable `after-merge` checks, immediately before consuming the new final-
|
|
93
|
+
tag creation permission. Use the package/version from the verified plan's npm
|
|
94
|
+
artifact and the exact effective registry recorded at preflight; do not derive
|
|
95
|
+
a new package, version or registry from ambient defaults at this point.
|
|
96
|
+
|
|
97
|
+
```bash
|
|
98
|
+
node <skillsRoot>/resolve-release/scripts/npm-version-absence.mjs \
|
|
99
|
+
--package "<verified package>" --version "<nextVersion>" \
|
|
100
|
+
--registry "<recorded registry>"
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
The helper runs only `npm view` with a 30-second timeout and a 1 MiB combined
|
|
104
|
+
output bound, never publish or tagging. It reports `absent`, `present`, or
|
|
105
|
+
`inconclusive`; only `absent` exits zero. Absence requires exit 1 with E404 in
|
|
106
|
+
the expected JSON `error.code` field or a supported plain npm error form, and
|
|
107
|
+
no conflicting code on either channel. Incidental E404 text, unknown or
|
|
108
|
+
non-string codes, duplicate keys, malformed or text-prefixed JSON and multiple
|
|
109
|
+
documents cannot clear the gate. Exact-version success proves presence and
|
|
110
|
+
blocks a new publication; auth/network/server errors, unexpected or empty
|
|
111
|
+
responses, process failure, invalid UTF-8 and exceeded bounds are inconclusive
|
|
112
|
+
and block. No raw npm response, error text or credentials belong in the receipt
|
|
113
|
+
or logs.
|
|
114
|
+
|
|
115
|
+
Record `npmVersionAbsence` with the helper's checked package, version, registry,
|
|
116
|
+
outcome and observation time, bound to this exact source SHA, plan hash and new
|
|
117
|
+
receipt. Require `absent` and exact scope equality; neither supplied JSON nor a
|
|
118
|
+
previous observation substitutes for running the gate. Re-inspect exact remote
|
|
119
|
+
final-tag absence at the same creation checkpoint. Both checks are observations,
|
|
120
|
+
not reservations: publisher-side protections remain required, and failure after
|
|
121
|
+
a final tag has been pushed follows the existing immutable-tag failure policy.
|
|
122
|
+
A same-attempt resume of a consumed tag operation is not a fresh pre-tag attempt
|
|
123
|
+
and must follow its recorded operation rather than bypassing this gate.
|
|
124
|
+
|
|
125
|
+
## 3. Publish by mode
|
|
126
|
+
|
|
127
|
+
For a new prepared-metadata reuse attempt, successfully inspect the exact refs
|
|
128
|
+
on `origin` at each creation checkpoint; errors or collisions block. Before
|
|
129
|
+
creating the Cloud Run candidate tag, both candidate and final refs must still
|
|
130
|
+
be absent. Before creating the final tag after verified promotion, the final
|
|
131
|
+
ref must be absent and the existing candidate must resolve to this attempt's
|
|
132
|
+
recorded release source SHA, with its creation recorded as consumed in this
|
|
133
|
+
attempt's receipt. For an artifact-only release, require final-ref absence
|
|
134
|
+
before its creation. A planner's earlier inspection is not a reservation.
|
|
135
|
+
A same-SHA tag can be a resume no-op only for the exact already recorded,
|
|
136
|
+
consumed operation in this new attempt's receipt, never a fresh attempt's
|
|
137
|
+
permission to reuse the failed historical RC.
|
|
138
|
+
|
|
139
|
+
Push every release tag from a detached HEAD at `<mergedSha>`. Never `--no-verify`.
|
|
140
|
+
|
|
141
|
+
```bash
|
|
142
|
+
git fetch origin main
|
|
143
|
+
git switch --detach "<mergedSha>"
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
**Artifact-only:** for v2 `pre-tag` npm reuse, first run the
|
|
147
|
+
[Node pre-tag registry gate](#node-pre-tag-registry-gate), require a fresh,
|
|
148
|
+
exact-scope `absent` observation, and bind it to this attempt's final-tag
|
|
149
|
+
permission. A successful Git-only plan cannot satisfy that gate. Then create
|
|
150
|
+
and push the final annotated tag on `<mergedSha>` and continue to the publisher
|
|
151
|
+
watch:
|
|
152
|
+
|
|
153
|
+
```bash
|
|
154
|
+
git tag -a "<tag>" "<mergedSha>" -m "Release <tag>"
|
|
155
|
+
git push origin "refs/tags/<tag>"
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
**Cloud Run staged:** create and push `<candidateTag>` on `<mergedSha>`. Watch
|
|
159
|
+
Cloud Build until it emits the exact candidate receipt, then execute
|
|
160
|
+
[promotion.md](promotion.md). Only after live verification succeeds, create and
|
|
161
|
+
push the final tag on the same `<mergedSha>`. The final tag must not trigger a
|
|
162
|
+
second Cloud Run build.
|
|
163
|
+
|
|
164
|
+
```bash
|
|
165
|
+
git tag -a "<candidateTag>" "<mergedSha>" -m "Candidate <candidateTag>"
|
|
166
|
+
git push origin "refs/tags/<candidateTag>"
|
|
167
|
+
# After promotion.md succeeds:
|
|
168
|
+
git tag -a "<tag>" "<mergedSha>" -m "Release <tag>"
|
|
169
|
+
git push origin "refs/tags/<tag>"
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
A Mergify stack pre-push hook checks only the current branch: it refuses any push
|
|
173
|
+
from a branch with an upstream and `Change-Id` commits, tags included, and allows
|
|
174
|
+
a detached HEAD. Still refused from a detached HEAD: report the hook output and
|
|
175
|
+
stop.
|
|
176
|
+
|
|
177
|
+
Re-tagging the same SHA is a resume no-op. A tag that already names a
|
|
178
|
+
**different** SHA is a stop. There is no `--force`.
|
|
179
|
+
|
|
180
|
+
If preflight recorded a workflow that publishes only on
|
|
181
|
+
`release: published`, create the GitHub Release after the tag is on the
|
|
182
|
+
remote (`gh release create <tag> --notes-file …`). Otherwise the tag push is
|
|
183
|
+
the trigger.
|
|
184
|
+
|
|
185
|
+
## 4. Watch
|
|
186
|
+
|
|
187
|
+
Launch one background watcher; do not poll in the foreground.
|
|
188
|
+
|
|
189
|
+
**Cloud Build** (`publisher` `cloudbuild` or `both`) is watched first for the RC
|
|
190
|
+
tag and exact merged SHA. `SUCCESS` means only that candidate production
|
|
191
|
+
succeeded; Cloud Run success requires [promotion.md](promotion.md):
|
|
192
|
+
|
|
193
|
+
```bash
|
|
194
|
+
gcloud builds list --limit=1 --format='value(id,status,substitutions.TAG_NAME)' \
|
|
195
|
+
--filter="substitutions.TAG_NAME=<candidateTag> OR tags=<candidateTag>"
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
`FAILURE` / `TIMEOUT` / `CANCELLED` is a hand-back. Load `cloud-debug` only to
|
|
199
|
+
diagnose, not to rerun the release.
|
|
200
|
+
|
|
201
|
+
**npm** (`publisher` `npm` or `both`):
|
|
202
|
+
|
|
203
|
+
```bash
|
|
204
|
+
npm view <package>@<nextVersion> version
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
Success is stdout equal to `<nextVersion>`. An `E404` means "not published
|
|
208
|
+
yet" and the watcher continues. Any other npm error is inconclusive — stop
|
|
209
|
+
rather than treating it as unpublished or published.
|
|
210
|
+
|
|
211
|
+
When a GitHub Actions workflow is the npm publisher, `gh run list` /
|
|
212
|
+
`gh run watch` for the tag SHA is the wait; `npm view` remains the proof the
|
|
213
|
+
artifact exists. A release flow's `registry` is passed as `--registry` to every
|
|
214
|
+
npm command, and its `after-publish` steps run once the artifact is proven.
|
|
215
|
+
|
|
216
|
+
## Release flow steps
|
|
217
|
+
|
|
218
|
+
When preflight loaded a release flow, run its steps at their points, in order,
|
|
219
|
+
as repository commands ([flows.md](flows.md)): `after-merge` once
|
|
220
|
+
`<mergedSha>` is verified, `after-publish` after the artifact proof. A failing
|
|
221
|
+
step before any traffic moved or any artifact was published is a hand-back with
|
|
222
|
+
nothing exposed; after a publish it is a hand-back that names what already
|
|
223
|
+
shipped. Check the `hand-back-if` conditions at preflight and again before each
|
|
224
|
+
outward action.
|
|
225
|
+
|
|
226
|
+
## 5. Failure
|
|
227
|
+
|
|
228
|
+
If an artifact watch fails after the final tag, leave it in place and hand
|
|
229
|
+
back that the version is burned. If a staged candidate build fails, leave its
|
|
230
|
+
RC tag, keep the final tag unused, and hand back with production untouched.
|
|
231
|
+
Promotion failures follow [promotion.md](promotion.md). A fix starts from a new
|
|
232
|
+
green HEAD and a replacement plan; tags are never moved or deleted.
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
# Workspace npm release
|
|
2
|
+
|
|
3
|
+
Use this route only when preflight establishes a private workspace root,
|
|
4
|
+
independently versioned publishable packages, and a repository-declared
|
|
5
|
+
package-scoped dispatch workflow. Read that workflow and the repository's
|
|
6
|
+
release instructions. Its package input, source ref, tag behavior, provenance
|
|
7
|
+
checks, and required CI are contracts to verify, not defaults to guess. Never
|
|
8
|
+
run the root-tag `green-head.mjs`, `plan.mjs`, or `apply.mjs` on this route.
|
|
9
|
+
|
|
10
|
+
## Freeze the candidate
|
|
11
|
+
|
|
12
|
+
Fetch `origin/main` and identify the newest first-parent commit with green CI
|
|
13
|
+
evidence for its **exact tree**. Prefer successful required checks on that SHA.
|
|
14
|
+
In a PR-only CI repository, a merged PR's head may supply the evidence only
|
|
15
|
+
when the PR reports the exact head SHA, its merge commit is on `main`, that
|
|
16
|
+
head is a parent of the merge commit, and their Git trees match. Verify the
|
|
17
|
+
required contexts using applicable branch protection **and** repository or
|
|
18
|
+
organization rulesets, not just the Branch Protection API. Read the check
|
|
19
|
+
runs on the evidenced SHA: missing, pending, failing, or absent CI is not
|
|
20
|
+
green. Record PR, head SHA, merge SHA, required checks, and tree equality.
|
|
21
|
+
If a newer `main` commit has no valid evidence, do not silently call an older
|
|
22
|
+
candidate a release of that newer change. Confirm the frozen candidate
|
|
23
|
+
contains every package change in scope, or stop and obtain CI evidence. An
|
|
24
|
+
explicit `workflow_dispatch` CI run on `main` is acceptable only if its
|
|
25
|
+
completed run's head SHA equals the candidate and all required checks pass.
|
|
26
|
+
|
|
27
|
+
## Plan once
|
|
28
|
+
|
|
29
|
+
Resolve the selected package set from the user's scope and changes since each
|
|
30
|
+
package's latest `name@version` tag. When the invocation names no packages,
|
|
31
|
+
the set is every package with changes since its latest tag; that default is
|
|
32
|
+
recorded in the plan, not asked. Determine SemVer separately for every package;
|
|
33
|
+
include meta/bundle packages whose exact dependency pins must change. Compare
|
|
34
|
+
proposed versions and tags against both npm and remote tags. Plan a single
|
|
35
|
+
metadata PR when workspace pin validation requires versions to agree; publish
|
|
36
|
+
components before packages that bundle them. List every manifest, exact pin,
|
|
37
|
+
lockfile, and package-scoped changelog entry in the planned diff. Do not bump
|
|
38
|
+
the private root version or create a root `v*` tag.
|
|
39
|
+
|
|
40
|
+
A release flow ([flows.md](flows.md)) pins what this section
|
|
41
|
+
would otherwise infer, and each pin is still checked against the tree:
|
|
42
|
+
`publisher.workflow`/`publisher.input` name the dispatcher and its package
|
|
43
|
+
input; `packages.exclude` is never selected, even when changed;
|
|
44
|
+
`packages.publishLast` is dispatched after every other selected package;
|
|
45
|
+
`changelog: package-scoped` writes `## [<pkg>@<version>] - <date>` headings;
|
|
46
|
+
`registry` is passed as `--registry` to every npm command. A flow `ask:` item
|
|
47
|
+
(for example whether a bundle package takes the new component pins) is a
|
|
48
|
+
preflight choice, answered before this plan.
|
|
49
|
+
|
|
50
|
+
Show the frozen SHA and CI evidence, selected packages and bump reasons,
|
|
51
|
+
metadata diff, publisher workflow, merge policy, publish order, and outward
|
|
52
|
+
actions: branch/commit, PR delivery, one dispatch per package, registry and
|
|
53
|
+
provenance verification, and workflow-owned tags/releases. Show the whole plan
|
|
54
|
+
as a record before any Git mutation or dispatch; the invocation is the
|
|
55
|
+
authorization. Store it in
|
|
56
|
+
`.git/<invoked-skill>-authorization.json` with repository, candidate, packages,
|
|
57
|
+
versions, tags, publisher, operations, timestamp, expiry, and separate
|
|
58
|
+
pending-conditions permissions for each mutation/dispatch. Re-read it and
|
|
59
|
+
provider state on resume; invalidate drift and consume each permission before
|
|
60
|
+
the corresponding action. Never infer permission for one package from another.
|
|
61
|
+
|
|
62
|
+
## Cut and merge
|
|
63
|
+
|
|
64
|
+
Branch from the frozen candidate, edit only the planned metadata, and update
|
|
65
|
+
the lockfile with the repository's package manager. Verify the manifest and
|
|
66
|
+
lockfile pins match, run the repository's verification and pack dry-runs, and
|
|
67
|
+
check that each tarball contains its new runtime files (including bundled
|
|
68
|
+
dependencies). Commit only the metadata. The cut's parent must equal the
|
|
69
|
+
candidate. Do not rebase onto later trunk content without a replacement plan.
|
|
70
|
+
|
|
71
|
+
Open a PR and use the repository's **actual** delivery policy. If a merge
|
|
72
|
+
queue is configured, enqueue before running its stateful watcher; a command
|
|
73
|
+
comment alone is not admission. If there is no queue, require green exact-head
|
|
74
|
+
checks and use a merge method allowed by the repository's rules. Refuse squash
|
|
75
|
+
when cut-head ancestry is required. Re-read PR head, base, checks, and merge
|
|
76
|
+
policy before delivery. After merge, fetch `main`, prove the reported PR head
|
|
77
|
+
was the cut, the cut is an ancestor of the merged SHA, the merged SHA is on
|
|
78
|
+
`origin/main`, and their trees are identical. If main moved or trees differ,
|
|
79
|
+
do not dispatch: restart candidate selection and the complete plan.
|
|
80
|
+
|
|
81
|
+
## Publish in dependency order
|
|
82
|
+
|
|
83
|
+
Before each dispatch, check that the workflow's `main` ref still resolves to
|
|
84
|
+
the verified merged SHA and that the version is not already published with a
|
|
85
|
+
different provenance. Dispatch the discovered workflow with its documented
|
|
86
|
+
package input. Record the returned run ID; verify that run's head SHA and input
|
|
87
|
+
identify the approved merge and package. Watch the run in the background, then
|
|
88
|
+
independently verify the exact version in the public registry, its attestation
|
|
89
|
+
resolves to the merged SHA, and its package-scoped tag peels to that SHA. The
|
|
90
|
+
workflow, not the agent, creates package tags/releases. A successful workflow
|
|
91
|
+
without registry/provenance/tag proof is not a completed publish. Only then
|
|
92
|
+
dispatch a dependent bundle. If a dispatch fails or an already-published
|
|
93
|
+
version has different provenance, stop; do not overwrite a version or tag.
|
|
94
|
+
|
|
95
|
+
Run the flow's `before-cut` steps before committing the cut, `after-merge`
|
|
96
|
+
after the merged SHA is verified, and `after-publish` after each package's
|
|
97
|
+
registry/provenance/tag proof. A `hand-back-if` condition that holds for a
|
|
98
|
+
planned package (for example a first publish that needs a human npm login)
|
|
99
|
+
stops the run before that package's dispatch.
|
|
100
|
+
|
|
101
|
+
Hand back the candidate, cut, merged SHA, metadata PR, package versions,
|
|
102
|
+
workflow run IDs, registry proofs, attestations, and tags. An install or live
|
|
103
|
+
smoke is additional evidence, not a substitute for any publish gate.
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { spawnSync } from 'node:child_process';
|
|
3
|
+
import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
|
|
4
|
+
import { homedir } from 'node:os';
|
|
5
|
+
import { dirname, join } from 'node:path';
|
|
6
|
+
import { fileURLToPath } from 'node:url';
|
|
7
|
+
|
|
8
|
+
const DAY_MS = 24 * 60 * 60 * 1000;
|
|
9
|
+
const WEEK_MS = 7 * DAY_MS;
|
|
10
|
+
const here = dirname(fileURLToPath(import.meta.url));
|
|
11
|
+
|
|
12
|
+
function readJson(path, fallback = {}) {
|
|
13
|
+
try { return JSON.parse(readFileSync(path, 'utf8')); } catch { return fallback; }
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
function frontmatterValue(text, key) {
|
|
17
|
+
const frontmatter = /^---\n([\s\S]*?)\n---/.exec(text)?.[1] ?? '';
|
|
18
|
+
const match = new RegExp('^' + key + ':\\s*([^\\n]+)$', 'm').exec(frontmatter);
|
|
19
|
+
return match?.[1].trim().replace(/^['"]|['"]$/g, '') ?? null;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
function repositoryOf(source) {
|
|
23
|
+
const value = String(source ?? '').trim();
|
|
24
|
+
const match = /^(?:git@github\.com:|https:\/\/github\.com\/)?([A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+?)(?:\.git)?$/.exec(value);
|
|
25
|
+
return match?.[1] ?? null;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
function stableVersion(value) {
|
|
29
|
+
const match = /^v?(\d+)\.(\d+)\.(\d+)$/.exec(String(value ?? '').trim());
|
|
30
|
+
return match ? match.slice(1).map(Number) : null;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
function newer(left, right) {
|
|
34
|
+
for (let index = 0; index < 3; index += 1) {
|
|
35
|
+
if (left[index] !== right[index]) return left[index] > right[index];
|
|
36
|
+
}
|
|
37
|
+
return false;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
function writeCache(path, value) {
|
|
41
|
+
try {
|
|
42
|
+
mkdirSync(dirname(path), { recursive: true });
|
|
43
|
+
writeFileSync(path, JSON.stringify(value));
|
|
44
|
+
} catch { /* A read-only cache must not block skill use. */ }
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
function main(now = Date.now()) {
|
|
48
|
+
if (process.env.ONEABOVEIO_NO_UPDATE_CHECK) return;
|
|
49
|
+
const skill = readFileSync(join(here, 'SKILL.md'), 'utf8');
|
|
50
|
+
const name = frontmatterValue(skill, 'name');
|
|
51
|
+
const localVersion = stableVersion(frontmatterValue(skill, 'release-version'));
|
|
52
|
+
if (!name || !localVersion) return;
|
|
53
|
+
|
|
54
|
+
const lock = readJson(join(process.env.HOME || homedir(), '.agents', '.skill-lock.json'));
|
|
55
|
+
const entry = lock.skills?.[name];
|
|
56
|
+
const repository = repositoryOf(entry?.sourceUrl || entry?.source);
|
|
57
|
+
if (!repository) return;
|
|
58
|
+
|
|
59
|
+
const cacheRoot = process.env.XDG_CACHE_HOME || join(process.env.HOME || homedir(), '.cache');
|
|
60
|
+
const cachePath = join(cacheRoot, '1aboveio-skills', 'release-check.json');
|
|
61
|
+
const all = readJson(cachePath);
|
|
62
|
+
const cache = all[repository] && typeof all[repository] === 'object' ? all[repository] : {};
|
|
63
|
+
|
|
64
|
+
if (!cache.lastCheck || now - cache.lastCheck >= DAY_MS) {
|
|
65
|
+
const result = spawnSync('gh', ['api', 'repos/' + repository + '/releases/latest', '--jq', '.tag_name'], {
|
|
66
|
+
encoding: 'utf8',
|
|
67
|
+
stdio: ['ignore', 'pipe', 'ignore'],
|
|
68
|
+
timeout: 1500,
|
|
69
|
+
});
|
|
70
|
+
cache.lastCheck = now;
|
|
71
|
+
if (result.status === 0 && stableVersion(result.stdout)) cache.latestTag = result.stdout.trim();
|
|
72
|
+
else delete cache.latestTag;
|
|
73
|
+
all[repository] = cache;
|
|
74
|
+
writeCache(cachePath, all);
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
const latestVersion = stableVersion(cache.latestTag);
|
|
78
|
+
if (!latestVersion || !newer(latestVersion, localVersion)) return;
|
|
79
|
+
if (cache.notifiedTag === cache.latestTag && cache.notifiedAt && now - cache.notifiedAt < WEEK_MS) return;
|
|
80
|
+
|
|
81
|
+
cache.notifiedTag = cache.latestTag;
|
|
82
|
+
cache.notifiedAt = now;
|
|
83
|
+
all[repository] = cache;
|
|
84
|
+
writeCache(cachePath, all);
|
|
85
|
+
const command = `npx skills@1.5.23 add '${repository}#${cache.latestTag}' --global --agent universal claude-code --skill ${name} --yes`;
|
|
86
|
+
process.stdout.write(
|
|
87
|
+
`UPDATE_AVAILABLE: A newer 1AboveIO skills release (${cache.latestTag}) is available; this skill is `
|
|
88
|
+
+ `v${localVersion.join('.')}. Ask once whether to refresh ${name}. On approval run \`${command}\`. `
|
|
89
|
+
+ 'The refreshed instructions apply next session. Either way, continue the current task and do not ask again this session.\n',
|
|
90
|
+
);
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
try { main(); } catch { /* Update checks are advisory and always fail silent. */ }
|
|
@@ -0,0 +1,212 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// Write changelog section + version identity files. Does not commit.
|
|
3
|
+
//
|
|
4
|
+
// Usage:
|
|
5
|
+
// node apply.mjs --version <x.y.z> --date <YYYY-MM-DD> --changelog-section - [--json]
|
|
6
|
+
//
|
|
7
|
+
// Exit: 0 ok · 1 IO/parse failed · 2 usage
|
|
8
|
+
import { existsSync, readFileSync, writeFileSync } from 'node:fs'
|
|
9
|
+
import { join } from 'node:path'
|
|
10
|
+
import { spawnSync } from 'node:child_process'
|
|
11
|
+
import { isMainModule } from '../../engineering-runtime/scripts/main-module.mjs'
|
|
12
|
+
import { DISTRIBUTION_MANIFEST, discoverVersionFiles, parseSemver } from './plan.mjs'
|
|
13
|
+
|
|
14
|
+
export function insertChangelog(markdown, { version, date, section }) {
|
|
15
|
+
const heading = `## [${version}] - ${date}`
|
|
16
|
+
const body = String(section || '').trim() || heading
|
|
17
|
+
const existing = String(markdown || '')
|
|
18
|
+
if (!body.startsWith(heading)) {
|
|
19
|
+
const err = new Error(`changelog section must start with ${heading}`)
|
|
20
|
+
err.exitCode = 2
|
|
21
|
+
throw err
|
|
22
|
+
}
|
|
23
|
+
const escapedVersion = version.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
|
|
24
|
+
const versionHeading = new RegExp(`^## \\[${escapedVersion}\\][^\\n]*`, 'm').exec(existing)
|
|
25
|
+
if (versionHeading) {
|
|
26
|
+
const start = versionHeading.index
|
|
27
|
+
const rest = existing.slice(start)
|
|
28
|
+
const next = rest.slice(versionHeading[0].length).search(/^## \[/m)
|
|
29
|
+
const end = next === -1 ? existing.length : start + versionHeading[0].length + next
|
|
30
|
+
const actual = existing.slice(start, end).trim()
|
|
31
|
+
if (actual === body || actual.startsWith(`${body}\n`)) return existing
|
|
32
|
+
const err = new Error(`existing ${version} changelog section does not match the recorded plan`)
|
|
33
|
+
err.exitCode = 1
|
|
34
|
+
throw err
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
const unreleased = /^## \[Unreleased\]\s*\n/m.exec(existing)
|
|
38
|
+
if (unreleased) {
|
|
39
|
+
const start = unreleased.index + unreleased[0].length
|
|
40
|
+
const next = existing.slice(start).search(/^## \[/m)
|
|
41
|
+
const end = next === -1 ? existing.length : start + next
|
|
42
|
+
const kept = existing.slice(start, end).trim()
|
|
43
|
+
const combined = kept ? `${body}\n\n${kept}` : body
|
|
44
|
+
return `${existing.slice(0, unreleased.index)}## [Unreleased]\n\n${heading}\n${stripHeading(combined, version)}\n\n${existing.slice(end).replace(/^\n+/, '')}`
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
const title = /^# .+\n/.exec(existing)
|
|
48
|
+
if (title) {
|
|
49
|
+
return `${existing.slice(0, title[0].length)}\n${body}\n\n${existing.slice(title[0].length).replace(/^\n+/, '')}`
|
|
50
|
+
}
|
|
51
|
+
return `# Changelog\n\n${body}\n`
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
function stripHeading(text, version) {
|
|
55
|
+
return text.replace(new RegExp(`^## \\[${version}\\][^\\n]*\\n?`), '').trim()
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
export function bumpPackageJson(text, version) {
|
|
59
|
+
const pkg = JSON.parse(text)
|
|
60
|
+
pkg.version = version
|
|
61
|
+
return `${JSON.stringify(pkg, null, 2)}\n`
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
export function bumpPackageLock(text, version) {
|
|
65
|
+
const lock = JSON.parse(text)
|
|
66
|
+
lock.version = version
|
|
67
|
+
if (lock.packages && lock.packages[''] && typeof lock.packages[''] === 'object') {
|
|
68
|
+
lock.packages[''].version = version
|
|
69
|
+
}
|
|
70
|
+
return `${JSON.stringify(lock, null, 2)}\n`
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
export function bumpPyproject(text, version) {
|
|
74
|
+
let inProject = false
|
|
75
|
+
let replaced = false
|
|
76
|
+
const lines = String(text).split('\n')
|
|
77
|
+
const out = lines.map((line) => {
|
|
78
|
+
if (/^\[project\]\s*$/.test(line) || /^\[tool\.poetry\]\s*$/.test(line)) inProject = true
|
|
79
|
+
else if (/^\[/.test(line)) inProject = false
|
|
80
|
+
if (inProject && /^version\s*=/.test(line)) {
|
|
81
|
+
replaced = true
|
|
82
|
+
return `version = "${version}"`
|
|
83
|
+
}
|
|
84
|
+
return line
|
|
85
|
+
})
|
|
86
|
+
if (!replaced) {
|
|
87
|
+
const err = new Error('pyproject.toml has no [project]/[tool.poetry] version')
|
|
88
|
+
err.exitCode = 1
|
|
89
|
+
throw err
|
|
90
|
+
}
|
|
91
|
+
return out.join('\n')
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
export function cutDistributionVersion({ version, cwd }) {
|
|
95
|
+
const script = join(cwd, 'skills/distribution/scripts/distribution.mjs')
|
|
96
|
+
const result = spawnSync(process.execPath, [script, 'version-cut', '--version', version, '--repo-root', cwd, '--json'], {
|
|
97
|
+
cwd,
|
|
98
|
+
encoding: 'utf8',
|
|
99
|
+
})
|
|
100
|
+
if (result.status !== 0) {
|
|
101
|
+
const error = new Error(result.stderr.trim() || 'distribution version cut failed')
|
|
102
|
+
error.exitCode = result.status || 1
|
|
103
|
+
throw error
|
|
104
|
+
}
|
|
105
|
+
const parsed = JSON.parse(result.stdout)
|
|
106
|
+
if (!Array.isArray(parsed.changed) || parsed.changed.length === 0) {
|
|
107
|
+
const error = new Error('distribution version cut returned no changed files')
|
|
108
|
+
error.exitCode = 1
|
|
109
|
+
throw error
|
|
110
|
+
}
|
|
111
|
+
return parsed.changed
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
export function applyRelease({
|
|
115
|
+
version,
|
|
116
|
+
date,
|
|
117
|
+
cwd = process.cwd(),
|
|
118
|
+
changelogSection = null,
|
|
119
|
+
cutDistribution = cutDistributionVersion,
|
|
120
|
+
now = new Date(),
|
|
121
|
+
} = {}) {
|
|
122
|
+
if (!parseSemver(version)) {
|
|
123
|
+
const err = new Error('usage: apply.mjs --version <x.y.z> --date <YYYY-MM-DD> --changelog-section - [--json]')
|
|
124
|
+
err.exitCode = 2
|
|
125
|
+
throw err
|
|
126
|
+
}
|
|
127
|
+
if (typeof changelogSection !== 'string' || changelogSection.trim() === '') {
|
|
128
|
+
const err = new Error('apply.mjs requires the recorded plan changelog via --changelog-section -')
|
|
129
|
+
err.exitCode = 2
|
|
130
|
+
throw err
|
|
131
|
+
}
|
|
132
|
+
const stamp = date || now.toISOString().slice(0, 10)
|
|
133
|
+
const files = discoverVersionFiles(cwd)
|
|
134
|
+
const changed = []
|
|
135
|
+
const changelogPath = join(cwd, 'CHANGELOG.md')
|
|
136
|
+
const previous = existsSync(changelogPath) ? readFileSync(changelogPath, 'utf8') : ''
|
|
137
|
+
writeFileSync(changelogPath, insertChangelog(previous, { version, date: stamp, section: changelogSection }))
|
|
138
|
+
changed.push('CHANGELOG.md')
|
|
139
|
+
|
|
140
|
+
if (files.includes(DISTRIBUTION_MANIFEST)) {
|
|
141
|
+
changed.push(...cutDistribution({ version, cwd }))
|
|
142
|
+
return { version, date: stamp, changed: [...new Set(changed)] }
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
if (files.includes('package.json')) {
|
|
146
|
+
writeFileSync(join(cwd, 'package.json'), bumpPackageJson(readFileSync(join(cwd, 'package.json'), 'utf8'), version))
|
|
147
|
+
changed.push('package.json')
|
|
148
|
+
}
|
|
149
|
+
if (files.includes('package-lock.json')) {
|
|
150
|
+
writeFileSync(join(cwd, 'package-lock.json'), bumpPackageLock(readFileSync(join(cwd, 'package-lock.json'), 'utf8'), version))
|
|
151
|
+
changed.push('package-lock.json')
|
|
152
|
+
}
|
|
153
|
+
if (files.includes('pyproject.toml')) {
|
|
154
|
+
writeFileSync(join(cwd, 'pyproject.toml'), bumpPyproject(readFileSync(join(cwd, 'pyproject.toml'), 'utf8'), version))
|
|
155
|
+
changed.push('pyproject.toml')
|
|
156
|
+
}
|
|
157
|
+
if (files.includes('VERSION')) {
|
|
158
|
+
writeFileSync(join(cwd, 'VERSION'), `${version}\n`)
|
|
159
|
+
changed.push('VERSION')
|
|
160
|
+
}
|
|
161
|
+
return { version, date: stamp, changed }
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
function readStdin() {
|
|
165
|
+
return readFileSync(0, 'utf8')
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
function parseArgs(argv) {
|
|
169
|
+
const opts = { json: false, version: null, date: null, changelogSection: null }
|
|
170
|
+
for (let i = 0; i < argv.length; i += 1) {
|
|
171
|
+
const arg = argv[i]
|
|
172
|
+
if (arg === '--json') opts.json = true
|
|
173
|
+
else if (arg === '--version') opts.version = argv[++i]
|
|
174
|
+
else if (arg === '--date') opts.date = argv[++i]
|
|
175
|
+
else if (arg === '--changelog-section') opts.changelogFrom = argv[++i]
|
|
176
|
+
else if (arg === '--help' || arg === '-h') opts.help = true
|
|
177
|
+
else {
|
|
178
|
+
const err = new Error(`unknown argument: ${arg}`)
|
|
179
|
+
err.exitCode = 2
|
|
180
|
+
throw err
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
if (opts.help) return opts
|
|
184
|
+
if (!opts.version || !opts.date || !opts.changelogFrom) {
|
|
185
|
+
const err = new Error('usage: apply.mjs --version <x.y.z> --date <YYYY-MM-DD> --changelog-section - [--json]')
|
|
186
|
+
err.exitCode = 2
|
|
187
|
+
throw err
|
|
188
|
+
}
|
|
189
|
+
if (opts.changelogFrom === '-') opts.changelogSection = readStdin()
|
|
190
|
+
else if (opts.changelogFrom) opts.changelogSection = opts.changelogFrom
|
|
191
|
+
return opts
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
export function main(argv = process.argv.slice(2)) {
|
|
195
|
+
const opts = parseArgs(argv)
|
|
196
|
+
if (opts.help) {
|
|
197
|
+
process.stdout.write('apply.mjs --version <x.y.z> --date <YYYY-MM-DD> --changelog-section - [--json]\n')
|
|
198
|
+
return 0
|
|
199
|
+
}
|
|
200
|
+
const result = applyRelease(opts)
|
|
201
|
+
process.stdout.write(opts.json ? `${JSON.stringify(result, null, 2)}\n` : `${result.changed.join('\n')}\n`)
|
|
202
|
+
return 0
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
if (isMainModule(import.meta.url)) {
|
|
206
|
+
try {
|
|
207
|
+
process.exitCode = main()
|
|
208
|
+
} catch (error) {
|
|
209
|
+
process.stderr.write(`${error.message}\n`)
|
|
210
|
+
process.exitCode = error.exitCode || 1
|
|
211
|
+
}
|
|
212
|
+
}
|