@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,221 @@
1
+ #!/usr/bin/env python3
2
+ """Export a compliance audit tracker (tracker.md) to an Excel workbook.
3
+
4
+ Usage:
5
+ python3 export_tracker_xlsx.py <tracker.md> [--output tracker.xlsx]
6
+
7
+ Writes two sheets:
8
+ Tracker one row per Control ID, columns as in the markdown table header.
9
+ ``<br>`` becomes an in-cell line break; ``**bold**`` markers are
10
+ dropped. Header row is bold and frozen; long cells wrap.
11
+ Metadata the ``- **Key:** value`` lines of the tracker header.
12
+
13
+ tracker.md stays the source of truth: re-run this after every change to it
14
+ (reconciliation, normalization, remediation updates). Standard library only.
15
+ """
16
+ from __future__ import annotations
17
+
18
+ import argparse
19
+ import html
20
+ import re
21
+ import sys
22
+ import zipfile
23
+ from pathlib import Path
24
+ from xml.sax.saxutils import escape
25
+
26
+ TABLE_ROW_RE = re.compile(r"^\s*\|.*\|\s*$")
27
+ SEPARATOR_RE = re.compile(r"^\s*\|?(?:\s*:?-+:?\s*\|)+\s*:?-*:?\s*$")
28
+ META_RE = re.compile(r"^\s*[-*]\s+\*\*(?P<key>[^*]+?):?\*\*:?\s*(?P<value>.*)$")
29
+ BR_RE = re.compile(r"<br\s*/?>", re.IGNORECASE)
30
+ # Characters XML 1.0 forbids; a stray one makes Excel refuse the whole file.
31
+ INVALID_XML_RE = re.compile(r"[\x00-\x08\x0b\x0c\x0e-\x1f]")
32
+
33
+ # Width in Excel character units for known columns; others get DEFAULT_WIDTH.
34
+ COLUMN_WIDTHS = {
35
+ "control id": 14,
36
+ "control title": 28,
37
+ "archetype": 11,
38
+ "observations": 70,
39
+ "issue description": 60,
40
+ "control effectiveness rating": 18,
41
+ "effectiveness": 16,
42
+ "proposed remediation": 40,
43
+ "complete by": 13,
44
+ "remediation status": 30,
45
+ }
46
+ DEFAULT_WIDTH = 24
47
+ MAX_WIDTH = 100
48
+
49
+
50
+ def split_row(line: str) -> list[str]:
51
+ """Split a markdown table row on unescaped pipes."""
52
+ body = line.strip()
53
+ if body.startswith("|"):
54
+ body = body[1:]
55
+ if body.endswith("|") and not body.endswith("\\|"):
56
+ body = body[:-1]
57
+ cells = re.split(r"(?<!\\)\|", body)
58
+ return [c.strip().replace("\\|", "|") for c in cells]
59
+
60
+
61
+ def cell_text(raw: str) -> str:
62
+ text = BR_RE.sub("\n", raw)
63
+ text = re.sub(r"\*\*(.+?)\*\*", r"\1", text, flags=re.S)
64
+ text = html.unescape(text)
65
+ text = "\n".join(part.strip() for part in text.split("\n"))
66
+ return INVALID_XML_RE.sub("", text)
67
+
68
+
69
+ def parse_tracker(text: str) -> tuple[list[tuple[str, str]], list[str], list[list[str]]]:
70
+ """Return (metadata pairs, header, rows) from the first table in tracker.md."""
71
+ metadata: list[tuple[str, str]] = []
72
+ header: list[str] = []
73
+ rows: list[list[str]] = []
74
+ lines = text.splitlines()
75
+ i = 0
76
+ while i < len(lines):
77
+ line = lines[i]
78
+ if not header:
79
+ m = META_RE.match(line)
80
+ if m:
81
+ metadata.append((m.group("key").strip(), cell_text(m.group("value").strip())))
82
+ elif TABLE_ROW_RE.match(line) and i + 1 < len(lines) and SEPARATOR_RE.match(lines[i + 1]):
83
+ header = [cell_text(c) for c in split_row(line)]
84
+ i += 2
85
+ continue
86
+ else:
87
+ if not TABLE_ROW_RE.match(line):
88
+ break
89
+ cells = [cell_text(c) for c in split_row(line)]
90
+ cells += [""] * (len(header) - len(cells))
91
+ rows.append(cells[: len(header)])
92
+ i += 1
93
+ return metadata, header, rows
94
+
95
+
96
+ def column_letter(index: int) -> str:
97
+ letters = ""
98
+ index += 1
99
+ while index:
100
+ index, rem = divmod(index - 1, 26)
101
+ letters = chr(65 + rem) + letters
102
+ return letters
103
+
104
+
105
+ def sheet_xml(rows: list[list[str]], widths: list[int], freeze_header: bool) -> str:
106
+ out = ['<?xml version="1.0" encoding="UTF-8" standalone="yes"?>',
107
+ '<worksheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">']
108
+ if freeze_header:
109
+ out.append('<sheetViews><sheetView workbookViewId="0"><pane ySplit="1" topLeftCell="A2" '
110
+ 'activePane="bottomLeft" state="frozen"/></sheetView></sheetViews>')
111
+ out.append("<cols>")
112
+ for n, width in enumerate(widths, start=1):
113
+ out.append(f'<col min="{n}" max="{n}" width="{width}" customWidth="1"/>')
114
+ out.append("</cols><sheetData>")
115
+ for r, row in enumerate(rows, start=1):
116
+ style = 1 if r == 1 else 2 # 1 = bold header, 2 = wrapped body
117
+ out.append(f'<row r="{r}">')
118
+ for c, value in enumerate(row):
119
+ ref = f"{column_letter(c)}{r}"
120
+ out.append(f'<c r="{ref}" s="{style}" t="inlineStr"><is><t xml:space="preserve">'
121
+ f"{escape(value)}</t></is></c>")
122
+ out.append("</row>")
123
+ out.append("</sheetData>")
124
+ if freeze_header and rows:
125
+ out.append(f'<autoFilter ref="A1:{column_letter(len(rows[0]) - 1)}{len(rows)}"/>')
126
+ out.append("</worksheet>")
127
+ return "".join(out)
128
+
129
+
130
+ STYLES_XML = (
131
+ '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
132
+ '<styleSheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">'
133
+ '<fonts count="2"><font><sz val="11"/><name val="Calibri"/></font>'
134
+ '<font><b/><sz val="11"/><name val="Calibri"/></font></fonts>'
135
+ '<fills count="2"><fill><patternFill patternType="none"/></fill>'
136
+ '<fill><patternFill patternType="gray125"/></fill></fills>'
137
+ '<borders count="1"><border><left/><right/><top/><bottom/><diagonal/></border></borders>'
138
+ '<cellStyleXfs count="1"><xf numFmtId="0" fontId="0" fillId="0" borderId="0"/></cellStyleXfs>'
139
+ '<cellXfs count="3">'
140
+ '<xf numFmtId="0" fontId="0" fillId="0" borderId="0" xfId="0"/>'
141
+ '<xf numFmtId="0" fontId="1" fillId="0" borderId="0" xfId="0" applyFont="1" applyAlignment="1">'
142
+ '<alignment vertical="top" wrapText="1"/></xf>'
143
+ '<xf numFmtId="0" fontId="0" fillId="0" borderId="0" xfId="0" applyAlignment="1">'
144
+ '<alignment vertical="top" wrapText="1"/></xf>'
145
+ "</cellXfs>"
146
+ '<cellStyles count="1"><cellStyle name="Normal" xfId="0" builtinId="0"/></cellStyles>'
147
+ "</styleSheet>"
148
+ )
149
+
150
+
151
+ def write_xlsx(path: Path, sheets: list[tuple[str, str]]) -> None:
152
+ content_types = ['<?xml version="1.0" encoding="UTF-8" standalone="yes"?>',
153
+ '<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">',
154
+ '<Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>',
155
+ '<Default Extension="xml" ContentType="application/xml"/>',
156
+ '<Override PartName="/xl/workbook.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml"/>',
157
+ '<Override PartName="/xl/styles.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml"/>']
158
+ workbook = ['<?xml version="1.0" encoding="UTF-8" standalone="yes"?>',
159
+ '<workbook xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" '
160
+ 'xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"><sheets>']
161
+ rels = ['<?xml version="1.0" encoding="UTF-8" standalone="yes"?>',
162
+ '<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">']
163
+ for n, (name, _) in enumerate(sheets, start=1):
164
+ content_types.append(f'<Override PartName="/xl/worksheets/sheet{n}.xml" '
165
+ 'ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml"/>')
166
+ workbook.append(f'<sheet name="{escape(name)}" sheetId="{n}" r:id="rId{n}"/>')
167
+ rels.append(f'<Relationship Id="rId{n}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet" '
168
+ f'Target="worksheets/sheet{n}.xml"/>')
169
+ rels.append(f'<Relationship Id="rId{len(sheets) + 1}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles" '
170
+ 'Target="styles.xml"/>')
171
+ content_types.append("</Types>")
172
+ workbook.append("</sheets></workbook>")
173
+ rels.append("</Relationships>")
174
+ root_rels = ('<?xml version="1.0" encoding="UTF-8" standalone="yes"?>'
175
+ '<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">'
176
+ '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" '
177
+ 'Target="xl/workbook.xml"/></Relationships>')
178
+ with zipfile.ZipFile(path, "w", zipfile.ZIP_DEFLATED) as zf:
179
+ zf.writestr("[Content_Types].xml", "".join(content_types))
180
+ zf.writestr("_rels/.rels", root_rels)
181
+ zf.writestr("xl/workbook.xml", "".join(workbook))
182
+ zf.writestr("xl/_rels/workbook.xml.rels", "".join(rels))
183
+ zf.writestr("xl/styles.xml", STYLES_XML)
184
+ for n, (_, xml) in enumerate(sheets, start=1):
185
+ zf.writestr(f"xl/worksheets/sheet{n}.xml", xml)
186
+
187
+
188
+ def export(tracker: Path, output: Path) -> tuple[int, int]:
189
+ metadata, header, rows = parse_tracker(tracker.read_text(encoding="utf-8"))
190
+ if not header:
191
+ raise ValueError(f"no markdown table found in {tracker}")
192
+ if not rows:
193
+ raise ValueError(f"tracker table in {tracker} has no control rows")
194
+ widths = []
195
+ for c, name in enumerate(header):
196
+ longest = max((len(line) for row in rows for line in row[c].split("\n")), default=0)
197
+ widths.append(min(COLUMN_WIDTHS.get(name.lower(), max(DEFAULT_WIDTH, min(longest, 40))), MAX_WIDTH))
198
+ sheets = [("Tracker", sheet_xml([header] + rows, widths, freeze_header=True))]
199
+ if metadata:
200
+ sheets.append(("Metadata", sheet_xml([["Field", "Value"]] + [list(p) for p in metadata], [32, 80], freeze_header=False)))
201
+ write_xlsx(output, sheets)
202
+ return len(rows), len(metadata)
203
+
204
+
205
+ def main() -> int:
206
+ ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
207
+ ap.add_argument("tracker", type=Path, help="path to tracker.md")
208
+ ap.add_argument("--output", type=Path, default=None, help="xlsx path (default: tracker.xlsx next to the tracker)")
209
+ args = ap.parse_args()
210
+ output = args.output or args.tracker.with_suffix(".xlsx")
211
+ try:
212
+ n_rows, n_meta = export(args.tracker, output)
213
+ except (OSError, ValueError) as exc:
214
+ print(f"export_tracker_xlsx: {exc}", file=sys.stderr)
215
+ return 1
216
+ print(f"wrote {output} ({n_rows} control rows, {n_meta} metadata fields)")
217
+ return 0
218
+
219
+
220
+ if __name__ == "__main__":
221
+ sys.exit(main())
@@ -0,0 +1,458 @@
1
+ #!/usr/bin/env python3
2
+ """Reconcile validated findings into the tracker (Step 9E).
3
+
4
+ Reads ``tracker.md`` and applies findings that are deterministically
5
+ verifiable, so hallucinated coverage cannot survive into the deliverable:
6
+
7
+ - From ``validate_tracker.py --json``: citation_grounding "missing clause"
8
+ warnings. The cited ``section X`` is not in the evidence file, so the citation
9
+ is hallucinated. Bullet flips to ``Not addressed`` with the reason.
10
+ - From the citation-judge JSON sidecars (Variant C, Step 9C): verdicts of
11
+ ``Off-target`` and ``Missing`` flip the bullet to ``Not addressed`` with
12
+ the judge's reason quoted.
13
+
14
+ Findings that are *not* auto-applied (judge ``Weak``, adversarial-challenger
15
+ recommendations) are surfaced in the reconciliation log for the human
16
+ reviewer to decide on.
17
+
18
+ After flipping bullets, the Control Effectiveness Rating is recomputed using
19
+ the same rubric as ``validate_tracker.py``. A line tagging the row as
20
+ "reconciled by Step 9E" is prepended to the Issue Description cell so the
21
+ reviewer can see what changed at a glance; the existing prose is preserved.
22
+
23
+ Usage:
24
+ python3 reconcile_tracker.py <tracker.md> --checklist <path> \\
25
+ [--validation <validate_tracker --json output>] \\
26
+ [--judge <judge-<group>.json>]... \\
27
+ [--output <path>] [--log <reconciliation.md>] [--dry-run]
28
+
29
+ Default ``--output`` is the tracker path itself (in-place rewrite).
30
+ Default ``--log`` is ``reconciliation.md`` next to the tracker.
31
+ """
32
+
33
+ from __future__ import annotations
34
+
35
+ import argparse
36
+ import json
37
+ import re
38
+ import sys
39
+ from dataclasses import dataclass, field
40
+ from datetime import datetime, timezone
41
+ from pathlib import Path
42
+ from typing import Optional
43
+
44
+ SCRIPT_DIR = Path(__file__).resolve().parent
45
+ sys.path.insert(0, str(SCRIPT_DIR))
46
+
47
+ from validate_tracker import ( # noqa: E402 (import after sys.path)
48
+ BULLET_PREFIX_RE,
49
+ BULLET_SPLIT_RE,
50
+ Observation,
51
+ classify_status,
52
+ derive_expected_rating,
53
+ normalize_item_id,
54
+ parse_checklist,
55
+ )
56
+
57
+
58
+ VALIDATION_MISSING_CLAUSE_RE = re.compile(
59
+ r"^\((?P<item>[^)]+)\)\s*clause\s*'(?:§\s*|section\s+)(?P<clause>[^']+?)'\s*not\s+found\s+in\s+(?P<doc>.+?)\s*$",
60
+ re.IGNORECASE,
61
+ )
62
+ VALIDATION_NO_DOC_RE = re.compile(
63
+ r"^\((?P<item>[^)]+)\)\s*no\s+evidence\s+file\s+matches\s*'(?P<doc>[^']+)'",
64
+ re.IGNORECASE,
65
+ )
66
+
67
+ CONTROL_ID_RE = re.compile(r"^[A-Z][A-Z0-9]*\.C\d+(?:\.\d+)?$")
68
+ TABLE_HEADER_RE = re.compile(r"^\|\s*Control ID\s*\|", re.IGNORECASE)
69
+ SEPARATOR_RE = re.compile(r"^\|[\s\-:|]+\|\s*$")
70
+ BULLET_PREFIX_LITERAL_RE = re.compile(r"^([\s•\-\*]*)Control\s+([^:]+):\s*(.*)$", re.IGNORECASE)
71
+
72
+
73
+ @dataclass
74
+ class AutoApplyFinding:
75
+ """A single finding that should auto-flip a bullet."""
76
+
77
+ control_id: str
78
+ item: str # canonical item id
79
+ source: str # "9B-clause-missing" | "9B-doc-missing" | "9C-off-target" | "9C-missing"
80
+ reason: str
81
+
82
+ def short_label(self) -> str:
83
+ return {
84
+ "9B-clause-missing": "9B — cited clause not in evidence",
85
+ "9B-doc-missing": "9B — cited document not found",
86
+ "9C-off-target": "9C judge — Off-target",
87
+ "9C-missing": "9C judge — Missing",
88
+ }.get(self.source, self.source)
89
+
90
+
91
+ @dataclass
92
+ class ReviewerMediated:
93
+ """A finding that needs human judgement; not auto-applied."""
94
+
95
+ control_id: str
96
+ item: str
97
+ source: str # "9C-weak" | "9D-challenge"
98
+ reason: str
99
+
100
+
101
+ @dataclass
102
+ class RowChange:
103
+ control_id: str
104
+ flips: list[tuple[str, str]] = field(default_factory=list) # (item, reason)
105
+ old_rating: str = ""
106
+ new_rating: str = ""
107
+
108
+
109
+ def load_validation_findings(path: Path) -> tuple[list[AutoApplyFinding], list[str]]:
110
+ """Extract auto-apply findings from validate_tracker.py --json output.
111
+
112
+ Returns (findings, unparsed_messages). Unparsed messages are surfaced in
113
+ the reconciliation log so the reviewer knows the validator flagged
114
+ something the reconciler didn't know how to act on.
115
+ """
116
+ data = json.loads(path.read_text(encoding="utf-8"))
117
+ findings: list[AutoApplyFinding] = []
118
+ unparsed: list[str] = []
119
+ for entry in data.get("warnings", []):
120
+ if entry.get("check") != "citation_grounding":
121
+ continue
122
+ ctrl = entry.get("control_id") or ""
123
+ msg = entry.get("message") or ""
124
+ m = VALIDATION_MISSING_CLAUSE_RE.match(msg)
125
+ if m:
126
+ findings.append(
127
+ AutoApplyFinding(
128
+ control_id=ctrl,
129
+ item=normalize_item_id(m.group("item")),
130
+ source="9B-clause-missing",
131
+ reason=f"cited clause section {m.group('clause').strip()} not found in {m.group('doc').strip()}",
132
+ )
133
+ )
134
+ continue
135
+ m = VALIDATION_NO_DOC_RE.match(msg)
136
+ if m:
137
+ findings.append(
138
+ AutoApplyFinding(
139
+ control_id=ctrl,
140
+ item=normalize_item_id(m.group("item")),
141
+ source="9B-doc-missing",
142
+ reason=f"cited document '{m.group('doc')}' not found among evidence files",
143
+ )
144
+ )
145
+ continue
146
+ unparsed.append(f"[{ctrl or '-'}] {msg}")
147
+ return findings, unparsed
148
+
149
+
150
+ def load_judge_findings(path: Path) -> tuple[list[AutoApplyFinding], list[ReviewerMediated]]:
151
+ auto: list[AutoApplyFinding] = []
152
+ mediated: list[ReviewerMediated] = []
153
+ raw = json.loads(path.read_text(encoding="utf-8"))
154
+ if not isinstance(raw, list):
155
+ raise ValueError(f"{path}: expected a JSON array of verdicts")
156
+ for entry in raw:
157
+ ctrl = (entry.get("control_id") or "").strip()
158
+ item_raw = (entry.get("item") or "").strip()
159
+ verdict = (entry.get("verdict") or "").strip()
160
+ reason = (entry.get("reason") or "").strip()
161
+ if not ctrl or not item_raw or not verdict:
162
+ continue
163
+ item = normalize_item_id(item_raw)
164
+ v_low = verdict.lower()
165
+ if v_low == "off-target":
166
+ auto.append(AutoApplyFinding(ctrl, item, "9C-off-target", reason or "judge: clause does not address the requirement"))
167
+ elif v_low == "missing":
168
+ auto.append(AutoApplyFinding(ctrl, item, "9C-missing", reason or "judge: cited clause not located in evidence"))
169
+ elif v_low == "weak":
170
+ mediated.append(ReviewerMediated(ctrl, item, "9C-weak", reason or "judge: clause references topic but does not operationalise"))
171
+ elif v_low == "confirmed":
172
+ continue
173
+ else:
174
+ mediated.append(ReviewerMediated(ctrl, item, f"9C-{v_low}", reason))
175
+ return auto, mediated
176
+
177
+
178
+ # --- Tracker mutation -----------------------------------------------------
179
+
180
+
181
+ def split_bullets(cell: str) -> list[str]:
182
+ pieces = [c for c in BULLET_SPLIT_RE.split(cell)]
183
+ return pieces
184
+
185
+
186
+ def join_bullets(bullets: list[str]) -> str:
187
+ return "<br>".join(bullets)
188
+
189
+
190
+ def parse_bullet(text: str) -> Optional[tuple[str, str, str, str]]:
191
+ """Return (leading_whitespace_and_bullet, item_raw, item_canon, body) or None."""
192
+ m = BULLET_PREFIX_LITERAL_RE.match(text)
193
+ if not m:
194
+ return None
195
+ prefix = m.group(1) or ""
196
+ item_raw = m.group(2).strip()
197
+ body = m.group(3).strip()
198
+ return (prefix, item_raw, normalize_item_id(item_raw), body)
199
+
200
+
201
+ def flip_bullet_text(original_bullet: str, reason: str) -> Optional[str]:
202
+ parsed = parse_bullet(original_bullet)
203
+ if not parsed:
204
+ return None
205
+ prefix, item_raw, _canon, _body = parsed
206
+ return f"{prefix}Control {item_raw}: Not addressed — {reason}"
207
+
208
+
209
+ def parse_table_row(line: str) -> Optional[list[str]]:
210
+ if not line.startswith("|"):
211
+ return None
212
+ body = line.strip()[1:]
213
+ if body.endswith("|") and not body.endswith("\\|"):
214
+ body = body[:-1]
215
+ # Split on unescaped pipes only; cells keep their "\|" escapes for re-rendering.
216
+ cells = [c.strip() for c in re.split(r"(?<!\\)\|", body)]
217
+ if not cells or not cells[0]:
218
+ return None
219
+ if not CONTROL_ID_RE.match(cells[0]):
220
+ return None
221
+ return cells
222
+
223
+
224
+ def render_table_row(cells: list[str]) -> str:
225
+ return "| " + " | ".join(cells) + " |"
226
+
227
+
228
+ def reconcile_row(
229
+ cells: list[str],
230
+ findings: list[AutoApplyFinding],
231
+ control_items: list,
232
+ change: RowChange,
233
+ ) -> list[str]:
234
+ """Apply auto-apply findings to a single tracker row's cells."""
235
+ if len(cells) < 6:
236
+ return cells
237
+
238
+ obs_cell = cells[3]
239
+ issue_cell = cells[4]
240
+ rating_cell = cells[5]
241
+
242
+ bullets = split_bullets(obs_cell)
243
+ findings_by_item: dict[str, list[AutoApplyFinding]] = {}
244
+ for f in findings:
245
+ findings_by_item.setdefault(f.item, []).append(f)
246
+
247
+ new_bullets: list[str] = []
248
+ for raw in bullets:
249
+ chunk = BULLET_PREFIX_RE.sub("", raw).strip()
250
+ if not chunk:
251
+ new_bullets.append(raw)
252
+ continue
253
+ parsed = parse_bullet(raw)
254
+ if not parsed:
255
+ new_bullets.append(raw)
256
+ continue
257
+ prefix, item_raw, item_canon, body = parsed
258
+ applicable = findings_by_item.get(item_canon)
259
+ if not applicable:
260
+ new_bullets.append(raw)
261
+ continue
262
+ # Skip if the bullet already says Not addressed (no-op flip).
263
+ if classify_status(body) == "not_addressed":
264
+ new_bullets.append(raw)
265
+ continue
266
+ reasons = "; ".join(f.reason for f in applicable)
267
+ flipped = flip_bullet_text(raw, reasons)
268
+ if flipped is None:
269
+ new_bullets.append(raw)
270
+ continue
271
+ new_bullets.append(flipped)
272
+ change.flips.append((item_raw, "; ".join(f.short_label() for f in applicable)))
273
+
274
+ new_obs = join_bullets(new_bullets)
275
+
276
+ # Recompute rating from the new bullet states.
277
+ observations: list[Observation] = []
278
+ for raw in new_bullets:
279
+ parsed = parse_bullet(raw)
280
+ if not parsed:
281
+ continue
282
+ _prefix, item_raw, _canon, body = parsed
283
+ observations.append(Observation(item_raw, classify_status(body), body))
284
+
285
+ new_rating = derive_expected_rating(observations, control_items)
286
+ change.old_rating = rating_cell
287
+ change.new_rating = new_rating or rating_cell
288
+
289
+ rating_out = new_rating if new_rating else rating_cell
290
+
291
+ if change.flips:
292
+ flipped_summary = "; ".join(
293
+ f"Control {item} ({label})" for item, label in change.flips
294
+ )
295
+ annotation = f"**[Step 9E reconciled]:** {flipped_summary}.<br>"
296
+ if not issue_cell.startswith("**[Step 9E reconciled]"):
297
+ issue_cell = annotation + issue_cell
298
+
299
+ new_cells = list(cells)
300
+ new_cells[3] = new_obs
301
+ new_cells[4] = issue_cell
302
+ new_cells[5] = rating_out
303
+ return new_cells
304
+
305
+
306
+ def reconcile_tracker(
307
+ tracker_text: str,
308
+ auto_findings: list[AutoApplyFinding],
309
+ controls: dict,
310
+ ) -> tuple[str, list[RowChange]]:
311
+ findings_by_control: dict[str, list[AutoApplyFinding]] = {}
312
+ for f in auto_findings:
313
+ findings_by_control.setdefault(f.control_id, []).append(f)
314
+
315
+ out_lines: list[str] = []
316
+ changes: list[RowChange] = []
317
+ for line in tracker_text.splitlines():
318
+ cells = parse_table_row(line)
319
+ if cells is None:
320
+ out_lines.append(line)
321
+ continue
322
+ ctrl_id = cells[0]
323
+ applicable = findings_by_control.get(ctrl_id, [])
324
+ control = controls.get(ctrl_id)
325
+ if not applicable or control is None:
326
+ out_lines.append(line)
327
+ continue
328
+ change = RowChange(control_id=ctrl_id)
329
+ new_cells = reconcile_row(cells, applicable, control.items, change)
330
+ if change.flips:
331
+ changes.append(change)
332
+ out_lines.append(render_table_row(new_cells))
333
+ else:
334
+ out_lines.append(line)
335
+
336
+ return "\n".join(out_lines) + ("\n" if tracker_text.endswith("\n") else ""), changes
337
+
338
+
339
+ # --- Reconciliation log ----------------------------------------------------
340
+
341
+
342
+ def write_log(
343
+ log_path: Path,
344
+ tracker_path: Path,
345
+ output_path: Path,
346
+ auto_findings: list[AutoApplyFinding],
347
+ mediated: list[ReviewerMediated],
348
+ unparsed_validation: list[str],
349
+ changes: list[RowChange],
350
+ ) -> None:
351
+ now = datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M UTC")
352
+ lines: list[str] = []
353
+ lines.append("# Reconciliation Log (Step 9E)")
354
+ lines.append("")
355
+ lines.append(f"- **Generated:** {now}")
356
+ lines.append(f"- **Source tracker:** `{tracker_path}`")
357
+ lines.append(f"- **Reconciled tracker:** `{output_path}`")
358
+ lines.append(f"- **Auto-applied findings:** {len(auto_findings)}")
359
+ lines.append(f"- **Reviewer-mediated findings:** {len(mediated)}")
360
+ lines.append(f"- **Rows changed:** {len(changes)}")
361
+ lines.append("")
362
+
363
+ lines.append("## Auto-applied")
364
+ if not changes:
365
+ lines.append("")
366
+ lines.append("_None — no auto-apply findings hit any tracker bullet._")
367
+ else:
368
+ for change in changes:
369
+ lines.append("")
370
+ lines.append(f"### {change.control_id}")
371
+ lines.append("")
372
+ lines.append(f"- **Rating:** `{change.old_rating}` → **`{change.new_rating}`**")
373
+ lines.append("- **Bullets flipped:**")
374
+ for item, label in change.flips:
375
+ lines.append(f" - Control {item}: {label}")
376
+ lines.append("")
377
+
378
+ lines.append("## Pending review (NOT auto-applied)")
379
+ if not mediated:
380
+ lines.append("")
381
+ lines.append("_None._")
382
+ else:
383
+ by_ctrl: dict[str, list[ReviewerMediated]] = {}
384
+ for m in mediated:
385
+ by_ctrl.setdefault(m.control_id, []).append(m)
386
+ for ctrl_id, items in sorted(by_ctrl.items()):
387
+ lines.append("")
388
+ lines.append(f"### {ctrl_id}")
389
+ lines.append("")
390
+ for m in items:
391
+ lines.append(f"- **Control {m.item}** ({m.source}): {m.reason}")
392
+ lines.append("")
393
+
394
+ if unparsed_validation:
395
+ lines.append("## Validator messages the reconciler could not parse")
396
+ lines.append("")
397
+ lines.append("These were emitted by `validate_tracker.py` but did not match a known auto-apply pattern. Review manually.")
398
+ lines.append("")
399
+ for msg in unparsed_validation:
400
+ lines.append(f"- {msg}")
401
+ lines.append("")
402
+
403
+ log_path.write_text("\n".join(lines), encoding="utf-8")
404
+
405
+
406
+ # --- CLI -------------------------------------------------------------------
407
+
408
+
409
+ def main() -> int:
410
+ ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
411
+ ap.add_argument("tracker", type=Path, help="path to tracker.md")
412
+ ap.add_argument("--checklist", type=Path, required=True)
413
+ ap.add_argument("--validation", type=Path, default=None, help="JSON output from validate_tracker.py --json")
414
+ ap.add_argument("--judge", type=Path, action="append", default=[], help="judge-<group>.json sidecar (may be passed multiple times)")
415
+ ap.add_argument("--output", type=Path, default=None, help="where to write the reconciled tracker (default: overwrite input)")
416
+ ap.add_argument("--log", type=Path, default=None, help="reconciliation log path (default: reconciliation.md alongside tracker)")
417
+ ap.add_argument("--dry-run", action="store_true", help="don't write the reconciled tracker; still write the log")
418
+ args = ap.parse_args()
419
+
420
+ if not args.tracker.exists():
421
+ print(f"tracker not found: {args.tracker}", file=sys.stderr)
422
+ return 1
423
+
424
+ controls = parse_checklist(args.checklist)
425
+
426
+ auto: list[AutoApplyFinding] = []
427
+ mediated: list[ReviewerMediated] = []
428
+ unparsed: list[str] = []
429
+
430
+ if args.validation:
431
+ v_auto, v_unparsed = load_validation_findings(args.validation)
432
+ auto.extend(v_auto)
433
+ unparsed.extend(v_unparsed)
434
+
435
+ for jp in args.judge:
436
+ j_auto, j_mediated = load_judge_findings(jp)
437
+ auto.extend(j_auto)
438
+ mediated.extend(j_mediated)
439
+
440
+ tracker_text = args.tracker.read_text(encoding="utf-8")
441
+ new_text, changes = reconcile_tracker(tracker_text, auto, controls)
442
+
443
+ output_path = args.output or args.tracker
444
+ if not args.dry_run:
445
+ output_path.write_text(new_text, encoding="utf-8")
446
+
447
+ log_path = args.log or args.tracker.with_name("reconciliation.md")
448
+ write_log(log_path, args.tracker, output_path, auto, mediated, unparsed, changes)
449
+
450
+ print(f"auto-applied: {sum(len(c.flips) for c in changes)} bullet(s) across {len(changes)} control(s)", file=sys.stderr)
451
+ print(f"reviewer-mediated: {len(mediated)} finding(s)", file=sys.stderr)
452
+ print(f"reconciled tracker: {output_path}", file=sys.stderr)
453
+ print(f"log: {log_path}", file=sys.stderr)
454
+ return 0
455
+
456
+
457
+ if __name__ == "__main__":
458
+ sys.exit(main())