@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,967 @@
1
+ import { test } from 'node:test';
2
+ import assert from 'node:assert/strict';
3
+ import { spawnSync } from 'node:child_process';
4
+ import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
5
+ import { tmpdir } from 'node:os';
6
+ import { dirname, join, resolve } from 'node:path';
7
+ import { fileURLToPath } from 'node:url';
8
+
9
+ import {
10
+ CapabilityUnavailableError,
11
+ HarnessRuntimeError,
12
+ HARNESS_RUNTIME_ERROR_CODES,
13
+ QUESTION_ADAPTER_PRIORITY,
14
+ QUESTION_FALLBACK_POLICY,
15
+ UnsupportedQuestionError,
16
+ defineCurrentTurnCapabilities,
17
+ defineModelAvailability,
18
+ defineQuestionAnswers,
19
+ defineQuestionSpec,
20
+ normalizeQuestionResponses,
21
+ planStructuredQuestions,
22
+ } from './index.mjs';
23
+
24
+ const RUNTIME_DIR = dirname(fileURLToPath(import.meta.url));
25
+ const QUESTION_RESPONSE_FIXTURES = JSON.parse(readFileSync(
26
+ join(RUNTIME_DIR, 'fixtures', 'question-responses.json'),
27
+ 'utf8',
28
+ ));
29
+ const NATIVE_QUESTION_SCHEMAS = JSON.parse(readFileSync(
30
+ join(RUNTIME_DIR, 'fixtures', 'native-question-schemas.json'),
31
+ 'utf8',
32
+ ));
33
+
34
+ // @covers package:harness-runtime
35
+ // @level unit
36
+ test('current-turn capabilities preserve only explicitly advertised native tools and spawn models', () => {
37
+ const input = {
38
+ nativeTools: ['ask_user_question', 'functions'],
39
+ spawnModelIds: ['openai/gpt-a', 'anthropic/model-b'],
40
+ };
41
+ const capabilities = defineCurrentTurnCapabilities(input);
42
+
43
+ assert.deepEqual(capabilities, input);
44
+ assert.ok(Object.isFrozen(capabilities));
45
+ assert.ok(Object.isFrozen(capabilities.nativeTools));
46
+ assert.ok(Object.isFrozen(capabilities.spawnModelIds));
47
+ input.nativeTools.push('inferred-tool');
48
+ assert.deepEqual(capabilities.nativeTools, ['ask_user_question', 'functions']);
49
+
50
+ assert.throws(
51
+ () => defineCurrentTurnCapabilities({ nativeTools: ['same', 'same'], spawnModelIds: [] }),
52
+ (error) => error instanceof HarnessRuntimeError
53
+ && error.code === HARNESS_RUNTIME_ERROR_CODES.INVALID_CAPABILITIES,
54
+ );
55
+ });
56
+
57
+ // @covers package:harness-runtime
58
+ // @level unit
59
+ test('neutral questions and answers retain stable ids without selecting a native adapter', () => {
60
+ const question = defineQuestionSpec({
61
+ id: 'delivery-mode',
62
+ header: 'Delivery',
63
+ prompt: 'How should this unit be delivered?',
64
+ options: [
65
+ { id: 'queue', label: 'Merge queue', description: 'Use the protected queue.' },
66
+ { id: 'direct', label: 'Direct PR', description: 'Leave the PR merge-ready.' },
67
+ ],
68
+ recommendationOrder: ['queue', 'direct'],
69
+ multiSelect: false,
70
+ secret: false,
71
+ });
72
+ const answers = defineQuestionAnswers({ 'delivery-mode': ['queue'] });
73
+
74
+ assert.equal(question.id, 'delivery-mode');
75
+ assert.deepEqual(question.recommendationOrder, ['queue', 'direct']);
76
+ assert.deepEqual(answers, { 'delivery-mode': ['queue'] });
77
+ assert.ok(Object.isFrozen(question.options[0]));
78
+ assert.ok(Object.isFrozen(answers['delivery-mode']));
79
+
80
+ assert.throws(
81
+ () => defineQuestionSpec({
82
+ id: 'duplicate-options',
83
+ header: 'Duplicate',
84
+ prompt: 'Choose.',
85
+ options: [{ id: 'same', label: 'One' }, { id: 'same', label: 'Two' }],
86
+ }),
87
+ (error) => error instanceof HarnessRuntimeError
88
+ && error.code === HARNESS_RUNTIME_ERROR_CODES.INVALID_QUESTION,
89
+ );
90
+ assert.throws(
91
+ () => defineQuestionAnswers({ 'delivery-mode': [] }),
92
+ (error) => error instanceof HarnessRuntimeError
93
+ && error.code === HARNESS_RUNTIME_ERROR_CODES.INVALID_ANSWERS,
94
+ );
95
+ });
96
+
97
+ // @covers package:harness-runtime
98
+ // @level unit
99
+ test('model availability states its harness and completeness without claiming static config is full', () => {
100
+ const availability = defineModelAvailability({
101
+ harness: 'codex',
102
+ completeness: 'partial',
103
+ models: [
104
+ { id: 'openai/gpt-a', sources: ['current-turn'] },
105
+ { id: 'openai/gpt-b', sources: ['credentials', 'config'] },
106
+ ],
107
+ });
108
+
109
+ assert.deepEqual(availability, {
110
+ harness: 'codex',
111
+ completeness: 'partial',
112
+ models: [
113
+ { id: 'openai/gpt-a', sources: ['current-turn'] },
114
+ { id: 'openai/gpt-b', sources: ['credentials', 'config'] },
115
+ ],
116
+ });
117
+ assert.ok(Object.isFrozen(availability.models[0].sources));
118
+ assert.throws(
119
+ () => defineModelAvailability({
120
+ harness: 'codex',
121
+ completeness: 'full',
122
+ models: [{ id: 'openai/gpt-a', sources: ['config'] }],
123
+ }),
124
+ (error) => error instanceof HarnessRuntimeError
125
+ && error.code === HARNESS_RUNTIME_ERROR_CODES.INVALID_MODEL_AVAILABILITY,
126
+ );
127
+ });
128
+
129
+ // @covers package:harness-runtime
130
+ // @level unit
131
+ test('capability failures and fallback policy forbid textual multiple-choice emulation', () => {
132
+ assert.deepEqual(QUESTION_FALLBACK_POLICY, {
133
+ noNativeQuestionTool: {
134
+ freeText: 'concise-free-text-only',
135
+ multipleChoice: 'forbidden',
136
+ },
137
+ unsupportedMultiSelect: 'error',
138
+ secretInput: 'error',
139
+ });
140
+ assert.ok(Object.isFrozen(QUESTION_FALLBACK_POLICY.noNativeQuestionTool));
141
+
142
+ const unavailable = new CapabilityUnavailableError('native-question-tool', {
143
+ availableTools: ['functions'],
144
+ });
145
+ assert.equal(unavailable.code, HARNESS_RUNTIME_ERROR_CODES.CAPABILITY_UNAVAILABLE);
146
+ assert.equal(unavailable.capability, 'native-question-tool');
147
+ assert.deepEqual(unavailable.details.availableTools, ['functions']);
148
+
149
+ const unsupported = new UnsupportedQuestionError('secret-input', { questionId: 'token' });
150
+ assert.equal(unsupported.code, HARNESS_RUNTIME_ERROR_CODES.UNSUPPORTED_QUESTION);
151
+ assert.equal(unsupported.reason, 'secret-input');
152
+ });
153
+
154
+ function plannerQuestion(id, overrides = {}) {
155
+ return {
156
+ id,
157
+ header: 'Delivery',
158
+ prompt: `How should ${id} proceed?`,
159
+ options: [
160
+ { id: 'direct', label: 'Direct', description: 'Proceed directly.' },
161
+ { id: 'queue', label: 'Queue', description: 'Use the merge queue.' },
162
+ ],
163
+ recommendationOrder: ['queue', 'direct'],
164
+ multiSelect: false,
165
+ secret: false,
166
+ ...overrides,
167
+ };
168
+ }
169
+
170
+ // @covers package:harness-runtime
171
+ // @level unit
172
+ test('Pi planning is capability-driven, ordered, validated, and deterministically batched', () => {
173
+ assert.deepEqual(QUESTION_ADAPTER_PRIORITY, [
174
+ 'ask_user_question',
175
+ 'request_user_input',
176
+ 'AskUserQuestion',
177
+ ]);
178
+ const capabilities = defineCurrentTurnCapabilities({
179
+ nativeTools: ['AskUserQuestion', 'request_user_input', 'functions', 'ask_user_question'],
180
+ spawnModelIds: [],
181
+ });
182
+ const questions = Array.from({ length: 5 }, (_, index) => plannerQuestion(`gate-${index + 1}`));
183
+ const plan = planStructuredQuestions(capabilities, questions);
184
+
185
+ assert.equal(plan.kind, 'native');
186
+ assert.equal(plan.adapter, 'pi');
187
+ assert.equal(plan.toolName, 'ask_user_question');
188
+ assert.equal(plan.capacity, 4);
189
+ assert.equal(plan.requiresMultipleCalls, true);
190
+ assert.deepEqual(plan.batching, {
191
+ required: true,
192
+ reason: 'adapter-capacity',
193
+ callCount: 2,
194
+ });
195
+ assert.deepEqual(plan.calls.map((call) => call.questionIds), [
196
+ ['gate-1', 'gate-2', 'gate-3', 'gate-4'],
197
+ ['gate-5'],
198
+ ]);
199
+ assert.deepEqual(plan.calls[0].payload.questions[0], {
200
+ question: 'How should gate-1 proceed?',
201
+ header: 'Delivery',
202
+ options: [
203
+ { label: 'Queue', description: 'Use the merge queue.' },
204
+ { label: 'Direct', description: 'Proceed directly.' },
205
+ ],
206
+ multiSelect: false,
207
+ });
208
+ assert.ok(Object.isFrozen(plan.calls[0].payload.questions[0].options[0]));
209
+
210
+ assert.throws(
211
+ () => planStructuredQuestions(capabilities, [plannerQuestion('same'), plannerQuestion('same')]),
212
+ (error) => error instanceof HarnessRuntimeError
213
+ && error.code === HARNESS_RUNTIME_ERROR_CODES.INVALID_QUESTION
214
+ && error.details.reason === 'duplicate-question-id',
215
+ );
216
+ assert.throws(
217
+ () => planStructuredQuestions(capabilities, [plannerQuestion('long-header', { header: 'x'.repeat(17) })]),
218
+ (error) => error instanceof UnsupportedQuestionError
219
+ && error.reason === 'header-too-long',
220
+ );
221
+ assert.throws(
222
+ () => planStructuredQuestions(capabilities, [plannerQuestion('long-label', {
223
+ options: [
224
+ { id: 'long', label: 'x'.repeat(61), description: 'Too long.' },
225
+ { id: 'short', label: 'Short', description: 'Short.' },
226
+ ],
227
+ recommendationOrder: [],
228
+ })]),
229
+ (error) => error instanceof UnsupportedQuestionError
230
+ && error.reason === 'option-label-too-long',
231
+ );
232
+ });
233
+
234
+ // @covers package:harness-runtime
235
+ // @level unit
236
+ test('Codex planning wins fixed priority and emits stable ids in deterministic groups of three', () => {
237
+ const capabilities = defineCurrentTurnCapabilities({
238
+ nativeTools: ['AskUserQuestion', 'request_user_input'],
239
+ spawnModelIds: [],
240
+ });
241
+ const questions = Array.from({ length: 4 }, (_, index) => plannerQuestion(`gate_${index + 1}`));
242
+ const plan = planStructuredQuestions(capabilities, questions);
243
+
244
+ assert.equal(plan.adapter, 'codex');
245
+ assert.equal(plan.toolName, 'request_user_input');
246
+ assert.equal(plan.capacity, 3);
247
+ assert.equal(plan.requiresMultipleCalls, true);
248
+ assert.deepEqual(plan.calls.map((call) => call.questionIds), [
249
+ ['gate_1', 'gate_2', 'gate_3'],
250
+ ['gate_4'],
251
+ ]);
252
+ assert.deepEqual(plan.calls[0].payload.questions[0], {
253
+ id: 'gate_1',
254
+ header: 'Delivery',
255
+ question: 'How should gate_1 proceed?',
256
+ options: [
257
+ { label: 'Queue (Recommended)', description: 'Use the merge queue.' },
258
+ { label: 'Direct', description: 'Proceed directly.' },
259
+ ],
260
+ });
261
+ assert.deepEqual(plan.calls[0].answerMappings[0].options, [
262
+ { id: 'queue', label: 'Queue (Recommended)' },
263
+ { id: 'direct', label: 'Direct' },
264
+ ]);
265
+ assert.throws(
266
+ () => planStructuredQuestions(capabilities, [plannerQuestion('not-stable')]),
267
+ (error) => error instanceof UnsupportedQuestionError
268
+ && error.reason === 'invalid-question-id',
269
+ );
270
+ assert.throws(
271
+ () => planStructuredQuestions(capabilities, [plannerQuestion('multi', { multiSelect: true })]),
272
+ (error) => error instanceof UnsupportedQuestionError
273
+ && error.reason === 'multi-select',
274
+ );
275
+ });
276
+
277
+ // @covers package:harness-runtime
278
+ // @level unit
279
+ // @fails-without-fix package:harness-runtime
280
+ test('Codex rejects recommendation suffix collisions before emitting native labels', () => {
281
+ const capabilities = defineCurrentTurnCapabilities({
282
+ nativeTools: ['request_user_input'],
283
+ spawnModelIds: [],
284
+ });
285
+
286
+ assert.throws(
287
+ () => planStructuredQuestions(capabilities, [plannerQuestion('delivery', {
288
+ options: [
289
+ { id: 'queue', label: 'Queue', description: 'Use the merge queue.' },
290
+ {
291
+ id: 'literal_suffix',
292
+ label: 'Queue (Recommended)',
293
+ description: 'Keep the literal suffix.',
294
+ },
295
+ ],
296
+ recommendationOrder: ['queue'],
297
+ })]),
298
+ (error) => error instanceof HarnessRuntimeError
299
+ && error.code === HARNESS_RUNTIME_ERROR_CODES.INVALID_QUESTION
300
+ && error.details.reason === 'native-option-label-collision'
301
+ && error.details.adapter === 'codex'
302
+ && error.details.questionId === 'delivery'
303
+ && error.details.label === 'Queue (Recommended)'
304
+ && error.details.optionIds.join(',') === 'queue,literal_suffix',
305
+ );
306
+ });
307
+
308
+ // @covers package:harness-runtime
309
+ // @level unit
310
+ // @fails-without-fix package:harness-runtime
311
+ test('Claude Code rejects multi-select answer-format collisions before emission', () => {
312
+ const capabilities = defineCurrentTurnCapabilities({
313
+ nativeTools: ['AskUserQuestion'],
314
+ spawnModelIds: [],
315
+ });
316
+
317
+ assert.throws(
318
+ () => planStructuredQuestions(capabilities, [plannerQuestion('features', {
319
+ multiSelect: true,
320
+ options: [
321
+ { id: 'a', label: 'A', description: 'Select A.' },
322
+ { id: 'b', label: 'B', description: 'Select B.' },
323
+ { id: 'combined', label: 'A, B', description: 'Select the literal combined label.' },
324
+ ],
325
+ recommendationOrder: [],
326
+ })]),
327
+ (error) => error instanceof HarnessRuntimeError
328
+ && error.code === HARNESS_RUNTIME_ERROR_CODES.INVALID_QUESTION
329
+ && error.details.reason === 'native-answer-format-collision'
330
+ && error.details.adapter === 'claude-code'
331
+ && error.details.questionId === 'features'
332
+ && error.details.answer === 'A, B',
333
+ );
334
+ });
335
+
336
+ // @covers package:harness-runtime
337
+ // @level unit
338
+ // @fails-without-fix package:harness-runtime
339
+ test('normalization never guesses duplicate labels and preserves custom answers', () => {
340
+ const piPlan = planStructuredQuestions(
341
+ defineCurrentTurnCapabilities({ nativeTools: ['ask_user_question'], spawnModelIds: [] }),
342
+ [plannerQuestion('delivery', {
343
+ options: [
344
+ { id: 'long', label: 'x'.repeat(60), description: 'Exact native maximum.' },
345
+ { id: 'queue', label: 'Queue', description: 'Use the merge queue.' },
346
+ ],
347
+ recommendationOrder: ['queue'],
348
+ })],
349
+ );
350
+ assert.equal(piPlan.calls[0].payload.questions[0].options[1].label.length, 60);
351
+ assert.deepEqual(normalizeQuestionResponses(piPlan, [{
352
+ details: {
353
+ answers: [{
354
+ questionIndex: 0,
355
+ question: 'How should delivery proceed?',
356
+ kind: 'custom',
357
+ answer: 'Queue',
358
+ }],
359
+ cancelled: false,
360
+ },
361
+ }]), { delivery: ['Queue'] });
362
+
363
+ for (const nativeTool of ['request_user_input', 'AskUserQuestion']) {
364
+ const plan = planStructuredQuestions(
365
+ defineCurrentTurnCapabilities({ nativeTools: [nativeTool], spawnModelIds: [] }),
366
+ [plannerQuestion('delivery')],
367
+ );
368
+ const response = nativeTool === 'request_user_input'
369
+ ? { answers: { delivery: { answers: ['Ship after lunch'] } } }
370
+ : { answers: { 'How should delivery proceed?': 'Ship after lunch' } };
371
+ assert.deepEqual(normalizeQuestionResponses(plan, [response]), {
372
+ delivery: ['Ship after lunch'],
373
+ });
374
+ }
375
+
376
+ const malformedPlan = structuredClone(planStructuredQuestions(
377
+ defineCurrentTurnCapabilities({ nativeTools: ['request_user_input'], spawnModelIds: [] }),
378
+ [plannerQuestion('delivery')],
379
+ ));
380
+ malformedPlan.calls[0].answerMappings[0].options[1].label = 'Queue (Recommended)';
381
+ assert.throws(
382
+ () => normalizeQuestionResponses(malformedPlan, [{
383
+ answers: { delivery: { answers: ['Queue (Recommended)'] } },
384
+ }]),
385
+ (error) => error instanceof HarnessRuntimeError
386
+ && error.code === HARNESS_RUNTIME_ERROR_CODES.INVALID_ANSWERS
387
+ && error.details.reason === 'ambiguous-option-label'
388
+ && error.details.questionId === 'delivery'
389
+ && error.details.optionIds.join(',') === 'queue,direct',
390
+ );
391
+ });
392
+
393
+ // @covers package:harness-runtime
394
+ // @level unit
395
+ test('Claude Code planning uses native field names and groups four questions per call', () => {
396
+ const capabilities = defineCurrentTurnCapabilities({
397
+ nativeTools: ['AskUserQuestion'],
398
+ spawnModelIds: [],
399
+ });
400
+ const questions = Array.from({ length: 5 }, (_, index) => plannerQuestion(`gate-${index + 1}`, {
401
+ multiSelect: index === 0,
402
+ }));
403
+ const plan = planStructuredQuestions(capabilities, questions);
404
+
405
+ assert.equal(plan.adapter, 'claude-code');
406
+ assert.equal(plan.toolName, 'AskUserQuestion');
407
+ assert.equal(plan.capacity, 4);
408
+ assert.equal(plan.requiresMultipleCalls, true);
409
+ assert.deepEqual(plan.calls.map((call) => call.questionIds), [
410
+ ['gate-1', 'gate-2', 'gate-3', 'gate-4'],
411
+ ['gate-5'],
412
+ ]);
413
+ assert.deepEqual(plan.calls[0].payload.questions[0], {
414
+ question: 'How should gate-1 proceed?',
415
+ header: 'Delivery',
416
+ options: [
417
+ { label: 'Queue', description: 'Use the merge queue.' },
418
+ { label: 'Direct', description: 'Proceed directly.' },
419
+ ],
420
+ multiSelect: true,
421
+ });
422
+ });
423
+
424
+ // @covers package:harness-runtime
425
+ // @level unit
426
+ test('no-adapter planning distinguishes concise free text from forbidden textual choices', () => {
427
+ const capabilities = defineCurrentTurnCapabilities({
428
+ nativeTools: ['functions'],
429
+ spawnModelIds: [],
430
+ });
431
+ const freeText = planStructuredQuestions(capabilities, [plannerQuestion('context', {
432
+ prompt: 'What context is missing?',
433
+ options: [],
434
+ recommendationOrder: [],
435
+ })]);
436
+ assert.deepEqual(freeText, {
437
+ kind: 'fallback',
438
+ adapter: null,
439
+ reason: 'no-supported-native-question-tool',
440
+ decision: 'concise-free-text',
441
+ freeText: {
442
+ allowed: true,
443
+ questionId: 'context',
444
+ prompt: 'What context is missing?',
445
+ },
446
+ textualMultipleChoice: {
447
+ allowed: false,
448
+ reason: 'forbidden',
449
+ },
450
+ availableTools: ['functions'],
451
+ });
452
+ assert.ok(Object.isFrozen(freeText.freeText));
453
+
454
+ const forbidden = planStructuredQuestions(capabilities, [plannerQuestion('delivery')]);
455
+ assert.equal(forbidden.kind, 'fallback');
456
+ assert.equal(forbidden.decision, 'textual-multiple-choice-forbidden');
457
+ assert.deepEqual(forbidden.freeText, {
458
+ allowed: false,
459
+ reason: 'logical-question-has-options',
460
+ });
461
+ const multipleFreeText = planStructuredQuestions(capabilities, [
462
+ plannerQuestion('first_context', { options: [], recommendationOrder: [] }),
463
+ plannerQuestion('second_context', { options: [], recommendationOrder: [] }),
464
+ ]);
465
+ assert.deepEqual(multipleFreeText.freeText, {
466
+ allowed: false,
467
+ reason: 'multiple-questions',
468
+ });
469
+ assert.deepEqual(forbidden.textualMultipleChoice, {
470
+ allowed: false,
471
+ reason: 'forbidden',
472
+ });
473
+
474
+ assert.throws(
475
+ () => planStructuredQuestions(capabilities, [plannerQuestion('token', {
476
+ options: [],
477
+ recommendationOrder: [],
478
+ secret: true,
479
+ })]),
480
+ (error) => error instanceof UnsupportedQuestionError
481
+ && error.reason === 'secret-input',
482
+ );
483
+ assert.throws(
484
+ () => planStructuredQuestions(capabilities, [plannerQuestion('features', {
485
+ options: [],
486
+ recommendationOrder: [],
487
+ multiSelect: true,
488
+ })]),
489
+ (error) => error instanceof UnsupportedQuestionError
490
+ && error.reason === 'multi-select',
491
+ );
492
+ });
493
+
494
+ // @covers package:harness-runtime
495
+ // @level unit
496
+ test('native adapters enforce exact capacities, field limits, and option invariants', () => {
497
+ const adapters = [
498
+ { tool: 'ask_user_question', capacity: 4, headerLimit: 16, optionLimit: 4 },
499
+ { tool: 'request_user_input', capacity: 3, headerLimit: 12, optionLimit: 3 },
500
+ { tool: 'AskUserQuestion', capacity: 4, headerLimit: 12, optionLimit: 4 },
501
+ ];
502
+ for (const { tool, capacity, headerLimit, optionLimit } of adapters) {
503
+ const capabilities = defineCurrentTurnCapabilities({ nativeTools: [tool], spawnModelIds: [] });
504
+ const exactCapacity = Array.from({ length: capacity }, (_, index) =>
505
+ plannerQuestion(`gate_${index + 1}`, { header: 'x'.repeat(headerLimit) }));
506
+ const plan = planStructuredQuestions(capabilities, exactCapacity);
507
+ assert.deepEqual(plan.batching, { required: false, reason: null, callCount: 1 });
508
+
509
+ const maximumOptions = Array.from({ length: optionLimit }, (_, index) => ({
510
+ id: `choice_${index + 1}`,
511
+ label: `Choice ${index + 1}`,
512
+ description: `Choose ${index + 1}.`,
513
+ }));
514
+ assert.equal(planStructuredQuestions(capabilities, [plannerQuestion('options', {
515
+ options: maximumOptions,
516
+ recommendationOrder: [],
517
+ })]).kind, 'native');
518
+ assert.throws(
519
+ () => planStructuredQuestions(capabilities, [plannerQuestion('too_many', {
520
+ options: [...maximumOptions, {
521
+ id: 'overflow',
522
+ label: 'Overflow',
523
+ description: 'Exceeds the native limit.',
524
+ }],
525
+ recommendationOrder: [],
526
+ })]),
527
+ (error) => error instanceof UnsupportedQuestionError && error.reason === 'option-count',
528
+ );
529
+ assert.throws(
530
+ () => planStructuredQuestions(capabilities, [plannerQuestion('long_header', {
531
+ header: 'x'.repeat(headerLimit + 1),
532
+ })]),
533
+ (error) => error instanceof UnsupportedQuestionError && error.reason === 'header-too-long',
534
+ );
535
+ assert.throws(
536
+ () => planStructuredQuestions(capabilities, [plannerQuestion('duplicate_label', {
537
+ options: [
538
+ { id: 'first', label: 'Same', description: 'First.' },
539
+ { id: 'second', label: 'Same', description: 'Second.' },
540
+ ],
541
+ recommendationOrder: [],
542
+ })]),
543
+ (error) => error instanceof HarnessRuntimeError
544
+ && error.details.reason === 'duplicate-option-label',
545
+ );
546
+ assert.throws(
547
+ () => planStructuredQuestions(capabilities, [plannerQuestion('description', {
548
+ options: [
549
+ { id: 'first', label: 'First' },
550
+ { id: 'second', label: 'Second', description: 'Second.' },
551
+ ],
552
+ recommendationOrder: [],
553
+ })]),
554
+ (error) => error instanceof UnsupportedQuestionError
555
+ && error.reason === 'option-description-required',
556
+ );
557
+ }
558
+ });
559
+
560
+ // @covers package:harness-runtime
561
+ // @level unit
562
+ test('malformed neutral specs and unsupported native inputs fail before invocation', () => {
563
+ const capabilities = defineCurrentTurnCapabilities({
564
+ nativeTools: ['ask_user_question'],
565
+ spawnModelIds: [],
566
+ });
567
+ for (const questions of [null, []]) {
568
+ assert.throws(
569
+ () => planStructuredQuestions(capabilities, questions),
570
+ (error) => error instanceof HarnessRuntimeError
571
+ && error.details.reason === 'empty-question-batch',
572
+ );
573
+ }
574
+ assert.throws(
575
+ () => planStructuredQuestions(capabilities, [plannerQuestion('duplicate_options', {
576
+ options: [
577
+ { id: 'same', label: 'First', description: 'First.' },
578
+ { id: 'same', label: 'Second', description: 'Second.' },
579
+ ],
580
+ recommendationOrder: [],
581
+ })]),
582
+ (error) => error instanceof HarnessRuntimeError
583
+ && error.code === HARNESS_RUNTIME_ERROR_CODES.INVALID_QUESTION,
584
+ );
585
+ assert.throws(
586
+ () => planStructuredQuestions(capabilities, [plannerQuestion('recommendation', {
587
+ recommendationOrder: ['missing'],
588
+ })]),
589
+ (error) => error instanceof HarnessRuntimeError
590
+ && error.code === HARNESS_RUNTIME_ERROR_CODES.INVALID_QUESTION,
591
+ );
592
+ assert.throws(
593
+ () => planStructuredQuestions(capabilities, [plannerQuestion('boolean', {
594
+ multiSelect: 'yes',
595
+ })]),
596
+ (error) => error instanceof HarnessRuntimeError
597
+ && error.code === HARNESS_RUNTIME_ERROR_CODES.INVALID_QUESTION,
598
+ );
599
+ for (const nativeTool of QUESTION_ADAPTER_PRIORITY) {
600
+ const nativeCapabilities = defineCurrentTurnCapabilities({
601
+ nativeTools: [nativeTool],
602
+ spawnModelIds: [],
603
+ });
604
+ assert.throws(
605
+ () => planStructuredQuestions(nativeCapabilities, [plannerQuestion('empty', {
606
+ options: [],
607
+ recommendationOrder: [],
608
+ })]),
609
+ (error) => error instanceof UnsupportedQuestionError
610
+ && error.reason === 'option-count',
611
+ );
612
+ assert.throws(
613
+ () => planStructuredQuestions(nativeCapabilities, [plannerQuestion('secret', { secret: true })]),
614
+ (error) => error instanceof UnsupportedQuestionError
615
+ && error.reason === 'secret-input',
616
+ );
617
+ }
618
+ });
619
+
620
+ // @covers package:harness-runtime
621
+ // @level unit
622
+ test('all native response fixtures normalize selected labels and custom text to neutral ids', () => {
623
+ const adapters = [
624
+ { adapter: 'pi', nativeTool: 'ask_user_question' },
625
+ { adapter: 'codex', nativeTool: 'request_user_input' },
626
+ { adapter: 'claude-code', nativeTool: 'AskUserQuestion' },
627
+ ];
628
+ for (const { adapter, nativeTool } of adapters) {
629
+ const plan = planStructuredQuestions(
630
+ defineCurrentTurnCapabilities({ nativeTools: [nativeTool], spawnModelIds: [] }),
631
+ [plannerQuestion('delivery'), plannerQuestion('context')],
632
+ );
633
+ const answers = normalizeQuestionResponses(plan, [QUESTION_RESPONSE_FIXTURES[adapter].success]);
634
+ assert.deepEqual(answers, {
635
+ delivery: ['queue'],
636
+ context: ['After lunch'],
637
+ });
638
+ assert.ok(Object.isFrozen(answers));
639
+ assert.ok(Object.isFrozen(answers.delivery));
640
+ }
641
+ });
642
+
643
+ // @covers package:harness-runtime
644
+ // @level unit
645
+ test('Pi and Claude multi-select responses normalize to the same option-id arrays', () => {
646
+ for (const [adapter, nativeTool] of [
647
+ ['pi', 'ask_user_question'],
648
+ ['claude-code', 'AskUserQuestion'],
649
+ ]) {
650
+ const plan = planStructuredQuestions(
651
+ defineCurrentTurnCapabilities({ nativeTools: [nativeTool], spawnModelIds: [] }),
652
+ [plannerQuestion('features', { multiSelect: true })],
653
+ );
654
+ assert.deepEqual(
655
+ normalizeQuestionResponses(plan, [QUESTION_RESPONSE_FIXTURES[adapter].multi]),
656
+ { features: ['queue', 'direct'] },
657
+ );
658
+ }
659
+ });
660
+
661
+ // @covers package:harness-runtime
662
+ // @level unit
663
+ test('cancellation discards partial gates and malformed native responses fail closed', () => {
664
+ for (const [adapter, nativeTool] of [
665
+ ['pi', 'ask_user_question'],
666
+ ['codex', 'request_user_input'],
667
+ ['claude-code', 'AskUserQuestion'],
668
+ ]) {
669
+ const plan = planStructuredQuestions(
670
+ defineCurrentTurnCapabilities({ nativeTools: [nativeTool], spawnModelIds: [] }),
671
+ [plannerQuestion('delivery')],
672
+ );
673
+ assert.deepEqual(
674
+ normalizeQuestionResponses(plan, [QUESTION_RESPONSE_FIXTURES[adapter].cancelled]),
675
+ {},
676
+ );
677
+ }
678
+
679
+ const batchedPiPlan = planStructuredQuestions(
680
+ defineCurrentTurnCapabilities({ nativeTools: ['ask_user_question'], spawnModelIds: [] }),
681
+ Array.from({ length: 5 }, (_, index) => plannerQuestion(`gate-${index + 1}`)),
682
+ );
683
+ const completedFirstCall = {
684
+ details: {
685
+ answers: batchedPiPlan.calls[0].answerMappings.map((mapping, questionIndex) => ({
686
+ questionIndex,
687
+ question: mapping.prompt,
688
+ kind: 'option',
689
+ answer: 'Queue',
690
+ })),
691
+ cancelled: false,
692
+ },
693
+ };
694
+ assert.deepEqual(normalizeQuestionResponses(batchedPiPlan, [
695
+ completedFirstCall,
696
+ QUESTION_RESPONSE_FIXTURES.pi.cancelled,
697
+ ]), {});
698
+
699
+ const codexPlan = planStructuredQuestions(
700
+ defineCurrentTurnCapabilities({ nativeTools: ['request_user_input'], spawnModelIds: [] }),
701
+ [plannerQuestion('delivery')],
702
+ );
703
+ assert.throws(
704
+ () => normalizeQuestionResponses(codexPlan, [{
705
+ answers: { unknown: { answers: ['Queue'] } },
706
+ }]),
707
+ (error) => error instanceof HarnessRuntimeError
708
+ && error.code === HARNESS_RUNTIME_ERROR_CODES.INVALID_ANSWERS,
709
+ );
710
+ assert.throws(
711
+ () => normalizeQuestionResponses(codexPlan, [{
712
+ answers: { delivery: { answers: [] } },
713
+ }]),
714
+ (error) => error instanceof HarnessRuntimeError
715
+ && error.code === HARNESS_RUNTIME_ERROR_CODES.INVALID_ANSWERS,
716
+ );
717
+ });
718
+
719
+ // @covers package:harness-runtime
720
+ // @level unit
721
+ test('malformed and incomplete native responses fail closed', () => {
722
+ const plans = Object.fromEntries([
723
+ ['pi', 'ask_user_question'],
724
+ ['codex', 'request_user_input'],
725
+ ['claude-code', 'AskUserQuestion'],
726
+ ].map(([adapter, tool]) => [adapter, planStructuredQuestions(
727
+ defineCurrentTurnCapabilities({ nativeTools: [tool], spawnModelIds: [] }),
728
+ [plannerQuestion('delivery'), plannerQuestion('context')],
729
+ )]));
730
+
731
+ assert.throws(
732
+ () => normalizeQuestionResponses({}, []),
733
+ (error) => error instanceof HarnessRuntimeError
734
+ && error.details.reason === 'invalid-question-plan',
735
+ );
736
+ for (const responses of [null, []]) {
737
+ assert.throws(
738
+ () => normalizeQuestionResponses(plans.pi, responses),
739
+ (error) => error instanceof HarnessRuntimeError
740
+ && error.details.reason === 'response-count',
741
+ );
742
+ }
743
+ const malformedResponses = [
744
+ [plans.pi, {}],
745
+ [plans.pi, { details: { answers: [
746
+ {
747
+ questionIndex: 0,
748
+ question: 'How should delivery proceed?',
749
+ kind: 'option',
750
+ answer: 'Queue',
751
+ },
752
+ {
753
+ questionIndex: 0,
754
+ question: 'How should delivery proceed?',
755
+ kind: 'option',
756
+ answer: 'Queue',
757
+ },
758
+ ], cancelled: false } }],
759
+ [plans.pi, { details: { answers: [{
760
+ questionIndex: 0,
761
+ question: 'How should delivery proceed?',
762
+ kind: 'multi',
763
+ selected: ['Queue'],
764
+ }], cancelled: false } }],
765
+ [plans.pi, { details: { answers: [{
766
+ questionIndex: 0,
767
+ question: 'How should delivery proceed?',
768
+ kind: 'option',
769
+ answer: 'Missing option',
770
+ }], cancelled: false } }],
771
+ [plans.pi, { details: { answers: [{
772
+ questionIndex: 0,
773
+ question: 'How should delivery proceed?',
774
+ kind: 'custom',
775
+ answer: '',
776
+ }], cancelled: false } }],
777
+ [plans.pi, { details: { answers: [{
778
+ questionIndex: 0,
779
+ question: 'Wrong prompt',
780
+ kind: 'option',
781
+ answer: 'Queue',
782
+ }], cancelled: false } }],
783
+ [plans.pi, { details: { answers: [{
784
+ questionIndex: 0,
785
+ question: 'How should delivery proceed?',
786
+ kind: 'unknown',
787
+ answer: 'Queue',
788
+ }], cancelled: false } }],
789
+ [plans.codex, {}],
790
+ [plans.codex, { answers: { delivery: { answers: [''] } } }],
791
+ [plans.codex, { answers: { delivery: { answers: ['Queue (Recommended)', 'Direct'] } } }],
792
+ [plans['claude-code'], {}],
793
+ [plans['claude-code'], { answers: { 'Unknown prompt': 'Queue' } }],
794
+ ];
795
+ for (const [plan, response] of malformedResponses) {
796
+ assert.throws(
797
+ () => normalizeQuestionResponses(plan, [response]),
798
+ (error) => error instanceof HarnessRuntimeError
799
+ && error.code === HARNESS_RUNTIME_ERROR_CODES.INVALID_ANSWERS,
800
+ );
801
+ }
802
+
803
+ const partialResponses = [
804
+ [plans.pi, { details: { answers: [{
805
+ questionIndex: 0,
806
+ question: 'How should delivery proceed?',
807
+ kind: 'option',
808
+ answer: 'Queue',
809
+ }], cancelled: false } }],
810
+ [plans.codex, { answers: { delivery: { answers: ['Queue'] } } }],
811
+ [plans['claude-code'], { answers: { 'How should delivery proceed?': 'Queue' } }],
812
+ ];
813
+ for (const [plan, response] of partialResponses) {
814
+ assert.throws(
815
+ () => normalizeQuestionResponses(plan, [response]),
816
+ (error) => error instanceof HarnessRuntimeError
817
+ && error.details.reason === 'incomplete-native-response',
818
+ );
819
+ }
820
+
821
+ assert.throws(
822
+ () => planStructuredQuestions(
823
+ defineCurrentTurnCapabilities({ nativeTools: ['AskUserQuestion'], spawnModelIds: [] }),
824
+ [plannerQuestion('ambiguous', {
825
+ multiSelect: true,
826
+ options: [
827
+ { id: 'a', label: 'A', description: 'A.' },
828
+ { id: 'b', label: 'B', description: 'B.' },
829
+ { id: 'combined', label: 'A, B', description: 'Combined.' },
830
+ ],
831
+ recommendationOrder: [],
832
+ })],
833
+ ),
834
+ (error) => error instanceof HarnessRuntimeError
835
+ && error.details.reason === 'native-answer-format-collision',
836
+ );
837
+
838
+ const duplicatePlan = structuredClone(planStructuredQuestions(
839
+ defineCurrentTurnCapabilities({ nativeTools: ['ask_user_question'], spawnModelIds: [] }),
840
+ Array.from({ length: 5 }, (_, index) => plannerQuestion(`gate-${index + 1}`)),
841
+ ));
842
+ duplicatePlan.calls[1].answerMappings[0].questionId = 'gate-1';
843
+ const duplicateResponses = duplicatePlan.calls.map((call) => ({
844
+ details: {
845
+ answers: call.answerMappings.map((mapping, questionIndex) => ({
846
+ questionIndex,
847
+ question: mapping.prompt,
848
+ kind: 'option',
849
+ answer: 'Queue',
850
+ })),
851
+ cancelled: false,
852
+ },
853
+ }));
854
+ assert.throws(
855
+ () => normalizeQuestionResponses(duplicatePlan, duplicateResponses),
856
+ (error) => error instanceof HarnessRuntimeError
857
+ && error.details.reason === 'duplicate-question-answer',
858
+ );
859
+ });
860
+
861
+ // @covers package:harness-runtime
862
+ // @level unit
863
+ test('malformed prompt and Pi sentinel collisions are rejected before native invocation', () => {
864
+ const capabilities = defineCurrentTurnCapabilities({
865
+ nativeTools: ['ask_user_question'],
866
+ spawnModelIds: [],
867
+ });
868
+ assert.throws(
869
+ () => planStructuredQuestions(capabilities, [
870
+ plannerQuestion('first', { prompt: 'Same prompt?' }),
871
+ plannerQuestion('second', { prompt: 'Same prompt?' }),
872
+ ]),
873
+ (error) => error instanceof HarnessRuntimeError
874
+ && error.code === HARNESS_RUNTIME_ERROR_CODES.INVALID_QUESTION
875
+ && error.details.reason === 'duplicate-question-prompt',
876
+ );
877
+ for (const [index, label] of NATIVE_QUESTION_SCHEMAS.pi.reservedLabels.entries()) {
878
+ assert.throws(
879
+ () => planStructuredQuestions(capabilities, [plannerQuestion(`reserved-${index}`, {
880
+ options: [
881
+ { id: 'reserved', label, description: 'Conflicts with native UI.' },
882
+ { id: 'direct', label: 'Direct', description: 'Proceed directly.' },
883
+ ],
884
+ recommendationOrder: [],
885
+ })]),
886
+ (error) => error instanceof UnsupportedQuestionError
887
+ && error.reason === 'reserved-option-label',
888
+ );
889
+ }
890
+ });
891
+
892
+ // @covers package:harness-runtime
893
+ // @level integration
894
+ test('pinned native schemas and Codex operator docs separate configuration from capability', () => {
895
+ assert.equal(NATIVE_QUESTION_SCHEMAS.pi.questions.maximum, 4);
896
+ assert.equal(NATIVE_QUESTION_SCHEMAS.codex.questions.maximum, 3);
897
+ assert.equal(NATIVE_QUESTION_SCHEMAS.codex.recommendationLabelSuffix, ' (Recommended)');
898
+ assert.equal(NATIVE_QUESTION_SCHEMAS['claude-code'].questions.maximum, 4);
899
+ const contracts = readFileSync(join(RUNTIME_DIR, 'native-question-contracts.md'), 'utf8');
900
+ const codexDocs = readFileSync(join(RUNTIME_DIR, '..', '..', '..', 'agents', 'systems', 'codex.md'), 'utf8');
901
+ assert.match(contracts, /current-turn nativeTools/);
902
+ assert.match(contracts, /secret input/i);
903
+ assert.match(contracts, /textual multiple-choice/i);
904
+ for (const label of NATIVE_QUESTION_SCHEMAS.pi.reservedLabels) assert.match(contracts, new RegExp(label.replace('.', '\\.')));
905
+ for (const schema of Object.values(NATIVE_QUESTION_SCHEMAS)) assert.match(contracts, new RegExp(schema.toolName));
906
+
907
+ const packageContracts = readFileSync(join(RUNTIME_DIR, 'contracts.md'), 'utf8');
908
+ for (const name of [
909
+ 'defineCurrentTurnCapabilities',
910
+ 'defineQuestionSpec',
911
+ 'defineQuestionAnswers',
912
+ 'defineModelAvailability',
913
+ 'planStructuredQuestions',
914
+ 'normalizeQuestionResponses',
915
+ 'discover-models.mjs',
916
+ 'model-catalog.mjs',
917
+ ]) assert.match(packageContracts, new RegExp(name.replace('.', '\\.')));
918
+
919
+ const catalogPath = join(RUNTIME_DIR, 'references', 'model-catalog.md');
920
+ const catalog = readFileSync(catalogPath, 'utf8');
921
+ for (const match of catalog.matchAll(/\[[^\]]+\]\(([^)]+)\)/g)) {
922
+ if (/^(?:https?:|#)/.test(match[1])) continue;
923
+ assert.ok(existsSync(resolve(dirname(catalogPath), match[1])), `broken model-catalog.md link: ${match[1]}`);
924
+ }
925
+ assert.doesNotMatch(catalog, /SKILL\.md pre-flight|\[pre-flight\.md\]\(pre-flight\.md\)/);
926
+
927
+ assert.match(codexDocs, /default_mode_request_user_input = true/);
928
+ assert.match(codexDocs, /does not prove.*available/i);
929
+ assert.match(codexDocs, /current-turn tool list/i);
930
+ });
931
+
932
+ function runConsumer(script) {
933
+ return spawnSync(process.execPath, [script], { encoding: 'utf8' });
934
+ }
935
+
936
+ // @covers package:harness-runtime
937
+ // @level integration
938
+ test('the same consumer specifier resolves harness-runtime in nested source and flat installs', () => {
939
+ const root = mkdtempSync(join(tmpdir(), 'harness-runtime-resolution-'));
940
+ try {
941
+ const layouts = [
942
+ {
943
+ runtime: join(root, 'source', 'skills', 'engineering', 'harness-runtime'),
944
+ consumer: join(root, 'source', 'skills', 'engineering', 'resolve-issues', 'scripts', 'consumer.mjs'),
945
+ },
946
+ {
947
+ runtime: join(root, 'flat', 'harness-runtime'),
948
+ consumer: join(root, 'flat', 'resolve-issues', 'scripts', 'consumer.mjs'),
949
+ },
950
+ ];
951
+ for (const layout of layouts) {
952
+ cpSync(RUNTIME_DIR, layout.runtime, { recursive: true });
953
+ mkdirSync(dirname(layout.consumer), { recursive: true });
954
+ writeFileSync(layout.consumer, [
955
+ "import { defineCurrentTurnCapabilities } from '../../harness-runtime/index.mjs';",
956
+ "const value = defineCurrentTurnCapabilities({ nativeTools: ['native'], spawnModelIds: ['model'] });",
957
+ 'process.stdout.write(JSON.stringify(value));',
958
+ '',
959
+ ].join('\n'));
960
+ const result = runConsumer(layout.consumer);
961
+ assert.equal(result.status, 0, result.stderr);
962
+ assert.deepEqual(JSON.parse(result.stdout), { nativeTools: ['native'], spawnModelIds: ['model'] });
963
+ }
964
+ } finally {
965
+ rmSync(root, { recursive: true, force: true });
966
+ }
967
+ });