@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,448 @@
1
+ import { test } from 'node:test'
2
+ import assert from 'node:assert/strict'
3
+ import { spawnSync } from 'node:child_process'
4
+ import { fileURLToPath } from 'node:url'
5
+
6
+ import {
7
+ recommendImplementer,
8
+ rankReviewers,
9
+ fillExplorer,
10
+ fillDiagnoser,
11
+ slotPoints,
12
+ buildAsk,
13
+ buildPreflightModels,
14
+ TEAM_REVIEWER_POLICY,
15
+ } from './preflight-models.mjs'
16
+
17
+ const points = [
18
+ { id: 'openai/gpt-6-astra', effort: 'high', tier: 'frontier', family: 'openai', key: 'openai/gpt-6-astra@high' },
19
+ { id: 'openai/gpt-5.6-sol', effort: 'high', tier: 'frontier', family: 'openai', key: 'openai/gpt-5.6-sol@high' },
20
+ { id: 'openai/gpt-6.1-sol', effort: 'high', tier: 'frontier', family: 'openai', key: 'openai/gpt-6.1-sol@high' },
21
+ { id: 'openai/gpt-5.5', effort: 'high', tier: 'deep-reasoner', family: 'openai', key: 'openai/gpt-5.5@high' },
22
+ { id: 'openai/gpt-5.6-terra', effort: 'high', tier: 'balanced-coder', family: 'openai', key: 'openai/gpt-5.6-terra@high' },
23
+ { id: 'openai/gpt-6-luna', effort: 'high', tier: 'balanced-coder', family: 'openai', key: 'openai/gpt-6-luna@high' },
24
+ { id: 'xiaomi/mimo-v2.6-pro', effort: 'high', tier: 'frontier', family: 'xiaomi', key: 'xiaomi/mimo-v2.6-pro@high' },
25
+ { id: 'xai/grok-4.7', effort: 'high', tier: 'frontier', family: 'xai', key: 'xai/grok-4.7@high' },
26
+ { id: 'xai/grok-4.6', effort: 'high', tier: 'deep-reasoner', family: 'xai', key: 'xai/grok-4.6@high' },
27
+ { id: 'xai/grok-4.5', effort: 'high', tier: 'balanced-coder', family: 'xai', key: 'xai/grok-4.5@high' },
28
+ { id: 'anthropic/claude-opus', effort: 'high', tier: 'frontier', family: 'anthropic', key: 'anthropic/claude-opus@high' },
29
+ ]
30
+
31
+ test('routine risk recommends a balanced-coder, not frontier', () => {
32
+ const pick = recommendImplementer(points, 'routine')
33
+ assert.equal(pick.tier, 'balanced-coder')
34
+ assert.ok(['xai/grok-4.5', 'openai/gpt-5.6-terra'].includes(pick.id))
35
+ })
36
+
37
+ test('routine risk walks the team ladder: gpt-6.1-sol@high, gpt-6-luna@high, grok-4.6@high, then mimo-v2.6-pro@high', () => {
38
+ const pick = recommendImplementer(points, 'routine', 'pi')
39
+ assert.equal(pick.key, 'openai/gpt-6.1-sol@high')
40
+ assert.equal(pick.tier, 'frontier')
41
+ assert.equal(rankReviewers(points, pick, 'pi').fill.key, 'openai/gpt-6-astra@medium')
42
+ const withoutSol = points.filter((p) => p.id !== 'openai/gpt-6.1-sol')
43
+ const second = recommendImplementer(withoutSol, 'routine', 'pi')
44
+ assert.equal(second.key, 'openai/gpt-6-luna@high')
45
+ assert.equal(second.tier, 'balanced-coder')
46
+ assert.equal(rankReviewers(points, second, 'pi').fill.key, 'openai/gpt-6-astra@medium')
47
+ const withoutLuna = withoutSol.filter((p) => p.id !== 'openai/gpt-6-luna')
48
+ const third = recommendImplementer(withoutLuna, 'routine', 'pi')
49
+ assert.equal(third.key, 'xai/grok-4.6@high')
50
+ // a cross-family implementation is still reviewed by the team primary, a distinct id and family
51
+ const grokReview = rankReviewers(points, third, 'pi')
52
+ assert.equal(grokReview.fill.key, 'openai/gpt-6-astra@medium')
53
+ assert.equal(grokReview.reducedDiversity, false)
54
+ const withoutGrok46 = withoutLuna.filter((p) => p.id !== 'xai/grok-4.6')
55
+ const fourth = recommendImplementer(withoutGrok46, 'routine', 'pi')
56
+ assert.equal(fourth.key, 'xiaomi/mimo-v2.6-pro@high')
57
+ assert.equal(rankReviewers(points, fourth, 'pi').fill.key, 'openai/gpt-6-astra@medium')
58
+ // past the ladder, the tier order picks a balanced-coder
59
+ const withoutMimo = withoutGrok46.filter((p) => p.id !== 'xiaomi/mimo-v2.6-pro')
60
+ assert.equal(recommendImplementer(withoutMimo, 'routine', 'pi').tier, 'balanced-coder')
61
+ })
62
+
63
+ test('codex routine ladder is gpt-6.1-sol@high, then gpt-6-luna@high', () => {
64
+ const codex = [
65
+ { id: 'gpt-6.1-sol', effort: 'high', tier: 'frontier', family: 'openai', key: 'gpt-6.1-sol@high' },
66
+ { id: 'gpt-6-luna', effort: 'high', tier: 'balanced-coder', family: 'openai', key: 'gpt-6-luna@high' },
67
+ ]
68
+ assert.equal(recommendImplementer(codex, 'routine', 'codex').key, 'gpt-6.1-sol@high')
69
+ assert.equal(recommendImplementer(codex.slice(1), 'routine', 'codex').key, 'gpt-6-luna@high')
70
+ })
71
+
72
+ test('escalation fix workers walk the high-risk ladder', () => {
73
+ assert.equal(fillDiagnoser(points, 'pi').fill.key, 'openai/gpt-6.1-sol@high')
74
+ const withoutSol61 = points.filter((p) => p.id !== 'openai/gpt-6.1-sol')
75
+ assert.equal(fillDiagnoser(withoutSol61, 'pi').fill.key, 'openai/gpt-6-astra@high')
76
+ const withoutAstra = withoutSol61.filter((p) => p.id !== 'openai/gpt-6-astra')
77
+ assert.equal(fillDiagnoser(withoutAstra, 'pi').fill.key, 'openai/gpt-5.6-sol@high')
78
+ const withoutSol56 = withoutAstra.filter((p) => p.id !== 'openai/gpt-5.6-sol')
79
+ assert.equal(fillDiagnoser(withoutSol56, 'pi').fill.key, 'xai/grok-4.7@high')
80
+ })
81
+
82
+ test('explorer takes gpt-6.1-sol@medium first, then gpt-6-luna, grok-4.6, mimo-v2.6-pro (all @high), then the balanced-coder tier', () => {
83
+ const explorer = fillExplorer(points, 'pi')
84
+ assert.equal(explorer.reason, 'team-default')
85
+ assert.equal(explorer.fill.key, 'openai/gpt-6.1-sol@medium')
86
+ assert.equal(explorer.fill.effort, 'medium')
87
+ assert.equal(explorer.fill.source, 'team-explorer-policy')
88
+ const withoutSol = points.filter((p) => p.id !== 'openai/gpt-6.1-sol')
89
+ const second = fillExplorer(withoutSol, 'pi')
90
+ assert.equal(second.reason, 'team-default')
91
+ assert.equal(second.fill.key, 'openai/gpt-6-luna@high')
92
+ const withoutLuna = withoutSol.filter((p) => p.id !== 'openai/gpt-6-luna')
93
+ assert.equal(fillExplorer(withoutLuna, 'pi').fill.key, 'xai/grok-4.6@high')
94
+ const withoutGrok46 = withoutLuna.filter((p) => p.id !== 'xai/grok-4.6')
95
+ assert.equal(fillExplorer(withoutGrok46, 'pi').fill.key, 'xiaomi/mimo-v2.6-pro@high')
96
+ const noLadder = withoutGrok46.filter((p) => p.id !== 'xiaomi/mimo-v2.6-pro')
97
+ const tierFill = fillExplorer(noLadder, 'pi')
98
+ assert.equal(tierFill.reason, 'balanced-coder')
99
+ assert.equal(tierFill.fill.tier, 'balanced-coder')
100
+ })
101
+
102
+ test('a discovered gpt-6.1-sol fills the explorer at medium, not at its @high implementer rung', () => {
103
+ const onlySolHigh = [points.find((p) => p.id === 'openai/gpt-6.1-sol'), points.find((p) => p.id === 'openai/gpt-5.6-terra')]
104
+ assert.equal(fillExplorer(onlySolHigh, 'pi').fill.key, 'openai/gpt-6.1-sol@medium')
105
+ })
106
+
107
+ test('the explorer takes gpt-6.1-sol@medium while the routine implementer takes gpt-6.1-sol@high', () => {
108
+ assert.equal(fillExplorer(points, 'pi').fill.key, 'openai/gpt-6.1-sol@medium')
109
+ assert.equal(recommendImplementer(points, 'routine', 'pi').key, 'openai/gpt-6.1-sol@high')
110
+ })
111
+
112
+ test('an undiscovered explorer rung falls through to the next discovered point', () => {
113
+ // Discovery yields neither gpt-6.1-sol nor gpt-6-luna, so the explorer lands on the balanced-coder tier.
114
+ const tiered = [
115
+ { id: 'gpt-6-astra', tiers: { high: 'frontier' }, source: 'team-seed' },
116
+ { id: 'gpt-5.6-sol', tiers: { high: 'frontier' }, source: 'team-seed' },
117
+ { id: 'gpt-5.6-terra', tiers: { high: 'balanced-coder' }, source: 'team-seed' },
118
+ ]
119
+ const result = buildPreflightModels({
120
+ harness: 'codex',
121
+ risk: 'routine',
122
+ discoverFn: () => ({
123
+ harness: 'codex',
124
+ completeness: 'full',
125
+ discovered: tiered.map(({ id }) => ({ id, source: 'current-turn' })),
126
+ notes: [],
127
+ }),
128
+ tierFn: () => ({ models: tiered, seedDisagreements: [], staleClassifications: [] }),
129
+ })
130
+ assert.equal(result.explorer.fill.key, 'gpt-5.6-terra@high')
131
+ assert.equal(result.explorer.reason, 'balanced-coder')
132
+ assert.equal(result.ask.explorerFill.id, 'gpt-5.6-terra@high')
133
+ // the same harness with gpt-6.1-sol discovered takes the medium rung
134
+ const withSol = [...tiered, { id: 'gpt-6.1-sol', tiers: { high: 'frontier' }, source: 'team-seed' }]
135
+ const sol = buildPreflightModels({
136
+ harness: 'codex',
137
+ risk: 'routine',
138
+ discoverFn: () => ({
139
+ harness: 'codex',
140
+ completeness: 'full',
141
+ discovered: withSol.map(({ id }) => ({ id, source: 'current-turn' })),
142
+ notes: [],
143
+ }),
144
+ tierFn: () => ({ models: withSol, seedDisagreements: [], staleClassifications: [] }),
145
+ })
146
+ assert.equal(sol.explorer.fill.key, 'gpt-6.1-sol@medium')
147
+ assert.equal(sol.implementer.key, 'gpt-6.1-sol@high', 'the routine implementer takes the @high rung')
148
+ })
149
+
150
+ test('high risk walks the team ladder: gpt-6.1-sol, gpt-6-astra, gpt-5.6-sol, grok-4.7 (all @high), then the deep-reasoner tier', () => {
151
+ const pick = recommendImplementer(points, 'high', 'pi')
152
+ assert.equal(pick.id, 'openai/gpt-6.1-sol')
153
+ assert.equal(pick.tier, 'frontier')
154
+ assert.equal(pick.effort, 'high')
155
+ // the gpt-6.1-sol implementation is reviewed by Astra (distinct id, same family)
156
+ const firstReview = rankReviewers(points, pick, 'pi')
157
+ assert.equal(firstReview.fill.key, 'openai/gpt-6-astra@medium')
158
+ assert.equal(firstReview.reason, 'team-default')
159
+ // without gpt-6.1-sol, Astra implements and is reviewed by the implementer-aware fallback
160
+ const withoutSol61 = points.filter((p) => p.id !== 'openai/gpt-6.1-sol')
161
+ const second = recommendImplementer(withoutSol61, 'high', 'pi')
162
+ assert.equal(second.key, 'openai/gpt-6-astra@high')
163
+ const secondReview = rankReviewers(points, second, 'pi')
164
+ assert.equal(secondReview.fill.key, 'openai/gpt-5.6-sol@medium')
165
+ assert.equal(secondReview.reason, 'implementer-aware-default')
166
+ // then gpt-5.6-sol and grok-4.7, each reviewed by gpt-6-astra@medium
167
+ const withoutAstra = withoutSol61.filter((p) => p.id !== 'openai/gpt-6-astra')
168
+ const third = recommendImplementer(withoutAstra, 'high', 'pi')
169
+ assert.equal(third.key, 'openai/gpt-5.6-sol@high')
170
+ assert.equal(rankReviewers(points, third, 'pi').fill.key, 'openai/gpt-6-astra@medium')
171
+ const withoutSol56 = withoutAstra.filter((p) => p.id !== 'openai/gpt-5.6-sol')
172
+ const fourth = recommendImplementer(withoutSol56, 'high', 'pi')
173
+ assert.equal(fourth.key, 'xai/grok-4.7@high')
174
+ assert.equal(rankReviewers(points, fourth, 'pi').fill.key, 'openai/gpt-6-astra@medium')
175
+ // without the harness (no team ladder) the tier order picks a deep-reasoner, never frontier
176
+ assert.equal(recommendImplementer(points, 'high').tier, 'deep-reasoner')
177
+ // without any ladder rung discovered, the tier order falls back to the other deep-reasoner
178
+ const withoutLadder = withoutSol56.filter((p) => !['xai/grok-4.7', 'xai/grok-4.6'].includes(p.id))
179
+ assert.equal(recommendImplementer(withoutLadder, 'high', 'pi').id, 'openai/gpt-5.5')
180
+ })
181
+
182
+ test('the recommended frontier implementer is labelled as the team preference, not an alternate', () => {
183
+ const implementer = recommendImplementer(points, 'high', 'pi')
184
+ const reviewer = rankReviewers(points, implementer, 'pi')
185
+ const ask = buildAsk(implementer, points, reviewer, { risk: 'high' })
186
+ assert.equal(ask.options[0].modelId, 'openai/gpt-6.1-sol')
187
+ assert.match(ask.options[0].description, /recommended · frontier — team implementer ladder preference/)
188
+ // without a harness there is no ladder to consult, so the other frontier point is a plain alternate
189
+ const otherFrontier = [...ask.options, ...ask.alternates].find((o) => o.modelId === 'openai/gpt-5.6-sol')
190
+ assert.match(otherFrontier.description, /alternate only/)
191
+ })
192
+
193
+ test('the ask lists the discovered ladder rungs first, in ladder order, before other points', () => {
194
+ // Real Pi discovery shape: deep-reasoners whose ids sort before the ladder rungs, plus a
195
+ // balanced-coder with a cheap id. Before the fix these pushed the rungs into `alternates`.
196
+ const many = [
197
+ ...points,
198
+ { id: 'deepseek/deepseek-v4-pro', effort: 'max', tier: 'deep-reasoner', family: 'deepseek', key: 'deepseek/deepseek-v4-pro@max' },
199
+ { id: 'kimi-coding/k3', effort: 'high', tier: 'deep-reasoner', family: 'kimi', key: 'kimi-coding/k3@high' },
200
+ { id: 'deepseek/deepseek-v4-flash', effort: 'max', tier: 'balanced-coder', family: 'deepseek', key: 'deepseek/deepseek-v4-flash@max' },
201
+ ]
202
+ const high = recommendImplementer(many, 'high', 'pi')
203
+ const highAsk = buildAsk(many.find((p) => p.key === high.key), many, rankReviewers(many, high, 'pi'), { risk: 'high', harness: 'pi' })
204
+ assert.deepEqual(
205
+ highAsk.options.map((o) => o.id),
206
+ ['openai/gpt-6.1-sol@high', 'openai/gpt-6-astra@high', 'openai/gpt-5.6-sol@high', 'xai/grok-4.7@high'],
207
+ 'high-risk options are the ladder',
208
+ )
209
+ assert.match(highAsk.options[1].description, /team ladder rung 2/)
210
+ assert.ok(highAsk.alternates.some((o) => o.modelId === 'deepseek/deepseek-v4-pro'), 'non-ladder deep-reasoners become alternates')
211
+
212
+ const routine = recommendImplementer(many, 'routine', 'pi')
213
+ const routineAsk = buildAsk(routine, many, rankReviewers(many, routine, 'pi'), { risk: 'routine', harness: 'pi' })
214
+ assert.deepEqual(
215
+ routineAsk.options.map((o) => o.id),
216
+ ['openai/gpt-6.1-sol@high', 'openai/gpt-6-luna@high', 'xai/grok-4.6@high', 'xiaomi/mimo-v2.6-pro@high'],
217
+ 'routine options are the ladder',
218
+ )
219
+ // an undiscovered rung is skipped, not left as a hole: the next point fills the fourth slot
220
+ const withoutMimo = many.filter((p) => p.id !== 'xiaomi/mimo-v2.6-pro')
221
+ const routine2 = recommendImplementer(withoutMimo, 'routine', 'pi')
222
+ const ask2 = buildAsk(routine2, withoutMimo, rankReviewers(withoutMimo, routine2, 'pi'), { risk: 'routine', harness: 'pi' })
223
+ assert.deepEqual(ask2.options.slice(0, 3).map((o) => o.id), ['openai/gpt-6.1-sol@high', 'openai/gpt-6-luna@high', 'xai/grok-4.6@high'])
224
+ assert.equal(ask2.options.length, 4)
225
+ })
226
+
227
+ test('non-Astra implementation prefers the gpt-6-astra@medium policy review when discovered', () => {
228
+ const implementer = recommendImplementer(points, 'routine', 'pi')
229
+ const review = rankReviewers(points, implementer, 'pi')
230
+ assert.equal(review.reason, 'team-default')
231
+ assert.equal(review.fill.id, TEAM_REVIEWER_POLICY.pi.primary.id)
232
+ assert.equal(review.fill.effort, 'medium')
233
+ assert.equal(review.fill.tier, 'frontier')
234
+ assert.equal(review.fill.source, 'team-review-policy')
235
+ assert.equal(review.fill.citation, 'docs/research/2026-09-23-reviewer-benchmark-astra-vs-sol.md')
236
+ assert.notEqual(review.fill.id, implementer.id)
237
+ assert.equal(review.ranking[0].key, 'openai/gpt-6-astra@medium')
238
+ assert.equal(review.ranking[1].key, 'openai/gpt-5.6-sol@medium')
239
+ assert.ok(!review.ranking.some((candidate) => candidate.effort === 'high' && candidate.id === 'openai/gpt-6-astra'), 'the policy point replaces the catalog high point in the ranking')
240
+ })
241
+
242
+ test('Astra implementation uses the gpt-5.6-sol@medium implementer-aware default', () => {
243
+ const implementer = points.find((p) => p.id === 'openai/gpt-6-astra')
244
+ const review = rankReviewers(points, implementer, 'pi')
245
+ assert.equal(review.reason, 'implementer-aware-default')
246
+ assert.notEqual(review.fill.id, implementer.id)
247
+ assert.equal(review.fill.id, TEAM_REVIEWER_POLICY.pi.fallback.id)
248
+ assert.equal(review.fill.effort, 'medium')
249
+ assert.equal(review.fill.key, 'openai/gpt-5.6-sol@medium')
250
+ })
251
+
252
+ test('another Astra effort is still the same implementer model id', () => {
253
+ const implementer = {
254
+ ...points.find((p) => p.id === 'openai/gpt-6-astra'),
255
+ effort: 'xhigh',
256
+ key: 'openai/gpt-6-astra@xhigh',
257
+ }
258
+ const review = rankReviewers(points, implementer, 'pi')
259
+ assert.equal(review.fill.id, 'openai/gpt-5.6-sol')
260
+ assert.notEqual(review.fill.id, implementer.id)
261
+ })
262
+
263
+ test('a gpt-6.1-sol implementation still gets the Astra reviewer (distinct id, same family)', () => {
264
+ const implementer = points.find((p) => p.id === 'openai/gpt-6.1-sol')
265
+ const review = rankReviewers(points, implementer, 'pi')
266
+ assert.equal(review.reason, 'team-default')
267
+ assert.equal(review.fill.id, 'openai/gpt-6-astra')
268
+ assert.equal(review.reducedDiversity, true, 'same family is flagged, not forbidden')
269
+ })
270
+
271
+ test('missing implementer-aware fallback uses the distinct-model ladder', () => {
272
+ const withoutSol56 = points.filter((p) => p.id !== 'openai/gpt-5.6-sol')
273
+ const implementer = withoutSol56.find((p) => p.id === 'openai/gpt-6-astra')
274
+ const review = rankReviewers(withoutSol56, implementer, 'pi')
275
+ assert.equal(review.reason, 'ladder')
276
+ // diversity-first: a cross-family deep-reasoner (grok-4.6) outranks cross-family frontier points
277
+ assert.equal(review.fill.id, 'xai/grok-4.6')
278
+ const withoutGrok = withoutSol56.filter((p) => p.family !== 'xai' && p.family !== 'xiaomi')
279
+ assert.equal(rankReviewers(withoutGrok, implementer, 'pi').fill.id, 'anthropic/claude-opus')
280
+ })
281
+
282
+ test('missing Astra primary uses the distinct-model ladder even when gpt-5.6-sol is available', () => {
283
+ const withoutAstra = points.filter((p) => p.id !== 'openai/gpt-6-astra')
284
+ const implementer = withoutAstra.find((p) => p.id === 'xai/grok-4.5')
285
+ const review = rankReviewers(withoutAstra, implementer, 'pi')
286
+ assert.equal(review.reason, 'ladder')
287
+ assert.equal(review.fill.id, 'openai/gpt-5.5', 'a cross-family deep-reasoner leads the ladder')
288
+ assert.equal(review.ranking[0].id, 'openai/gpt-5.6-sol', 'the fallback frontier point stays first in the ranking for a later Astra override')
289
+ })
290
+
291
+ test('scoped-coder points never enter slotPoints', () => {
292
+ const tiered = [
293
+ { id: 'scoped/x', tiers: { high: 'scoped-coder' }, source: 'banked' },
294
+ { id: 'ok/y', tiers: { high: 'balanced-coder' }, source: 'banked' },
295
+ ]
296
+ const out = slotPoints(tiered, { harness: 'pi' })
297
+ assert.deepEqual(out.map((p) => p.id), ['ok/y'])
298
+ })
299
+
300
+ test('ask lists recommended implementer first, caps at 4, keeps frontier visible', () => {
301
+ const many = [
302
+ ...points,
303
+ { id: 'a/balanced', effort: 'high', tier: 'balanced-coder', family: 'a', key: 'a/balanced@high' },
304
+ { id: 'b/balanced', effort: 'high', tier: 'balanced-coder', family: 'b', key: 'b/balanced@high' },
305
+ { id: 'c/deep', effort: 'high', tier: 'deep-reasoner', family: 'c', key: 'c/deep@high' },
306
+ ]
307
+ const implementer = recommendImplementer(many, 'routine')
308
+ const explorer = fillExplorer(many, 'pi')
309
+ const reviewer = rankReviewers(many, implementer, 'pi')
310
+ const ask = buildAsk(implementer, many, reviewer, { risk: 'routine', explorer })
311
+ assert.equal(ask.options[0].modelId, implementer.id)
312
+ assert.equal(ask.recommended, implementer.key)
313
+ assert.ok(ask.options.length <= 4)
314
+ assert.equal(ask.reviewerFill.modelId, reviewer.fill.id)
315
+ assert.equal(ask.explorerFill.modelId, explorer.fill.id)
316
+ assert.ok(
317
+ ask.options.some((o) => o.tier === 'frontier') || ask.alternates.some((o) => o.tier === 'frontier'),
318
+ 'frontier stays visible',
319
+ )
320
+ })
321
+
322
+ test('buildPreflightModels is injectable and defers sync/bank', () => {
323
+ const result = buildPreflightModels({
324
+ harness: 'pi',
325
+ risk: 'routine',
326
+ available: ['openai/gpt-5.5', 'xai/grok-4.5', 'openai/gpt-5.6-sol', 'openai/gpt-5.6-terra', 'openai/gpt-6-astra'],
327
+ discoverFn: () => ({
328
+ harness: 'pi',
329
+ completeness: 'full',
330
+ discovered: [
331
+ { id: 'openai/gpt-6-astra', source: 'current-turn' },
332
+ { id: 'openai/gpt-5.5', source: 'current-turn' },
333
+ { id: 'xai/grok-4.5', source: 'current-turn' },
334
+ { id: 'openai/gpt-5.6-sol', source: 'current-turn' },
335
+ { id: 'openai/gpt-5.6-terra', source: 'current-turn' },
336
+ ],
337
+ notes: [],
338
+ }),
339
+ tierFn: () => ({
340
+ models: [
341
+ { id: 'openai/gpt-6-astra', tiers: { high: 'frontier' }, source: 'team-seed', citation: null },
342
+ { id: 'openai/gpt-5.5', tiers: { high: 'deep-reasoner' }, source: 'team-seed', citation: null },
343
+ { id: 'xai/grok-4.5', tiers: { high: 'balanced-coder' }, source: 'team-seed', citation: null },
344
+ { id: 'openai/gpt-5.6-sol', tiers: { high: 'frontier' }, source: 'team-seed', citation: null },
345
+ { id: 'openai/gpt-5.6-terra', tiers: { high: 'balanced-coder' }, source: 'team-seed', citation: null },
346
+ ],
347
+ seedDisagreements: [],
348
+ staleClassifications: [],
349
+ }),
350
+ })
351
+ assert.equal(result.ok, true)
352
+ assert.equal(result.implementer.tier, 'balanced-coder')
353
+ assert.equal(result.explorer.reason, 'balanced-coder')
354
+ assert.equal(result.explorer.fill.id, 'openai/gpt-5.6-terra')
355
+ assert.equal(result.reviewer.reason, 'team-default')
356
+ assert.equal(result.reviewer.fill.id, TEAM_REVIEWER_POLICY.pi.primary.id)
357
+ assert.equal(result.reviewer.fill.effort, 'medium')
358
+ assert.ok(result.deferred.afterConfirm.some((s) => s.includes('sync')))
359
+ assert.ok(result.deferred.doNotReadBeforeAsk.length >= 1)
360
+ assert.equal(result.ask.options[0].modelId, result.implementer.id)
361
+ assert.equal(result.ask.explorerFill.modelId, 'openai/gpt-5.6-terra')
362
+ assert.equal(result.diagnoser.fill.key, 'openai/gpt-6-astra@high')
363
+ assert.equal(result.ask.diagnoserFill.id, 'openai/gpt-6-astra@high')
364
+ })
365
+
366
+ test('CLI --ask-only prints only the ask block', () => {
367
+ const script = fileURLToPath(new URL('./preflight-models.mjs', import.meta.url))
368
+ const run = spawnSync(process.execPath, [
369
+ script,
370
+ '--harness', 'pi',
371
+ '--risk', 'routine',
372
+ '--available', 'openai/gpt-5.5,xai/grok-4.5,openai/gpt-5.6-sol,openai/gpt-5.6-terra,openai/gpt-6-astra',
373
+ '--ask-only',
374
+ ], { encoding: 'utf8' })
375
+ assert.equal(run.status, 0, run.stderr)
376
+ const ask = JSON.parse(run.stdout)
377
+ assert.ok(ask.question)
378
+ assert.ok(Array.isArray(ask.options))
379
+ assert.ok(ask.reviewerFill)
380
+ assert.ok(ask.explorerFill)
381
+ assert.equal(ask.options[0].description.includes('recommended'), true)
382
+ })
383
+
384
+ const pinTiered = [
385
+ { id: 'gpt-6-astra', tiers: { high: 'frontier' }, source: 'team-seed' },
386
+ { id: 'gpt-6.1-sol', tiers: { high: 'frontier' }, source: 'team-seed' },
387
+ { id: 'gpt-5.6-terra', tiers: { high: 'balanced-coder' }, source: 'team-seed' },
388
+ ]
389
+ const pinRun = (implementer, tiered = pinTiered) => buildPreflightModels({
390
+ harness: 'codex',
391
+ risk: 'routine',
392
+ implementer,
393
+ discoverFn: () => ({
394
+ harness: 'codex',
395
+ completeness: 'full',
396
+ discovered: tiered.map(({ id }) => ({ id, source: 'current-turn' })),
397
+ notes: [],
398
+ }),
399
+ tierFn: () => ({ models: tiered, seedDisagreements: [], staleClassifications: [] }),
400
+ })
401
+
402
+ test('a pinned implementer is kept over the recommendation and is the only option', () => {
403
+ const result = pinRun('gpt-5.6-terra')
404
+ assert.equal(result.ok, true)
405
+ assert.equal(result.pinned, 'gpt-5.6-terra')
406
+ assert.equal(result.implementer.key, 'gpt-5.6-terra@high', 'the ladder would have picked gpt-6.1-sol@high')
407
+ assert.deepEqual(result.ask.options.map((o) => o.id), ['gpt-5.6-terra@high'])
408
+ assert.deepEqual(result.ask.alternates, [])
409
+ assert.equal(result.ask.pinned, true)
410
+ assert.notEqual(result.reviewer.fill.id, 'gpt-5.6-terra', 'the reviewer still differs from the pinned implementer')
411
+ })
412
+
413
+ test('a pin with an effort matches that operating point only', () => {
414
+ assert.equal(pinRun('gpt-6-astra@high').implementer.key, 'gpt-6-astra@high')
415
+ const wrongEffort = pinRun('gpt-6-astra@max')
416
+ assert.equal(wrongEffort.ok, false)
417
+ assert.equal(wrongEffort.code, 'pinned-implementer-unavailable')
418
+ })
419
+
420
+ test('an unavailable pinned implementer blocks instead of falling back', () => {
421
+ const result = pinRun('cory-model')
422
+ assert.equal(result.ok, false)
423
+ assert.equal(result.code, 'pinned-implementer-unavailable')
424
+ assert.equal(result.implementer, null)
425
+ assert.equal(result.ask, null)
426
+ assert.match(result.reason, /never substitute/)
427
+ })
428
+
429
+ test('no pin keeps the recommendation and the full option list', () => {
430
+ const result = pinRun(null)
431
+ assert.equal(result.pinned, undefined)
432
+ assert.equal(result.implementer.key, 'gpt-6.1-sol@high')
433
+ assert.ok(result.ask.options.length > 1)
434
+ assert.equal(result.ask.pinned, undefined)
435
+ })
436
+
437
+ test('CLI exits 0 with the unavailable pin in the output and rejects an empty one with 2', () => {
438
+ const script = fileURLToPath(new URL('./preflight-models.mjs', import.meta.url))
439
+ const run = (extra) => spawnSync(process.execPath, [
440
+ script, '--harness', 'pi', '--available', 'openai/gpt-5.6-terra', ...extra,
441
+ ], { encoding: 'utf8' })
442
+ const missing = run(['--implementer', 'openai/not-a-model'])
443
+ assert.equal(missing.status, 0, missing.stderr)
444
+ assert.equal(JSON.parse(missing.stdout).ok, false)
445
+ assert.equal(JSON.parse(missing.stdout).code, 'pinned-implementer-unavailable')
446
+ assert.equal(run(['--implementer=']).status, 2)
447
+ assert.equal(run(['--implementer']).status, 2, 'a flag with no value never falls back to the recommendation')
448
+ })
@@ -0,0 +1,185 @@
1
+ #!/usr/bin/env node
2
+ // Check that every GitHub issue a resolve-issues run will work on is marked ready for an
3
+ // agent, before anything else in preflight.
4
+ //
5
+ // ready-check.mjs --issue <ref> [--issue <ref> ...] [--repo <owner/name>] [--label ready-for-agent] [--exit-outcome]
6
+ //
7
+ // A <ref> is `owner/name#123`, an issue URL, or a bare `123` with --repo. Every
8
+ // issue the run will implement must carry the label: each named issue and every
9
+ // OPEN sub-issue beneath it (any depth, any repository). Closed sub-issues are
10
+ // skipped: they are already done and will not be implemented. An open issue with an
11
+ // open sub-issue is a container (an epic): it needs no label, its open sub-issues carry
12
+ // it instead. An open issue whose sub-issues are all closed is a unit again, because open
13
+ // means work remains: it needs the label, and the verdict lists it under `rollups` so the
14
+ // explorer records what is left or that nothing is (then the human closes it).
15
+ // An issue that cannot be read counts as not ready, and a parent with an
16
+ // unreadable sub-issue is a unit, so the check fails closed rather than letting
17
+ // unreviewed work through.
18
+ //
19
+ // A missing label does not stop a run: resolve-issues asks the human whether to
20
+ // proceed, and rush-issues warns and proceeds. An unreadable issue does stop it.
21
+ //
22
+ // Prints a JSON verdict whose `outcome` is `ready` (every checked issue is ready), `unlabeled`
23
+ // (every issue is readable but some lack the label), or `unreadable` (any issue could not be
24
+ // read; it outranks unlabeled). Exit 0 whenever it ran and answered; 2 for bad input or a crash.
25
+ // --exit-outcome restores the old exit codes for one release (deprecated): 0 ready, 3 unlabeled,
26
+ // 1 unreadable. Each `missing` entry names its `parent`: null for an issue the human named, the
27
+ // parent's ref for a sub-issue.
28
+
29
+ import { execFileSync } from 'node:child_process'
30
+
31
+ import { isMainModule } from '../../engineering-runtime/scripts/main-module.mjs'
32
+ import { fetchTree } from './issue-tree.mjs'
33
+
34
+ export const DEFAULT_LABEL = 'ready-for-agent'
35
+
36
+ export class ReadyCheckError extends Error {}
37
+
38
+ export function parseIssueRef(text, defaultRepo = null) {
39
+ const value = String(text ?? '').trim()
40
+ let match = /^https?:\/\/github\.com\/([^/\s]+)\/([^/\s]+)\/issues\/(\d+)\b/.exec(value)
41
+ if (match) return { repo: `${match[1]}/${match[2]}`, number: Number(match[3]) }
42
+ match = /^([^/\s#]+)\/([^/\s#]+)#(\d+)$/.exec(value)
43
+ if (match) return { repo: `${match[1]}/${match[2]}`, number: Number(match[3]) }
44
+ match = /^#?(\d+)$/.exec(value)
45
+ if (match && defaultRepo) return { repo: defaultRepo, number: Number(match[1]) }
46
+ throw new ReadyCheckError(`cannot read issue reference "${value}" (use owner/name#123, an issue URL, or a number with --repo)`)
47
+ }
48
+
49
+ const refKey = ({ repo, number }) => `${repo.toLowerCase()}#${number}`
50
+
51
+ function repoFromApiUrl(url) {
52
+ const match = /\/repos\/([^/]+)\/([^/]+)(?:\/|$)/.exec(String(url || ''))
53
+ return match ? `${match[1]}/${match[2]}` : null
54
+ }
55
+
56
+ // Walk the named issues and their open sub-issues. `fetchIssue` and
57
+ // `fetchSubIssues` are injected so the rules can be tested without GitHub.
58
+ export function readyCheck(refs, { label = DEFAULT_LABEL, fetchIssue, fetchSubIssues } = {}) {
59
+ const wanted = String(label).toLowerCase()
60
+ const checked = []
61
+ const visited = new Set()
62
+ const childKeys = new Map()
63
+ const queue = refs.map((ref) => ({ ref, parent: null, depth: 0 }))
64
+ while (queue.length > 0) {
65
+ const { ref, parent, depth } = queue.shift()
66
+ const key = refKey(ref)
67
+ if (visited.has(key)) continue
68
+ visited.add(key)
69
+ const at = `${ref.repo}#${ref.number}`
70
+ let issue
71
+ try {
72
+ issue = fetchIssue(ref)
73
+ } catch (error) {
74
+ checked.push({ ref: at, parent, depth, state: null, title: null, labels: [], ready: false, error: String(error?.message || error) })
75
+ continue
76
+ }
77
+ const state = String(issue?.state || '').toLowerCase()
78
+ const labels = (issue?.labels || []).map((l) => (typeof l === 'string' ? l : l?.name)).filter(Boolean)
79
+ // A named issue is always checked; a closed sub-issue is done and skipped.
80
+ if (depth > 0 && state === 'closed') {
81
+ checked.push({ ref: at, parent, depth, state, title: issue?.title ?? null, labels, ready: true, skipped: 'closed' })
82
+ continue
83
+ }
84
+ const ready = labels.some((name) => name.toLowerCase() === wanted)
85
+ const entry = { ref: at, parent, depth, state, title: issue?.title ?? null, labels, ready }
86
+ checked.push(entry)
87
+ let children
88
+ try {
89
+ children = fetchSubIssues(ref)
90
+ } catch (error) {
91
+ entry.subIssuesUnreadable = true
92
+ checked.push({ ref: `${at} (sub-issues)`, parent: at, depth: depth + 1, state: null, title: null, labels: [], ready: false, error: String(error?.message || error) })
93
+ continue
94
+ }
95
+ for (const child of children || []) {
96
+ const repo = repoFromApiUrl(child?.repository_url) || ref.repo
97
+ if (!Number.isInteger(child?.number)) continue
98
+ const childRef = { repo, number: child.number }
99
+ childKeys.set(entry, [...(childKeys.get(entry) || []), refKey(childRef)])
100
+ queue.push({ ref: childRef, parent: at, depth: depth + 1 })
101
+ }
102
+ }
103
+ // Classify each open issue from its sub-issues: `container` when one is open, `unit`
104
+ // otherwise (none, all closed, or unreadable). Only a unit needs the label.
105
+ const byKey = new Map(checked.filter((entry) => !entry.error).map((entry) => [entry.ref.toLowerCase(), entry]))
106
+ for (const entry of byKey.values()) {
107
+ if (entry.skipped) continue
108
+ const keys = childKeys.get(entry) || []
109
+ const open = keys.map((key) => byKey.get(key)).some((child) => child && child.state !== 'closed')
110
+ if (open && !entry.subIssuesUnreadable) {
111
+ if (!entry.ready) Object.assign(entry, { ready: true, exempt: 'has open sub-issues' })
112
+ } else if (keys.length > 0 && !entry.subIssuesUnreadable && entry.state !== 'closed' && keys.every((key) => byKey.has(key))) entry.rollup = true
113
+ }
114
+ const notReady = checked.filter((entry) => !entry.ready)
115
+ const unreadable = notReady.filter((entry) => entry.error).map(({ ref, error }) => ({ ref, error }))
116
+ return {
117
+ label,
118
+ outcome: unreadable.length > 0 ? 'unreadable' : notReady.length > 0 ? 'unlabeled' : 'ready',
119
+ ready: notReady.length === 0,
120
+ rollups: checked.filter((entry) => entry.rollup).map(({ ref, title, state }) => ({ ref, title, state })),
121
+ missing: notReady.filter((entry) => !entry.error).map(({ ref, title, labels, parent }) => ({ ref, title, labels, parent })),
122
+ unreadable,
123
+ checked,
124
+ }
125
+ }
126
+
127
+ function gh(args) {
128
+ return JSON.parse(execFileSync('gh', args, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], timeout: 30_000 }))
129
+ }
130
+
131
+ export const githubFetchers = {
132
+ fetchIssue: ({ repo, number }) => gh(['api', `repos/${repo}/issues/${number}`]),
133
+ // `--slurp` wraps each page in an outer array; flatten it back to one list.
134
+ fetchSubIssues: ({ repo, number }) => gh(['api', '--paginate', '--slurp', `repos/${repo}/issues/${number}/sub_issues`]).flat(),
135
+ }
136
+
137
+ // Answer from trees fetched by issue-tree.mjs (one GraphQL query per named issue), and
138
+ // fall back to the REST fetchers only for an issue the trees do not fully cover.
139
+ export function treeFetchers(trees, fallback = githubFetchers) {
140
+ const nodes = new Map()
141
+ for (const tree of trees) for (const node of Object.values(tree?.nodes ?? {})) if (node.state) nodes.set(node.key.toLowerCase(), node)
142
+ const find = ({ repo, number }) => nodes.get(`${repo}#${number}`.toLowerCase())
143
+ return {
144
+ fetchIssue: (ref) => {
145
+ const node = find(ref)
146
+ return node ? { state: node.state, title: node.title, labels: node.labels.map((name) => ({ name })) } : fallback.fetchIssue(ref)
147
+ },
148
+ fetchSubIssues: (ref) => {
149
+ const node = find(ref)
150
+ if (!node?.children) return fallback.fetchSubIssues(ref)
151
+ return node.children.map((key) => {
152
+ const at = key.lastIndexOf('#')
153
+ return { number: Number(key.slice(at + 1)), repository_url: `https://api.github.com/repos/${key.slice(0, at)}` }
154
+ })
155
+ },
156
+ }
157
+ }
158
+
159
+ export function parseArgs(argv) {
160
+ const args = { issues: [], repo: null, label: DEFAULT_LABEL }
161
+ for (let i = 0; i < argv.length; i += 1) {
162
+ const arg = argv[i]
163
+ if (arg === '--issue') args.issues.push(argv[++i])
164
+ else if (arg === '--repo') args.repo = argv[++i]
165
+ else if (arg === '--label') args.label = argv[++i]
166
+ else if (arg === '--exit-outcome') args.exitOutcome = true
167
+ else throw new ReadyCheckError(`unknown argument ${arg}`)
168
+ }
169
+ if (args.issues.length === 0) throw new ReadyCheckError('at least one --issue is required')
170
+ if (!args.label) throw new ReadyCheckError('--label needs a value')
171
+ return args
172
+ }
173
+
174
+ if (isMainModule(import.meta.url)) {
175
+ try {
176
+ const args = parseArgs(process.argv.slice(2))
177
+ const refs = args.issues.map((text) => parseIssueRef(text, args.repo))
178
+ const result = readyCheck(refs, { label: args.label, ...treeFetchers(refs.map((ref) => fetchTree(ref))) })
179
+ console.log(JSON.stringify(result, null, 2))
180
+ process.exitCode = args.exitOutcome ? { ready: 0, unlabeled: 3, unreadable: 1 }[result.outcome] : 0
181
+ } catch (error) {
182
+ console.error(error instanceof ReadyCheckError ? error.message : String(error?.stack || error))
183
+ process.exitCode = 2
184
+ }
185
+ }