@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.
Files changed (633) hide show
  1. package/README.md +30 -2
  2. package/bin/cli.mjs +14 -0
  3. package/bin/select-core.mjs +172 -0
  4. package/package.json +146 -4
  5. package/skills/app-dev/airflow/LICENSE +3 -0
  6. package/skills/app-dev/airflow/SKILL.md +199 -0
  7. package/skills/app-dev/airflow/release-check.mjs +93 -0
  8. package/skills/app-dev/android-foundation/LICENSE +3 -0
  9. package/skills/app-dev/android-foundation/SKILL.md +192 -0
  10. package/skills/app-dev/android-foundation/assets/android-ci-job.yml +217 -0
  11. package/skills/app-dev/android-foundation/references/ci.md +87 -0
  12. package/skills/app-dev/android-foundation/references/gotchas.md +221 -0
  13. package/skills/app-dev/android-foundation/references/setup.md +164 -0
  14. package/skills/app-dev/android-foundation/release-check.mjs +93 -0
  15. package/skills/app-dev/android-foundation/scripts/device-run.sh +176 -0
  16. package/skills/app-dev/android-foundation/scripts/device-run.test.mjs +172 -0
  17. package/skills/app-dev/app-debug/LICENSE +3 -0
  18. package/skills/app-dev/app-debug/SKILL.md +110 -0
  19. package/skills/app-dev/app-debug/references/common-errors.md +128 -0
  20. package/skills/app-dev/app-debug/release-check.mjs +93 -0
  21. package/skills/app-dev/better-auth/LICENSE +3 -0
  22. package/skills/app-dev/better-auth/SKILL.md +598 -0
  23. package/skills/app-dev/better-auth/references/feishu-api.md +270 -0
  24. package/skills/app-dev/better-auth/release-check.mjs +93 -0
  25. package/skills/app-dev/data-catalog/LICENSE +3 -0
  26. package/skills/app-dev/data-catalog/SKILL.md +204 -0
  27. package/skills/app-dev/data-catalog/agents/openai.yaml +3 -0
  28. package/skills/app-dev/data-catalog/references/data-catalog-conventions.md +75 -0
  29. package/skills/app-dev/data-catalog/references/field-definitions.md +116 -0
  30. package/skills/app-dev/data-catalog/references/format.md +121 -0
  31. package/skills/app-dev/data-catalog/release-check.mjs +93 -0
  32. package/skills/app-dev/data-catalog/scripts/data-catalog.test.mjs +36 -0
  33. package/skills/app-dev/data-catalog/scripts/data_catalog.py +1392 -0
  34. package/skills/app-dev/data-catalog/scripts/persist-conventions-core.mjs +117 -0
  35. package/skills/app-dev/data-catalog/scripts/persist-conventions.mjs +17 -0
  36. package/skills/app-dev/data-catalog/scripts/test_data_catalog.py +571 -0
  37. package/skills/app-dev/ios-foundation/LICENSE +3 -0
  38. package/skills/app-dev/ios-foundation/SKILL.md +184 -0
  39. package/skills/app-dev/ios-foundation/references/setup.md +243 -0
  40. package/skills/app-dev/ios-foundation/release-check.mjs +93 -0
  41. package/skills/app-dev/monorepo/LICENSE +3 -0
  42. package/skills/app-dev/monorepo/SKILL.md +462 -0
  43. package/skills/app-dev/monorepo/release-check.mjs +93 -0
  44. package/skills/app-dev/nextjs-fullstack/LICENSE +3 -0
  45. package/skills/app-dev/nextjs-fullstack/SKILL.md +211 -0
  46. package/skills/app-dev/nextjs-fullstack/conventions.md +318 -0
  47. package/skills/app-dev/nextjs-fullstack/frontend-conventions.md +61 -0
  48. package/skills/app-dev/nextjs-fullstack/nextjs16.md +287 -0
  49. package/skills/app-dev/nextjs-fullstack/release-check.mjs +93 -0
  50. package/skills/app-dev/nextjs-fullstack/server-actions.md +409 -0
  51. package/skills/app-dev/prisma-setup/LICENSE +3 -0
  52. package/skills/app-dev/prisma-setup/SKILL.md +181 -0
  53. package/skills/app-dev/prisma-setup/nextjs.md +258 -0
  54. package/skills/app-dev/prisma-setup/release-check.mjs +93 -0
  55. package/skills/app-dev/prisma-setup/turborepo.md +301 -0
  56. package/skills/app-dev/pyspark/LICENSE +3 -0
  57. package/skills/app-dev/pyspark/SKILL.md +127 -0
  58. package/skills/app-dev/pyspark/assets/templates/etl.py +748 -0
  59. package/skills/app-dev/pyspark/assets/templates/utils/__init__.py +1 -0
  60. package/skills/app-dev/pyspark/assets/templates/utils/hudi_metadata.py +14 -0
  61. package/skills/app-dev/pyspark/references/diagnosis-and-profiling.md +169 -0
  62. package/skills/app-dev/pyspark/references/etl-contract.md +129 -0
  63. package/skills/app-dev/pyspark/references/production-validation.md +131 -0
  64. package/skills/app-dev/pyspark/references/reconciliation.md +38 -0
  65. package/skills/app-dev/pyspark/references/transformation-design.md +190 -0
  66. package/skills/app-dev/pyspark/references/velocity-feature-calculation.md +193 -0
  67. package/skills/app-dev/pyspark/release-check.mjs +93 -0
  68. package/skills/app-dev/pyspark/scripts/spark_eventlog_summary.py +223 -0
  69. package/skills/app-dev/python-backend/LICENSE +3 -0
  70. package/skills/app-dev/python-backend/SKILL.md +325 -0
  71. package/skills/app-dev/python-backend/assets/uv-install.sh +48 -0
  72. package/skills/app-dev/python-backend/references/uv-installs.md +83 -0
  73. package/skills/app-dev/python-backend/release-check.mjs +93 -0
  74. package/skills/app-dev/shadcn/LICENSE +3 -0
  75. package/skills/app-dev/shadcn/SKILL.md +120 -0
  76. package/skills/app-dev/shadcn/assets/shadcn-small.png +0 -0
  77. package/skills/app-dev/shadcn/assets/shadcn.png +0 -0
  78. package/skills/app-dev/shadcn/cli.md +411 -0
  79. package/skills/app-dev/shadcn/customization.md +224 -0
  80. package/skills/app-dev/shadcn/mcp.md +101 -0
  81. package/skills/app-dev/shadcn/release-check.mjs +93 -0
  82. package/skills/app-dev/shadcn/rules/base-vs-radix.md +323 -0
  83. package/skills/app-dev/shadcn/rules/component-selection.md +67 -0
  84. package/skills/app-dev/shadcn/rules/composition.md +195 -0
  85. package/skills/app-dev/shadcn/rules/data-table.md +201 -0
  86. package/skills/app-dev/shadcn/rules/forms.md +255 -0
  87. package/skills/app-dev/shadcn/rules/icons.md +103 -0
  88. package/skills/app-dev/shadcn/rules/styling.md +167 -0
  89. package/skills/app-dev/zod-v4/LICENSE +3 -0
  90. package/skills/app-dev/zod-v4/SKILL.md +286 -0
  91. package/skills/app-dev/zod-v4/release-check.mjs +93 -0
  92. package/skills/cicd/cloud-build/LICENSE +3 -0
  93. package/skills/cicd/cloud-build/SKILL.md +707 -0
  94. package/skills/cicd/cloud-build/release-check.mjs +93 -0
  95. package/skills/cicd/cloud-debug/LICENSE +3 -0
  96. package/skills/cicd/cloud-debug/SKILL.md +315 -0
  97. package/skills/cicd/cloud-debug/references/build-failures.md +238 -0
  98. package/skills/cicd/cloud-debug/references/deploy-failures.md +376 -0
  99. package/skills/cicd/cloud-debug/references/pipeline-failures.md +378 -0
  100. package/skills/cicd/cloud-debug/release-check.mjs +93 -0
  101. package/skills/cicd/cloud-deploy/LICENSE +3 -0
  102. package/skills/cicd/cloud-deploy/SKILL.md +230 -0
  103. package/skills/cicd/cloud-deploy/references/config-templates.md +257 -0
  104. package/skills/cicd/cloud-deploy/release-check.mjs +93 -0
  105. package/skills/cicd/docker/LICENSE +3 -0
  106. package/skills/cicd/docker/SKILL.md +151 -0
  107. package/skills/cicd/docker/release-check.mjs +93 -0
  108. package/skills/cicd/github-actions/LICENSE +3 -0
  109. package/skills/cicd/github-actions/SKILL.md +111 -0
  110. package/skills/cicd/github-actions/references/audit-profile-optimize.md +150 -0
  111. package/skills/cicd/github-actions/references/ci-case-studies.md +141 -0
  112. package/skills/cicd/github-actions/references/conditional-ci.md +214 -0
  113. package/skills/cicd/github-actions/references/debugging.md +13 -0
  114. package/skills/cicd/github-actions/references/pipeline.md +87 -0
  115. package/skills/cicd/github-actions/references/post-deploy-and-publishing.md +33 -0
  116. package/skills/cicd/github-actions/references/runners.md +253 -0
  117. package/skills/cicd/github-actions/references/security.md +29 -0
  118. package/skills/cicd/github-actions/references/speed-and-audit.md +115 -0
  119. package/skills/cicd/github-actions/references/two-pass-reading.md +92 -0
  120. package/skills/cicd/github-actions/release-check.mjs +93 -0
  121. package/skills/cicd/github-actions/scripts/ci-run-audit-core.mjs +612 -0
  122. package/skills/cicd/github-actions/scripts/ci-run-audit.mjs +4 -0
  123. package/skills/cicd/github-actions/scripts/ci-run-audit.test.mjs +637 -0
  124. package/skills/cicd/github-flow/LICENSE +3 -0
  125. package/skills/cicd/github-flow/SKILL.md +123 -0
  126. package/skills/cicd/github-flow/references/ci-conventions.md +14 -0
  127. package/skills/cicd/github-flow/release-check.mjs +93 -0
  128. package/skills/cicd/github-flow/scripts/flow-core.mjs +105 -0
  129. package/skills/cicd/github-flow/scripts/flow.mjs +81 -0
  130. package/skills/cicd/github-flow/scripts/flow.test.mjs +114 -0
  131. package/skills/cicd/github-flow/scripts/persist-conventions-core.mjs +117 -0
  132. package/skills/cicd/github-flow/scripts/persist-conventions.mjs +49 -0
  133. package/skills/cicd/github-flow/scripts/persist-conventions.test.mjs +108 -0
  134. package/skills/cicd/google-cloud/LICENSE +3 -0
  135. package/skills/cicd/google-cloud/SKILL.md +119 -0
  136. package/skills/cicd/google-cloud/references/gcs.md +469 -0
  137. package/skills/cicd/google-cloud/references/iam.md +451 -0
  138. package/skills/cicd/google-cloud/references/project.md +349 -0
  139. package/skills/cicd/google-cloud/references/secrets.md +336 -0
  140. package/skills/cicd/google-cloud/references/vpc.md +312 -0
  141. package/skills/cicd/google-cloud/release-check.mjs +93 -0
  142. package/skills/cicd/google-cloud/scripts/create-sa.sh +36 -0
  143. package/skills/cicd/google-cloud/scripts/gcp-config.sh +31 -0
  144. package/skills/cicd/google-cloud/scripts/grant-iap.sh +41 -0
  145. package/skills/cicd/google-cloud/scripts/setup-secrets.sh +48 -0
  146. package/skills/cicd/mergify/LICENSE +3 -0
  147. package/skills/cicd/mergify/SKILL.md +102 -0
  148. package/skills/cicd/mergify/assets/templates/mergify.yml +215 -0
  149. package/skills/cicd/mergify/assets/templates/ruleset.json +46 -0
  150. package/skills/cicd/mergify/references/branch-protection.md +282 -0
  151. package/skills/cicd/mergify/references/configuration.md +274 -0
  152. package/skills/cicd/mergify/references/diagnosis.md +109 -0
  153. package/skills/cicd/mergify/references/stacks.md +84 -0
  154. package/skills/cicd/mergify/references/traps.md +119 -0
  155. package/skills/cicd/mergify/references/watch-contract.md +274 -0
  156. package/skills/cicd/mergify/release-check.mjs +93 -0
  157. package/skills/cicd/mergify/scripts/audit-core.mjs +208 -0
  158. package/skills/cicd/mergify/scripts/audit.mjs +4 -0
  159. package/skills/cicd/mergify/scripts/audit.test.mjs +201 -0
  160. package/skills/cicd/mergify/scripts/entrypoints.test.mjs +106 -0
  161. package/skills/cicd/mergify/scripts/pr-620-mergify-comments.fixture.json +30 -0
  162. package/skills/cicd/mergify/scripts/stack-push-core.mjs +258 -0
  163. package/skills/cicd/mergify/scripts/stack-push.mjs +4 -0
  164. package/skills/cicd/mergify/scripts/stack-push.test.mjs +233 -0
  165. package/skills/cicd/mergify/scripts/watch-pr-delivery-core.mjs +1065 -0
  166. package/skills/cicd/mergify/scripts/watch-pr-delivery.mjs +4 -0
  167. package/skills/cicd/mergify/scripts/watch-pr-delivery.test.mjs +1826 -0
  168. package/skills/cicd/podman/LICENSE +3 -0
  169. package/skills/cicd/podman/SKILL.md +71 -0
  170. package/skills/cicd/podman/agents/openai.yaml +4 -0
  171. package/skills/cicd/podman/assets/templates/podman-compose-socket-directory.yml +6 -0
  172. package/skills/cicd/podman/assets/templates/podman-service-override.conf +3 -0
  173. package/skills/cicd/podman/references/compose-compatibility.md +70 -0
  174. package/skills/cicd/podman/references/networking-and-ports.md +74 -0
  175. package/skills/cicd/podman/references/rootless-services-and-sockets.md +156 -0
  176. package/skills/cicd/podman/references/troubleshooting.md +98 -0
  177. package/skills/cicd/podman/release-check.mjs +93 -0
  178. package/skills/content/article-review/LICENSE +3 -0
  179. package/skills/content/article-review/SKILL.md +66 -0
  180. package/skills/content/article-review/references/report-format.md +68 -0
  181. package/skills/content/article-review/references/template-guide.md +79 -0
  182. package/skills/content/article-review/references/template-wechat-payments.md +125 -0
  183. package/skills/content/article-review/release-check.mjs +93 -0
  184. package/skills/content/article-to-image/LICENSE +3 -0
  185. package/skills/content/article-to-image/SKILL.md +91 -0
  186. package/skills/content/article-to-image/references/formats.md +53 -0
  187. package/skills/content/article-to-image/release-check.mjs +93 -0
  188. package/skills/content/flowchart-svg/LICENSE +3 -0
  189. package/skills/content/flowchart-svg/SKILL.md +43 -0
  190. package/skills/content/flowchart-svg/release-check.mjs +93 -0
  191. package/skills/content/flowchart-svg/scripts/export_png.sh +8 -0
  192. package/skills/content/image-gen/LICENSE +3 -0
  193. package/skills/content/image-gen/SKILL.md +192 -0
  194. package/skills/content/image-gen/release-check.mjs +93 -0
  195. package/skills/content/image-gen/scripts/credentials.mjs +217 -0
  196. package/skills/content/image-gen/scripts/credentials.test.mjs +212 -0
  197. package/skills/content/image-gen/scripts/generate.mjs +240 -0
  198. package/skills/content/image-gen/scripts/options.mjs +293 -0
  199. package/skills/content/image-gen/scripts/options.test.mjs +245 -0
  200. package/skills/content/mermaid/LICENSE +3 -0
  201. package/skills/content/mermaid/SKILL.md +635 -0
  202. package/skills/content/mermaid/release-check.mjs +93 -0
  203. package/skills/content/wechat-article-writer/LICENSE +3 -0
  204. package/skills/content/wechat-article-writer/SKILL.md +92 -0
  205. package/skills/content/wechat-article-writer/references/style-selector.md +133 -0
  206. package/skills/content/wechat-article-writer/references/writing-rules.md +152 -0
  207. package/skills/content/wechat-article-writer/release-check.mjs +93 -0
  208. package/skills/content/wechat-article-writer/templates/wechat-comparison.md +52 -0
  209. package/skills/content/wechat-article-writer/templates/wechat-howto.md +51 -0
  210. package/skills/content/wechat-article-writer/templates/wechat-insight.md +50 -0
  211. package/skills/content/wechat-article-writer/templates/wechat-pitfall.md +52 -0
  212. package/skills/content/wechat-publisher/LICENSE +3 -0
  213. package/skills/content/wechat-publisher/SKILL.md +171 -0
  214. package/skills/content/wechat-publisher/references/api.md +105 -0
  215. package/skills/content/wechat-publisher/references/layout-rules.md +57 -0
  216. package/skills/content/wechat-publisher/references/wechat-safe-template.html +86 -0
  217. package/skills/content/wechat-publisher/release-check.mjs +93 -0
  218. package/skills/content/wechat-publisher/scripts/md_to_wechat_html.py +194 -0
  219. package/skills/content/wechat-publisher/scripts/publish.py +239 -0
  220. package/skills/content/wechat-search/LICENSE +3 -0
  221. package/skills/content/wechat-search/SKILL.md +211 -0
  222. package/skills/content/wechat-search/release-check.mjs +93 -0
  223. package/skills/content/wechat-search/scripts/start-chrome.sh +83 -0
  224. package/skills/content/xai-search/LICENSE +3 -0
  225. package/skills/content/xai-search/SKILL.md +79 -0
  226. package/skills/content/xai-search/release-check.mjs +93 -0
  227. package/skills/content/xai-search/scripts/xai_search.sh +187 -0
  228. package/skills/content/xai-search/tests/smoke_test.sh +36 -0
  229. package/skills/core/distill-writing/LICENSE +3 -0
  230. package/skills/core/distill-writing/SKILL.md +74 -0
  231. package/skills/core/distill-writing/references/extraction.md +95 -0
  232. package/skills/core/distill-writing/references/updating.md +46 -0
  233. package/skills/core/distill-writing/release-check.mjs +93 -0
  234. package/skills/core/doc-to-md/LICENSE +3 -0
  235. package/skills/core/doc-to-md/SKILL.md +78 -0
  236. package/skills/core/doc-to-md/release-check.mjs +93 -0
  237. package/skills/core/doc-to-md/scripts/convert.py +157 -0
  238. package/skills/core/editorial-review/LICENSE +3 -0
  239. package/skills/core/editorial-review/SKILL.md +79 -0
  240. package/skills/core/editorial-review/references/checklist.md +94 -0
  241. package/skills/core/editorial-review/release-check.mjs +93 -0
  242. package/skills/core/house-style/LICENSE +3 -0
  243. package/skills/core/house-style/SKILL.md +33 -0
  244. package/skills/core/house-style/references/defaults.md +66 -0
  245. package/skills/core/house-style/references/rules.md +267 -0
  246. package/skills/core/house-style/references/sources.md +27 -0
  247. package/skills/core/house-style/references/style-en.md +131 -0
  248. package/skills/core/house-style/references/style-zh.md +141 -0
  249. package/skills/core/house-style/references/terminology-zh.md +223 -0
  250. package/skills/core/house-style/release-check.mjs +93 -0
  251. package/skills/core/house-style/templates/brd.md +103 -0
  252. package/skills/core/house-style/templates/commercial-proposal.md +93 -0
  253. package/skills/core/house-style/templates/compliance-policy.md +109 -0
  254. package/skills/core/house-style/templates/gap-analysis.md +105 -0
  255. package/skills/core/house-style/templates/general.md +63 -0
  256. package/skills/core/house-style/templates/integration-guide.md +98 -0
  257. package/skills/core/house-style/templates/prd.md +81 -0
  258. package/skills/core/house-style/templates/risk-operations-procedure.md +94 -0
  259. package/skills/core/house-style/templates/technical-spec.md +96 -0
  260. package/skills/core/polish-cn/LICENSE +3 -0
  261. package/skills/core/polish-cn/SKILL.md +102 -0
  262. package/skills/core/polish-cn/references/brief.md +93 -0
  263. package/skills/core/polish-cn/references/models.md +76 -0
  264. package/skills/core/polish-cn/release-check.mjs +93 -0
  265. package/skills/core/polish-cn/scripts/polish-cn.test.mjs +244 -0
  266. package/skills/core/polish-cn/scripts/polish_blocks.py +489 -0
  267. package/skills/core/reg-parser/LICENSE +3 -0
  268. package/skills/core/reg-parser/SKILL.md +212 -0
  269. package/skills/core/reg-parser/references/checklist-schema.md +223 -0
  270. package/skills/core/reg-parser/references/checklists/hk-amlo-checklist.json +1306 -0
  271. package/skills/core/reg-parser/references/checklists/hk-amlo-checklist.md +469 -0
  272. package/skills/core/reg-parser/references/checklists/hk-fi-corporate-onboarding-cdd-checklist.json +634 -0
  273. package/skills/core/reg-parser/references/checklists/hk-fi-corporate-onboarding-cdd-checklist.md +233 -0
  274. package/skills/core/reg-parser/references/checklists/hk-mso-guideline-checklist.json +2194 -0
  275. package/skills/core/reg-parser/references/checklists/hk-mso-guideline-checklist.md +771 -0
  276. package/skills/core/reg-parser/references/checklists/kyc-aml-checklist.md +258 -0
  277. package/skills/core/reg-parser/references/checklists/visa-vars-checklist.md +1058 -0
  278. package/skills/core/reg-parser/references/mandates/hk-amlo-cap615.md +389 -0
  279. package/skills/core/reg-parser/references/mandates/visa-vars.md +205 -0
  280. package/skills/core/reg-parser/release-check.mjs +93 -0
  281. package/skills/core/reg-parser/scripts/compare_checklist.py +230 -0
  282. package/skills/core/reg-parser/scripts/dump_checklist.py +361 -0
  283. package/skills/core/reg-parser/scripts/preprocess-mandate.sh +187 -0
  284. package/skills/core/reg-parser/scripts/reg-parser.test.mjs +165 -0
  285. package/skills/core/reg-parser/scripts/test_quarantine.sh +105 -0
  286. package/skills/core/reg-parser/scripts/validate_checklist.py +563 -0
  287. package/skills/core/reg-parser/scripts/validate_mandate.py +273 -0
  288. package/skills/core/terminology/LICENSE +3 -0
  289. package/skills/core/terminology/SKILL.md +62 -0
  290. package/skills/core/terminology/references/format.md +50 -0
  291. package/skills/core/terminology/references/init.md +32 -0
  292. package/skills/core/terminology/release-check.mjs +93 -0
  293. package/skills/core/write-doc/LICENSE +3 -0
  294. package/skills/core/write-doc/SKILL.md +141 -0
  295. package/skills/core/write-doc/references/bilingual.md +60 -0
  296. package/skills/core/write-doc/release-check.mjs +93 -0
  297. package/skills/engineering/better-review/LICENSE +3 -0
  298. package/skills/engineering/better-review/SKILL.md +249 -0
  299. package/skills/engineering/better-review/agents/openai.yaml +9 -0
  300. package/skills/engineering/better-review/references/domain-hazards.md +53 -0
  301. package/skills/engineering/better-review/references/passes.md +147 -0
  302. package/skills/engineering/better-review/references/result.md +151 -0
  303. package/skills/engineering/better-review/release-check.mjs +93 -0
  304. package/skills/engineering/better-review/scripts/pr-context.mjs +212 -0
  305. package/skills/engineering/better-review/scripts/pr-context.test.mjs +168 -0
  306. package/skills/engineering/better-review/scripts/rereview-scope.mjs +503 -0
  307. package/skills/engineering/better-review/scripts/rereview-scope.test.mjs +587 -0
  308. package/skills/engineering/better-review/scripts/scan-diff.mjs +365 -0
  309. package/skills/engineering/better-review/scripts/scan-diff.test.mjs +414 -0
  310. package/skills/engineering/better-review/scripts/vendor-sync.test.mjs +96 -0
  311. package/skills/engineering/e2e-test/LICENSE +3 -0
  312. package/skills/engineering/e2e-test/SKILL.md +98 -0
  313. package/skills/engineering/e2e-test/assets/ci-gates.cloudbuild.yaml +24 -0
  314. package/skills/engineering/e2e-test/references/authoring/auth-flows.md +159 -0
  315. package/skills/engineering/e2e-test/references/authoring/playwright-config.md +73 -0
  316. package/skills/engineering/e2e-test/references/authoring/playwright-patterns.md +144 -0
  317. package/skills/engineering/e2e-test/references/ci-integration.md +25 -0
  318. package/skills/engineering/e2e-test/references/ci-playwright-container.md +290 -0
  319. package/skills/engineering/e2e-test/references/presentation-sweep.md +104 -0
  320. package/skills/engineering/e2e-test/references/reviewing.md +41 -0
  321. package/skills/engineering/e2e-test/references/route-manifest.md +51 -0
  322. package/skills/engineering/e2e-test/release-check.mjs +93 -0
  323. package/skills/engineering/e2e-test/scripts/detect-routes-nextjs.mjs +200 -0
  324. package/skills/engineering/e2e-test/scripts/presentation-checks.mjs +171 -0
  325. package/skills/engineering/e2e-test/scripts/presentation-checks.test.mjs +106 -0
  326. package/skills/engineering/e2e-test/scripts/presentation-perceivability.mjs +179 -0
  327. package/skills/engineering/e2e-test/scripts/presentation-perceivability.test.mjs +117 -0
  328. package/skills/engineering/e2e-test/scripts/presentation-reachability.mjs +154 -0
  329. package/skills/engineering/e2e-test/scripts/presentation-reachability.test.mjs +69 -0
  330. package/skills/engineering/e2e-test/scripts/presentation-render-health.mjs +141 -0
  331. package/skills/engineering/e2e-test/scripts/presentation-render-health.test.mjs +98 -0
  332. package/skills/engineering/e2e-test/scripts/presentation-sweep.mjs +147 -0
  333. package/skills/engineering/e2e-test/scripts/presentation-sweep.test.mjs +71 -0
  334. package/skills/engineering/e2e-test/scripts/presentation-temporal.mjs +127 -0
  335. package/skills/engineering/e2e-test/scripts/presentation-temporal.test.mjs +59 -0
  336. package/skills/engineering/e2e-test/scripts/project-route-manifest.mjs +82 -0
  337. package/skills/engineering/e2e-test/scripts/project-route-manifest.test.mjs +76 -0
  338. package/skills/engineering/e2e-test/scripts/validate-manifest.mjs +106 -0
  339. package/skills/engineering/engineering-runtime/LICENSE +3 -0
  340. package/skills/engineering/engineering-runtime/SKILL.md +11 -0
  341. package/skills/engineering/engineering-runtime/agents/openai.yaml +6 -0
  342. package/skills/engineering/engineering-runtime/coherence/workflow.json +597 -0
  343. package/skills/engineering/engineering-runtime/engineering-runtime.test.mjs +68 -0
  344. package/skills/engineering/engineering-runtime/release-check.mjs +93 -0
  345. package/skills/engineering/engineering-runtime/scripts/exact-head-artifact.mjs +131 -0
  346. package/skills/engineering/engineering-runtime/scripts/head-check-set.mjs +398 -0
  347. package/skills/engineering/engineering-runtime/scripts/invocation-policy.mjs +187 -0
  348. package/skills/engineering/engineering-runtime/scripts/invocation-policy.test.mjs +95 -0
  349. package/skills/engineering/engineering-runtime/scripts/main-module.mjs +79 -0
  350. package/skills/engineering/engineering-runtime/scripts/main-module.test.mjs +288 -0
  351. package/skills/engineering/engineering-runtime/scripts/mergify-yaml.mjs +11 -0
  352. package/skills/engineering/engineering-runtime/scripts/package-lock.json +43 -0
  353. package/skills/engineering/engineering-runtime/scripts/package.json +10 -0
  354. package/skills/engineering/engineering-runtime/scripts/required-check-plan.mjs +223 -0
  355. package/skills/engineering/engineering-runtime/scripts/required-check-plan.test.mjs +96 -0
  356. package/skills/engineering/engineering-runtime/scripts/review-completion.mjs +56 -0
  357. package/skills/engineering/engineering-runtime/scripts/workflow-coherence.mjs +595 -0
  358. package/skills/engineering/engineering-runtime/scripts/workflow-policy.mjs +189 -0
  359. package/skills/engineering/engineering-runtime/scripts/yaml-mapping.mjs +18 -0
  360. package/skills/engineering/ensure-coverage/LICENSE +3 -0
  361. package/skills/engineering/ensure-coverage/SKILL.md +129 -0
  362. package/skills/engineering/ensure-coverage/references/breadth/coverage-ledger.md +92 -0
  363. package/skills/engineering/ensure-coverage/references/breadth/inventory-contract.md +85 -0
  364. package/skills/engineering/ensure-coverage/references/breadth/surface-baseline.md +44 -0
  365. package/skills/engineering/ensure-coverage/references/breadth/surface-discovery.md +16 -0
  366. package/skills/engineering/ensure-coverage/references/depth/characterization.md +68 -0
  367. package/skills/engineering/ensure-coverage/references/depth/coverage.config.example.json +19 -0
  368. package/skills/engineering/ensure-coverage/references/depth/grading.md +35 -0
  369. package/skills/engineering/ensure-coverage/references/depth/mock-policy.md +57 -0
  370. package/skills/engineering/ensure-coverage/references/depth/test-smells.md +39 -0
  371. package/skills/engineering/ensure-coverage/references/enforcement/ci-contract.md +44 -0
  372. package/skills/engineering/ensure-coverage/references/examples/coverage-ledger.md +110 -0
  373. package/skills/engineering/ensure-coverage/references/examples/refund-flow.md +35 -0
  374. package/skills/engineering/ensure-coverage/references/presentation/axis.md +64 -0
  375. package/skills/engineering/ensure-coverage/references/process/audit-mode.md +27 -0
  376. package/skills/engineering/ensure-coverage/references/process/output-template.md +139 -0
  377. package/skills/engineering/ensure-coverage/references/process/test-strategy.md +56 -0
  378. package/skills/engineering/ensure-coverage/release-check.mjs +93 -0
  379. package/skills/engineering/ensure-coverage/schemas/coverage-config.schema.json +67 -0
  380. package/skills/engineering/ensure-coverage/schemas/coverage-file.schema.json +140 -0
  381. package/skills/engineering/ensure-coverage/scripts/README.md +99 -0
  382. package/skills/engineering/ensure-coverage/scripts/adapters/nextjs-inventory.mjs +182 -0
  383. package/skills/engineering/ensure-coverage/scripts/adapters/nextjs-inventory.test.mjs +96 -0
  384. package/skills/engineering/ensure-coverage/scripts/check-quarantine-expiry.mjs +105 -0
  385. package/skills/engineering/ensure-coverage/scripts/check-quarantine-expiry.test.mjs +47 -0
  386. package/skills/engineering/ensure-coverage/scripts/ci-audit.mjs +137 -0
  387. package/skills/engineering/ensure-coverage/scripts/ci-audit.test.mjs +86 -0
  388. package/skills/engineering/ensure-coverage/scripts/coverage-ledger.mjs +674 -0
  389. package/skills/engineering/ensure-coverage/scripts/coverage-ledger.test.mjs +447 -0
  390. package/skills/engineering/ensure-coverage/scripts/design-parity.mjs +591 -0
  391. package/skills/engineering/ensure-coverage/scripts/design-parity.test.mjs +552 -0
  392. package/skills/engineering/ensure-coverage/scripts/lint-tests.mjs +282 -0
  393. package/skills/engineering/ensure-coverage/scripts/lint-tests.test.mjs +289 -0
  394. package/skills/engineering/ensure-coverage/scripts/mock-policy-config.mjs +176 -0
  395. package/skills/engineering/ensure-coverage/scripts/mock-policy-config.test.mjs +119 -0
  396. package/skills/engineering/ensure-coverage/scripts/package.json +19 -0
  397. package/skills/engineering/golden-path/LICENSE +3 -0
  398. package/skills/engineering/golden-path/SKILL.md +230 -0
  399. package/skills/engineering/golden-path/agents/openai.yaml +3 -0
  400. package/skills/engineering/golden-path/assets/golden-paths.example.json +57 -0
  401. package/skills/engineering/golden-path/references/contract.md +239 -0
  402. package/skills/engineering/golden-path/references/migration.md +111 -0
  403. package/skills/engineering/golden-path/release-check.mjs +93 -0
  404. package/skills/engineering/golden-path/scripts/golden-path-core.mjs +1779 -0
  405. package/skills/engineering/golden-path/scripts/golden-path.mjs +6 -0
  406. package/skills/engineering/golden-path/scripts/golden-path.test.mjs +1457 -0
  407. package/skills/engineering/harness-runtime/LICENSE +3 -0
  408. package/skills/engineering/harness-runtime/SKILL.md +19 -0
  409. package/skills/engineering/harness-runtime/agents/openai.yaml +6 -0
  410. package/skills/engineering/harness-runtime/bin/discover-models.mjs +4 -0
  411. package/skills/engineering/harness-runtime/bin/model-catalog.mjs +4 -0
  412. package/skills/engineering/harness-runtime/contracts.md +15 -0
  413. package/skills/engineering/harness-runtime/discover-models.mjs +392 -0
  414. package/skills/engineering/harness-runtime/discover-models.test.mjs +363 -0
  415. package/skills/engineering/harness-runtime/fixtures/native-question-schemas.json +33 -0
  416. package/skills/engineering/harness-runtime/fixtures/question-responses.json +54 -0
  417. package/skills/engineering/harness-runtime/harness-runtime.test.mjs +967 -0
  418. package/skills/engineering/harness-runtime/index.mjs +767 -0
  419. package/skills/engineering/harness-runtime/model-catalog-seed.test.mjs +829 -0
  420. package/skills/engineering/harness-runtime/model-catalog.mjs +787 -0
  421. package/skills/engineering/harness-runtime/model-catalog.test.mjs +366 -0
  422. package/skills/engineering/harness-runtime/native-question-contracts.md +37 -0
  423. package/skills/engineering/harness-runtime/references/model-catalog-seed.json +408 -0
  424. package/skills/engineering/harness-runtime/references/model-catalog.md +57 -0
  425. package/skills/engineering/harness-runtime/release-check.mjs +93 -0
  426. package/skills/engineering/resolve-issues/LICENSE +3 -0
  427. package/skills/engineering/resolve-issues/SKILL.md +250 -0
  428. package/skills/engineering/resolve-issues/agents/openai.yaml +9 -0
  429. package/skills/engineering/resolve-issues/plugin-hooks.json +17 -0
  430. package/skills/engineering/resolve-issues/references/canary.md +28 -0
  431. package/skills/engineering/resolve-issues/references/ci.md +105 -0
  432. package/skills/engineering/resolve-issues/references/done.md +25 -0
  433. package/skills/engineering/resolve-issues/references/dropbox.md +90 -0
  434. package/skills/engineering/resolve-issues/references/expire.md +318 -0
  435. package/skills/engineering/resolve-issues/references/exploration.md +202 -0
  436. package/skills/engineering/resolve-issues/references/implementation.md +303 -0
  437. package/skills/engineering/resolve-issues/references/preflight.md +445 -0
  438. package/skills/engineering/resolve-issues/references/review.md +228 -0
  439. package/skills/engineering/resolve-issues/references/shared-modules.md +44 -0
  440. package/skills/engineering/resolve-issues/references/task-plan.md +264 -0
  441. package/skills/engineering/resolve-issues/release-check.mjs +93 -0
  442. package/skills/engineering/resolve-issues/scripts/cleanup-runs.mjs +364 -0
  443. package/skills/engineering/resolve-issues/scripts/cleanup-runs.test.mjs +280 -0
  444. package/skills/engineering/resolve-issues/scripts/discover-models.mjs +9 -0
  445. package/skills/engineering/resolve-issues/scripts/dropbox.mjs +473 -0
  446. package/skills/engineering/resolve-issues/scripts/dropbox.test.mjs +346 -0
  447. package/skills/engineering/resolve-issues/scripts/findings-reuse.mjs +98 -0
  448. package/skills/engineering/resolve-issues/scripts/findings-reuse.test.mjs +88 -0
  449. package/skills/engineering/resolve-issues/scripts/github-reviews.mjs +384 -0
  450. package/skills/engineering/resolve-issues/scripts/github-reviews.test.mjs +264 -0
  451. package/skills/engineering/resolve-issues/scripts/install-hooks.mjs +135 -0
  452. package/skills/engineering/resolve-issues/scripts/install-hooks.test.mjs +79 -0
  453. package/skills/engineering/resolve-issues/scripts/issue-tree.mjs +162 -0
  454. package/skills/engineering/resolve-issues/scripts/issue-tree.test.mjs +107 -0
  455. package/skills/engineering/resolve-issues/scripts/manual-invocation.test.mjs +14 -0
  456. package/skills/engineering/resolve-issues/scripts/model-catalog.mjs +9 -0
  457. package/skills/engineering/resolve-issues/scripts/next-actions-capacity.test.mjs +149 -0
  458. package/skills/engineering/resolve-issues/scripts/next-actions.mjs +856 -0
  459. package/skills/engineering/resolve-issues/scripts/next-actions.test.mjs +915 -0
  460. package/skills/engineering/resolve-issues/scripts/plan-sync.mjs +269 -0
  461. package/skills/engineering/resolve-issues/scripts/plan-sync.test.mjs +156 -0
  462. package/skills/engineering/resolve-issues/scripts/preflight-models.mjs +736 -0
  463. package/skills/engineering/resolve-issues/scripts/preflight-models.test.mjs +448 -0
  464. package/skills/engineering/resolve-issues/scripts/ready-check.mjs +185 -0
  465. package/skills/engineering/resolve-issues/scripts/ready-check.test.mjs +217 -0
  466. package/skills/engineering/resolve-issues/scripts/rehydrate.mjs +98 -0
  467. package/skills/engineering/resolve-issues/scripts/rehydrate.test.mjs +91 -0
  468. package/skills/engineering/resolve-issues/scripts/review-verdict.mjs +509 -0
  469. package/skills/engineering/resolve-issues/scripts/review-verdict.test.mjs +1060 -0
  470. package/skills/engineering/resolve-issues/scripts/size-check.mjs +492 -0
  471. package/skills/engineering/resolve-issues/scripts/size-check.test.mjs +458 -0
  472. package/skills/engineering/resolve-release/LICENSE +3 -0
  473. package/skills/engineering/resolve-release/SKILL.md +215 -0
  474. package/skills/engineering/resolve-release/agents/openai.yaml +8 -0
  475. package/skills/engineering/resolve-release/flows/cloud-run-canary.md +13 -0
  476. package/skills/engineering/resolve-release/flows/cloud-run.md +7 -0
  477. package/skills/engineering/resolve-release/flows/root-tag-npm.md +13 -0
  478. package/skills/engineering/resolve-release/flows/workspace-npm.md +22 -0
  479. package/skills/engineering/resolve-release/references/canary.md +51 -0
  480. package/skills/engineering/resolve-release/references/candidate.md +41 -0
  481. package/skills/engineering/resolve-release/references/cut.md +131 -0
  482. package/skills/engineering/resolve-release/references/dark-launch.md +66 -0
  483. package/skills/engineering/resolve-release/references/flows.md +150 -0
  484. package/skills/engineering/resolve-release/references/preflight.md +154 -0
  485. package/skills/engineering/resolve-release/references/prepared-metadata.md +260 -0
  486. package/skills/engineering/resolve-release/references/promotion.md +82 -0
  487. package/skills/engineering/resolve-release/references/publish.md +232 -0
  488. package/skills/engineering/resolve-release/references/workspace-npm.md +103 -0
  489. package/skills/engineering/resolve-release/release-check.mjs +93 -0
  490. package/skills/engineering/resolve-release/scripts/apply.mjs +212 -0
  491. package/skills/engineering/resolve-release/scripts/apply.test.mjs +99 -0
  492. package/skills/engineering/resolve-release/scripts/dark-flags.mjs +134 -0
  493. package/skills/engineering/resolve-release/scripts/dark-flags.test.mjs +100 -0
  494. package/skills/engineering/resolve-release/scripts/flow.mjs +500 -0
  495. package/skills/engineering/resolve-release/scripts/flow.test.mjs +340 -0
  496. package/skills/engineering/resolve-release/scripts/green-head.mjs +231 -0
  497. package/skills/engineering/resolve-release/scripts/green-head.test.mjs +101 -0
  498. package/skills/engineering/resolve-release/scripts/npm-version-absence.mjs +138 -0
  499. package/skills/engineering/resolve-release/scripts/npm-version-absence.test.mjs +426 -0
  500. package/skills/engineering/resolve-release/scripts/plan-npm.test.mjs +659 -0
  501. package/skills/engineering/resolve-release/scripts/plan-toml-boundary.test.mjs +317 -0
  502. package/skills/engineering/resolve-release/scripts/plan-uv.test.mjs +291 -0
  503. package/skills/engineering/resolve-release/scripts/plan.mjs +806 -0
  504. package/skills/engineering/resolve-release/scripts/plan.test.mjs +428 -0
  505. package/skills/engineering/rush-issues/LICENSE +3 -0
  506. package/skills/engineering/rush-issues/SKILL.md +58 -0
  507. package/skills/engineering/rush-issues/agents/openai.yaml +8 -0
  508. package/skills/engineering/rush-issues/rehydrate.mjs +10 -0
  509. package/skills/engineering/rush-issues/release-check.mjs +93 -0
  510. package/skills/engineering/rush-release/LICENSE +3 -0
  511. package/skills/engineering/rush-release/SKILL.md +35 -0
  512. package/skills/engineering/rush-release/agents/openai.yaml +8 -0
  513. package/skills/engineering/rush-release/release-check.mjs +93 -0
  514. package/skills/engineering/test-quality/LICENSE +3 -0
  515. package/skills/engineering/test-quality/SKILL.md +79 -0
  516. package/skills/engineering/test-quality/references/audit.md +80 -0
  517. package/skills/engineering/test-quality/references/lint.md +24 -0
  518. package/skills/engineering/test-quality/references/principles.md +143 -0
  519. package/skills/engineering/test-quality/references/testing-conventions.md +9 -0
  520. package/skills/engineering/test-quality/release-check.mjs +93 -0
  521. package/skills/engineering/test-quality/scripts/lint-tests.mjs +574 -0
  522. package/skills/engineering/test-quality/scripts/lint-tests.test.mjs +591 -0
  523. package/skills/engineering/test-quality/scripts/mock-policy-config.mjs +176 -0
  524. package/skills/engineering/test-quality/scripts/mock-policy-config.test.mjs +119 -0
  525. package/skills/engineering/test-quality/scripts/persist-conventions-core.mjs +117 -0
  526. package/skills/engineering/test-quality/scripts/persist-conventions.mjs +17 -0
  527. package/skills/engineering/test-quality/scripts/persist-conventions.test.mjs +104 -0
  528. package/skills/risk-compliance/compliance-audit/LICENSE +3 -0
  529. package/skills/risk-compliance/compliance-audit/SKILL.md +439 -0
  530. package/skills/risk-compliance/compliance-audit/references/findings-schema.md +293 -0
  531. package/skills/risk-compliance/compliance-audit/references/normalization-rules.md +45 -0
  532. package/skills/risk-compliance/compliance-audit/references/vars-checklist.md +1068 -0
  533. package/skills/risk-compliance/compliance-audit/references/vars-findings-schema.md +398 -0
  534. package/skills/risk-compliance/compliance-audit/release-check.mjs +93 -0
  535. package/skills/risk-compliance/compliance-audit/scripts/compliance-audit.test.mjs +14 -0
  536. package/skills/risk-compliance/compliance-audit/scripts/export_tracker_xlsx.py +221 -0
  537. package/skills/risk-compliance/compliance-audit/scripts/reconcile_tracker.py +458 -0
  538. package/skills/risk-compliance/compliance-audit/scripts/test_export_tracker_xlsx.py +97 -0
  539. package/skills/risk-compliance/compliance-audit/scripts/test_validate_tracker.py +157 -0
  540. package/skills/risk-compliance/compliance-audit/scripts/validate_tracker.py +829 -0
  541. package/skills/risk-compliance/contract-compare/LICENSE +3 -0
  542. package/skills/risk-compliance/contract-compare/SKILL.md +199 -0
  543. package/skills/risk-compliance/contract-compare/references/comparison-dimensions.md +209 -0
  544. package/skills/risk-compliance/contract-compare/release-check.mjs +93 -0
  545. package/skills/risk-compliance/contract-review/LICENSE +3 -0
  546. package/skills/risk-compliance/contract-review/SKILL.md +240 -0
  547. package/skills/risk-compliance/contract-review/references/review-criteria.md +223 -0
  548. package/skills/risk-compliance/contract-review/release-check.mjs +93 -0
  549. package/skills/risk-compliance/doc-authenticity/LICENSE +3 -0
  550. package/skills/risk-compliance/doc-authenticity/SKILL.md +160 -0
  551. package/skills/risk-compliance/doc-authenticity/agents/openai.yaml +8 -0
  552. package/skills/risk-compliance/doc-authenticity/manual-invocation.test.mjs +12 -0
  553. package/skills/risk-compliance/doc-authenticity/references/agreement.md +66 -0
  554. package/skills/risk-compliance/doc-authenticity/references/bank-statement.md +150 -0
  555. package/skills/risk-compliance/doc-authenticity/references/forensic-signals.md +157 -0
  556. package/skills/risk-compliance/doc-authenticity/references/image-signals.md +114 -0
  557. package/skills/risk-compliance/doc-authenticity/references/invoice.md +66 -0
  558. package/skills/risk-compliance/doc-authenticity/references/issuer-profiles.md +86 -0
  559. package/skills/risk-compliance/doc-authenticity/references/verdict-and-report.md +95 -0
  560. package/skills/risk-compliance/doc-authenticity/references/verdict.schema.json +81 -0
  561. package/skills/risk-compliance/doc-authenticity/release-check.mjs +93 -0
  562. package/skills/risk-compliance/doc-authenticity/scripts/image_forensics.py +294 -0
  563. package/skills/risk-compliance/doc-authenticity/scripts/pdf_forensics.py +401 -0
  564. package/skills/risk-compliance/doc-authenticity/scripts/validate_codes.py +224 -0
  565. package/skills/risk-compliance/doc-authenticity/scripts/validate_verdict.py +308 -0
  566. package/skills/risk-compliance/doc-authenticity/scripts/validate_verdict.test.mjs +212 -0
  567. package/skills/risk-compliance/fraud-analysis/LICENSE +3 -0
  568. package/skills/risk-compliance/fraud-analysis/SKILL.md +114 -0
  569. package/skills/risk-compliance/fraud-analysis/references/archetypes/authorized-payment-scam.md +41 -0
  570. package/skills/risk-compliance/fraud-analysis/references/archetypes/first-party-fraud.md +44 -0
  571. package/skills/risk-compliance/fraud-analysis/references/archetypes/third-party-fraud.md +27 -0
  572. package/skills/risk-compliance/fraud-analysis/references/contexts/bank-transfer.md +24 -0
  573. package/skills/risk-compliance/fraud-analysis/references/contexts/card-payment.md +30 -0
  574. package/skills/risk-compliance/fraud-analysis/references/contexts/payment-collection.md +20 -0
  575. package/skills/risk-compliance/fraud-analysis/references/contexts/payout.md +20 -0
  576. package/skills/risk-compliance/fraud-analysis/references/feature-engineering.md +158 -0
  577. package/skills/risk-compliance/fraud-analysis/references/mechanisms/account-takeover.md +36 -0
  578. package/skills/risk-compliance/fraud-analysis/references/report-rationale.md +45 -0
  579. package/skills/risk-compliance/fraud-analysis/references/report-template.md +190 -0
  580. package/skills/risk-compliance/fraud-analysis/references/review-checklist.md +175 -0
  581. package/skills/risk-compliance/fraud-analysis/references/taxonomy.md +79 -0
  582. package/skills/risk-compliance/fraud-analysis/references/terminology.md +108 -0
  583. package/skills/risk-compliance/fraud-analysis/references/workflow.md +175 -0
  584. package/skills/risk-compliance/fraud-analysis/release-check.mjs +93 -0
  585. package/skills/risk-compliance/payment-analysis/LICENSE +3 -0
  586. package/skills/risk-compliance/payment-analysis/SKILL.md +180 -0
  587. package/skills/risk-compliance/payment-analysis/references/auth-rate-actions.md +30 -0
  588. package/skills/risk-compliance/payment-analysis/references/chargebacks.md +208 -0
  589. package/skills/risk-compliance/payment-analysis/references/chinese-polish.md +51 -0
  590. package/skills/risk-compliance/payment-analysis/references/event-layers.md +127 -0
  591. package/skills/risk-compliance/payment-analysis/references/fx.md +59 -0
  592. package/skills/risk-compliance/payment-analysis/references/journey.md +79 -0
  593. package/skills/risk-compliance/payment-analysis/references/metrics.md +67 -0
  594. package/skills/risk-compliance/payment-analysis/references/report-template.md +119 -0
  595. package/skills/risk-compliance/payment-analysis/references/terminology.md +95 -0
  596. package/skills/risk-compliance/payment-analysis/references/visualization.md +56 -0
  597. package/skills/risk-compliance/payment-analysis/release-check.mjs +93 -0
  598. package/skills/risk-compliance/report-writing/LICENSE +3 -0
  599. package/skills/risk-compliance/report-writing/SKILL.md +220 -0
  600. package/skills/risk-compliance/report-writing/references/audit-report-template.md +121 -0
  601. package/skills/risk-compliance/report-writing/references/external-assessment-template.md +167 -0
  602. package/skills/risk-compliance/report-writing/references/management-report-template.md +145 -0
  603. package/skills/risk-compliance/report-writing/references/vars-report-template.md +224 -0
  604. package/skills/risk-compliance/report-writing/release-check.mjs +93 -0
  605. package/skills/risk-compliance/similar-domain/LICENSE +3 -0
  606. package/skills/risk-compliance/similar-domain/SKILL.md +203 -0
  607. package/skills/risk-compliance/similar-domain/references/entities.md +67 -0
  608. package/skills/risk-compliance/similar-domain/references/fingerprints.md +134 -0
  609. package/skills/risk-compliance/similar-domain/references/pivots.md +82 -0
  610. package/skills/risk-compliance/similar-domain/references/report-template.md +93 -0
  611. package/skills/risk-compliance/similar-domain/references/scoring.md +130 -0
  612. package/skills/risk-compliance/similar-domain/references/terminology.md +41 -0
  613. package/skills/risk-compliance/similar-domain/references/workflow.md +85 -0
  614. package/skills/risk-compliance/similar-domain/release-check.mjs +93 -0
  615. package/skills/risk-compliance/tld-detection/LICENSE +3 -0
  616. package/skills/risk-compliance/tld-detection/SKILL.md +245 -0
  617. package/skills/risk-compliance/tld-detection/agents/openai.yaml +9 -0
  618. package/skills/risk-compliance/tld-detection/references/chinese-polish.md +55 -0
  619. package/skills/risk-compliance/tld-detection/references/clean.md +51 -0
  620. package/skills/risk-compliance/tld-detection/references/clustering.md +235 -0
  621. package/skills/risk-compliance/tld-detection/references/decision.md +189 -0
  622. package/skills/risk-compliance/tld-detection/references/fx-conversion.md +232 -0
  623. package/skills/risk-compliance/tld-detection/references/report-template.md +272 -0
  624. package/skills/risk-compliance/tld-detection/references/streams.md +141 -0
  625. package/skills/risk-compliance/tld-detection/references/terminology.md +95 -0
  626. package/skills/risk-compliance/tld-detection/references/workflow.md +95 -0
  627. package/skills/risk-compliance/tld-detection/release-check.mjs +93 -0
  628. package/skills/risk-compliance/tld-detection/scripts/detect_ladders.py +390 -0
  629. package/skills/risk-compliance/tld-detection/scripts/detect_ladders.test.mjs +14 -0
  630. package/skills/risk-compliance/tld-detection/scripts/detect_streams.py +650 -0
  631. package/skills/risk-compliance/tld-detection/scripts/detect_streams.test.mjs +14 -0
  632. package/skills/risk-compliance/tld-detection/tests/test_detect_ladders.py +134 -0
  633. 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
+ }