@thedecipherist/claude-packs 0.0.0-stage → 1.1.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 (890) hide show
  1. package/CHANGELOG.md +754 -0
  2. package/LICENSE +21 -0
  3. package/README.md +573 -2
  4. package/bin/claude-packs.mjs +212 -0
  5. package/configurations/base/config.json +85 -0
  6. package/configurations/cpp/config.json +93 -0
  7. package/configurations/full-stack/config.json +153 -0
  8. package/configurations/go/config.json +98 -0
  9. package/configurations/node/config.json +102 -0
  10. package/configurations/python/config.json +99 -0
  11. package/configurations/rust/config.json +106 -0
  12. package/configurations/synth-creator/config.json +148 -0
  13. package/global/hooks/gnu-shell.mjs +131 -0
  14. package/global/hooks/lib/shell-writes.mjs +2 -0
  15. package/global/hooks/shell-traps.mjs +79 -0
  16. package/global/hooks/version-pin-guard.mjs +280 -0
  17. package/global/skills/latest-versions/SKILL.md +49 -0
  18. package/lib/backup.mjs +34 -0
  19. package/lib/build-queue.mjs +22 -0
  20. package/lib/claude-md.mjs +60 -0
  21. package/lib/config-cli.mjs +36 -0
  22. package/lib/configs.mjs +145 -0
  23. package/lib/coverage.mjs +94 -0
  24. package/lib/custom-packs.mjs +93 -0
  25. package/lib/doctor.mjs +126 -0
  26. package/lib/fix-plan.mjs +72 -0
  27. package/lib/found-folders.mjs +25 -0
  28. package/lib/git-tokens.mjs +64 -0
  29. package/lib/global.mjs +125 -0
  30. package/lib/hook-proof.mjs +45 -0
  31. package/lib/hook-timing.mjs +42 -0
  32. package/lib/hover-gate.mjs +29 -0
  33. package/lib/kit-command.mjs +14 -0
  34. package/lib/kit-lock.mjs +149 -0
  35. package/lib/layout.mjs +99 -0
  36. package/lib/logs.mjs +109 -0
  37. package/lib/manifest.mjs +24 -0
  38. package/lib/new.mjs +49 -0
  39. package/lib/once-only-report.mjs +54 -0
  40. package/lib/pack-manifest.mjs +20 -0
  41. package/lib/packs.mjs +109 -0
  42. package/lib/planner.mjs +59 -0
  43. package/lib/repeats.mjs +65 -0
  44. package/lib/repo-weight.mjs +28 -0
  45. package/lib/rule-tests.mjs +42 -0
  46. package/lib/rules.mjs +40 -0
  47. package/lib/scan-detect.mjs +130 -0
  48. package/lib/scan.mjs +171 -0
  49. package/lib/selftest-cache.mjs +39 -0
  50. package/lib/settings.mjs +138 -0
  51. package/lib/shape-cli.mjs +76 -0
  52. package/lib/shape.mjs +4 -0
  53. package/lib/suggest.mjs +31 -0
  54. package/lib/switches.mjs +44 -0
  55. package/lib/symmetry-doctor.mjs +26 -0
  56. package/lib/sync.mjs +133 -0
  57. package/lib/workorder.mjs +26 -0
  58. package/package.json +34 -4
  59. package/packs/ai/checks/boundary-computes-its-own-hash.json +30 -0
  60. package/packs/ai/checks/model-call-needs-boundary.json +29 -0
  61. package/packs/ai/checks/model-id-from-config.json +28 -0
  62. package/packs/ai/checks/model-output-validated.json +26 -0
  63. package/packs/ai/pack.json +38 -0
  64. package/packs/ai/rules/ai-input-sha-boundary.md +31 -0
  65. package/packs/ai/rules/llm-pipeline-security.md +26 -0
  66. package/packs/audio-core/checks/denormals-not-in-prepare.json +12 -0
  67. package/packs/audio-core/checks/dsp-without-apvts.json +12 -0
  68. package/packs/audio-core/checks/float-phase-or-rate.json +12 -0
  69. package/packs/audio-core/checks/juce-snap-to-zero-off.json +12 -0
  70. package/packs/audio-core/checks/keep-werror.json +12 -0
  71. package/packs/audio-core/checks/no-fast-math.json +14 -0
  72. package/packs/audio-core/checks/no-locale-change.json +12 -0
  73. package/packs/audio-core/checks/no-march-native.json +14 -0
  74. package/packs/audio-core/clang-tidy +28 -0
  75. package/packs/audio-core/hooks/lib/realtime-checks.mjs +56 -0
  76. package/packs/audio-core/hooks/param-id-lock.mjs +172 -0
  77. package/packs/audio-core/hooks/realtime-guard.mjs +67 -0
  78. package/packs/audio-core/pack.json +192 -0
  79. package/packs/audio-core/rules/a-control-is-proved-through-its-input.md +26 -0
  80. package/packs/audio-core/rules/audio-thread-realtime-safe.md +27 -0
  81. package/packs/audio-core/rules/audio-ui-thread-handoff.md +21 -0
  82. package/packs/audio-core/rules/boundary-tests-cross-the-boundary.md +16 -0
  83. package/packs/audio-core/rules/build-flags-safe.md +20 -0
  84. package/packs/audio-core/rules/cached-parameter-pointers.md +28 -0
  85. package/packs/audio-core/rules/clang-tidy-core-guidelines.md +21 -0
  86. package/packs/audio-core/rules/control-reaches-every-surface.md +23 -0
  87. package/packs/audio-core/rules/cpu-worst-case-per-block.md +28 -0
  88. package/packs/audio-core/rules/dc-block-after-asymmetry.md +22 -0
  89. package/packs/audio-core/rules/discrete-params-snap.md +19 -0
  90. package/packs/audio-core/rules/double-where-precision-matters.md +20 -0
  91. package/packs/audio-core/rules/filters-stable-under-modulation.md +29 -0
  92. package/packs/audio-core/rules/host-parameters-at-scale.md +24 -0
  93. package/packs/audio-core/rules/house-control-behaviours.md +34 -0
  94. package/packs/audio-core/rules/math-domain-guards.md +19 -0
  95. package/packs/audio-core/rules/modulated-delay-interpolation.md +22 -0
  96. package/packs/audio-core/rules/multiband-phase-coherent.md +22 -0
  97. package/packs/audio-core/rules/nonlinear-stages-antialiased.md +28 -0
  98. package/packs/audio-core/rules/note-ledger-and-pedals.md +22 -0
  99. package/packs/audio-core/rules/one-formula-per-value.md +20 -0
  100. package/packs/audio-core/rules/optimisations-are-null-tested.md +23 -0
  101. package/packs/audio-core/rules/oscillators-bandlimited.md +23 -0
  102. package/packs/audio-core/rules/output-limiter.md +23 -0
  103. package/packs/audio-core/rules/parameter-ids-never-change.md +20 -0
  104. package/packs/audio-core/rules/params-and-state-thread-safe.md +19 -0
  105. package/packs/audio-core/rules/params-snapshot-per-block.md +21 -0
  106. package/packs/audio-core/rules/patch-excludes-performance-controls.md +18 -0
  107. package/packs/audio-core/rules/per-sample-code-inlinable.md +22 -0
  108. package/packs/audio-core/rules/prepare-is-repeatable.md +23 -0
  109. package/packs/audio-core/rules/recursive-state-nan-guard.md +20 -0
  110. package/packs/audio-core/rules/reverb-loop-gain-bounded.md +24 -0
  111. package/packs/audio-core/rules/sample-accurate-midi.md +22 -0
  112. package/packs/audio-core/rules/sample-rate-and-block-size-from-host.md +23 -0
  113. package/packs/audio-core/rules/scoped-no-denormals.md +26 -0
  114. package/packs/audio-core/rules/smooth-continuous-parameters.md +22 -0
  115. package/packs/audio-core/rules/state-load-versioned-and-safe.md +22 -0
  116. package/packs/audio-core/rules/straight-on-and-aligned.md +21 -0
  117. package/packs/audio-core/rules/ui-matches-reference-look.md +23 -0
  118. package/packs/audio-core/rules/undo-one-gesture-one-step.md +21 -0
  119. package/packs/audio-core/rules/voice-steal-fades.md +21 -0
  120. package/packs/audio-core/rules/voice-sum-headroom.md +20 -0
  121. package/packs/audio-core/skills/analyse-reference-look/SKILL.md +35 -0
  122. package/packs/audio-core/skills/copy-and-prove/SKILL.md +98 -0
  123. package/packs/audio-core/skills/juce-realtime-audit/SKILL.md +22 -0
  124. package/packs/audio-core/skills/measure-tone/SKILL.md +20 -0
  125. package/packs/audio-core/skills/new-panel-control/SKILL.md +15 -0
  126. package/packs/audio-core/skills/prove-control/SKILL.md +25 -0
  127. package/packs/audio-core/skills/trace-parameter/SKILL.md +29 -0
  128. package/packs/audio-core/tools/lib/spectrum.mjs +112 -0
  129. package/packs/audio-core/tools/lib/wav.mjs +41 -0
  130. package/packs/audio-core/tools/tone-report.mjs +47 -0
  131. package/packs/base/checks/field-map-over-if-runs.json +25 -0
  132. package/packs/base/checks/lookup-over-if-chains.json +25 -0
  133. package/packs/base/checks/lookup-over-ternary-chains.json +20 -0
  134. package/packs/base/checks/no-code-after-midline-comment.json +12 -0
  135. package/packs/base/checks/one-walk-per-template.json +23 -0
  136. package/packs/base/checks/stub-reports-success.json +31 -0
  137. package/packs/base/checks/test-skip-on-failed-setup.json +17 -0
  138. package/packs/base/hooks/brief-guard.mjs +96 -0
  139. package/packs/base/hooks/code-shape.mjs +99 -0
  140. package/packs/base/hooks/dispatch-once.mjs +124 -0
  141. package/packs/base/hooks/file-size-guard.mjs +61 -0
  142. package/packs/base/hooks/folder-law.mjs +77 -0
  143. package/packs/base/hooks/git-guard.mjs +202 -0
  144. package/packs/base/hooks/lesson-checks.mjs +182 -0
  145. package/packs/base/hooks/lib/apply-edit.mjs +20 -0
  146. package/packs/base/hooks/lib/code-shapes.mjs +142 -0
  147. package/packs/base/hooks/lib/content.mjs +14 -0
  148. package/packs/base/hooks/lib/cpp-scan.mjs +94 -0
  149. package/packs/base/hooks/lib/crash-policy.mjs +47 -0
  150. package/packs/base/hooks/lib/dup-index.mjs +204 -0
  151. package/packs/base/hooks/lib/dup.mjs +127 -0
  152. package/packs/base/hooks/lib/elements.mjs +87 -0
  153. package/packs/base/hooks/lib/event-log.mjs +68 -0
  154. package/packs/base/hooks/lib/function-shapes.mjs +90 -0
  155. package/packs/base/hooks/lib/git-adds.mjs +21 -0
  156. package/packs/base/hooks/lib/git-auth.mjs +44 -0
  157. package/packs/base/hooks/lib/git-guard-selftest.mjs +192 -0
  158. package/packs/base/hooks/lib/glob.mjs +33 -0
  159. package/packs/base/hooks/lib/hook-log.mjs +100 -0
  160. package/packs/base/hooks/lib/house.py +77 -0
  161. package/packs/base/hooks/lib/languages.mjs +69 -0
  162. package/packs/base/hooks/lib/layout.mjs +58 -0
  163. package/packs/base/hooks/lib/making-check-selftest.mjs +112 -0
  164. package/packs/base/hooks/lib/near-copies.mjs +76 -0
  165. package/packs/base/hooks/lib/program-read.mjs +199 -0
  166. package/packs/base/hooks/lib/program-writes.mjs +177 -0
  167. package/packs/base/hooks/lib/project.mjs +81 -0
  168. package/packs/base/hooks/lib/prose.mjs +11 -0
  169. package/packs/base/hooks/lib/pushed.mjs +201 -0
  170. package/packs/base/hooks/lib/repo-index.mjs +52 -0
  171. package/packs/base/hooks/lib/rust-scan.mjs +139 -0
  172. package/packs/base/hooks/lib/secret-patterns.mjs +18 -0
  173. package/packs/base/hooks/lib/selftest.mjs +45 -0
  174. package/packs/base/hooks/lib/shape-code.mjs +126 -0
  175. package/packs/base/hooks/lib/shape-lists.mjs +31 -0
  176. package/packs/base/hooks/lib/shape-prose.mjs +78 -0
  177. package/packs/base/hooks/lib/shape.mjs +273 -0
  178. package/packs/base/hooks/lib/shell-writes-selftest.mjs +65 -0
  179. package/packs/base/hooks/lib/shell-writes.mjs +293 -0
  180. package/packs/base/hooks/lib/turn.mjs +86 -0
  181. package/packs/base/hooks/lib/unread-writes.mjs +24 -0
  182. package/packs/base/hooks/lib/writes.mjs +71 -0
  183. package/packs/base/hooks/making-check.mjs +248 -0
  184. package/packs/base/hooks/making.mjs +106 -0
  185. package/packs/base/hooks/once-only.mjs +150 -0
  186. package/packs/base/hooks/placement-law.mjs +84 -0
  187. package/packs/base/hooks/repo-litter.mjs +75 -0
  188. package/packs/base/hooks/reuse-hint.mjs +75 -0
  189. package/packs/base/hooks/run-hooks.mjs +140 -0
  190. package/packs/base/hooks/secrets-guard.mjs +99 -0
  191. package/packs/base/hooks/shape-law.mjs +140 -0
  192. package/packs/base/hooks/suite-once.mjs +96 -0
  193. package/packs/base/hooks/template-law.mjs +148 -0
  194. package/packs/base/hooks/untrusted-boundary.mjs +53 -0
  195. package/packs/base/pack.json +214 -0
  196. package/packs/base/rules/a-control-is-seen-to-fire.md +27 -0
  197. package/packs/base/rules/behaviour-lives-with-its-kind.md +51 -0
  198. package/packs/base/rules/bug-fix-starts-red.md +25 -0
  199. package/packs/base/rules/field-map-over-if-runs.md +47 -0
  200. package/packs/base/rules/finished-work-lands.md +17 -0
  201. package/packs/base/rules/git-right-first-time.md +19 -0
  202. package/packs/base/rules/instances-by-index-identities-by-id.md +54 -0
  203. package/packs/base/rules/lookup-over-if-chains.md +49 -0
  204. package/packs/base/rules/making-line-first.md +14 -0
  205. package/packs/base/rules/open-items-tagged.md +17 -0
  206. package/packs/base/rules/plan-and-logs.md +22 -0
  207. package/packs/base/rules/references-use-anchors.md +19 -0
  208. package/packs/base/rules/refusals-are-judged.md +19 -0
  209. package/packs/base/rules/reuse-before-writing.md +15 -0
  210. package/packs/base/rules/secrets-never-committed.md +16 -0
  211. package/packs/base/rules/skill-writing.md +23 -0
  212. package/packs/base/rules/split-before-the-limit.md +14 -0
  213. package/packs/base/rules/subagent-dispatch.md +26 -0
  214. package/packs/base/rules/test-only-what-changed.md +17 -0
  215. package/packs/base/rules/test-the-template-once.md +23 -0
  216. package/packs/base/rules/unattended-runs.md +15 -0
  217. package/packs/base/rules/untrusted-content-boundary.md +15 -0
  218. package/packs/base/skills/add-lesson-check/SKILL.md +26 -0
  219. package/packs/base/skills/fix-from-scan/SKILL.md +25 -0
  220. package/packs/base/skills/land-branch/SKILL.md +24 -0
  221. package/packs/base/skills/make-it-a-template/SKILL.md +23 -0
  222. package/packs/base/skills/new-project/SKILL.md +23 -0
  223. package/packs/base/skills/pdf-to-md/SKILL.md +25 -0
  224. package/packs/base/skills/pick-tests/SKILL.md +20 -0
  225. package/packs/base/skills/pressure-test-skill/SKILL.md +23 -0
  226. package/packs/base/skills/prove-instances-identical/SKILL.md +37 -0
  227. package/packs/base/skills/write-a-workorder/SKILL.md +41 -0
  228. package/packs/base/tools/shape-symmetry-selftest.mjs +66 -0
  229. package/packs/base/tools/shape-symmetry.mjs +178 -0
  230. package/packs/base/tools/test-verdict.mjs +75 -0
  231. package/packs/ci/checks/ci-permissions-stated.json +18 -0
  232. package/packs/ci/checks/ci-tools-pinned.json +14 -0
  233. package/packs/ci/pack.json +21 -0
  234. package/packs/ci/rules/ci-covers-what-ships.md +20 -0
  235. package/packs/ci/rules/generated-files-have-no-diff.md +15 -0
  236. package/packs/content-site/checks/captcha-is-not-constant.json +27 -0
  237. package/packs/content-site/checks/img-has-size.json +20 -0
  238. package/packs/content-site/checks/page-head-complete.json +26 -0
  239. package/packs/content-site/pack.json +22 -0
  240. package/packs/content-site/rules/content-has-one-source.md +23 -0
  241. package/packs/content-site/rules/media-is-sized.md +24 -0
  242. package/packs/content-site/rules/page-head-is-complete.md +26 -0
  243. package/packs/content-site/rules/public-forms-are-defended.md +27 -0
  244. package/packs/content-site/skills/publish-a-page/SKILL.md +21 -0
  245. package/packs/cpp/checks/cpp-clamp-before-cast.json +16 -0
  246. package/packs/cpp/checks/cpp-find-with-the-library.json +12 -0
  247. package/packs/cpp/checks/cpp-hardened-test-build.json +18 -0
  248. package/packs/cpp/checks/cpp-m-pi-not-standard.json +23 -0
  249. package/packs/cpp/checks/cpp-no-atoi.json +16 -0
  250. package/packs/cpp/checks/cpp-no-const-cast.json +16 -0
  251. package/packs/cpp/checks/cpp-no-float-loop-counter.json +16 -0
  252. package/packs/cpp/checks/cpp-no-getenv-in-product.json +22 -0
  253. package/packs/cpp/checks/cpp-no-mutable-global.json +20 -0
  254. package/packs/cpp/checks/cpp-no-mutable-local-static.json +23 -0
  255. package/packs/cpp/checks/cpp-no-unchecked-fwrite.json +17 -0
  256. package/packs/cpp/checks/cpp-no-using-namespace-in-header.json +19 -0
  257. package/packs/cpp/checks/cpp-no-zero-size-array.json +23 -0
  258. package/packs/cpp/checks/cpp-numbers-pi.json +16 -0
  259. package/packs/cpp/pack.json +22 -0
  260. package/packs/cpp/rules/cpp-absent-and-failed-are-types.md +24 -0
  261. package/packs/cpp/rules/cpp-builds-everywhere.md +26 -0
  262. package/packs/cpp/rules/cpp-faults-only-in-the-test-build.md +21 -0
  263. package/packs/cpp/rules/cpp-find-with-the-library.md +19 -0
  264. package/packs/cpp/rules/cpp-gates-share-one-reader.md +22 -0
  265. package/packs/cpp/rules/cpp-headers-declare.md +22 -0
  266. package/packs/cpp/rules/cpp-numbers-and-casts.md +22 -0
  267. package/packs/cpp/rules/cpp-repeats-become-templates.md +33 -0
  268. package/packs/cpp/rules/cpp-static-analysis-runs.md +22 -0
  269. package/packs/cpp/rules/cpp-thread-contracts-are-code.md +23 -0
  270. package/packs/cpp/skills/cpp-extract-template/SKILL.md +38 -0
  271. package/packs/docker/checks/alpine-with-native-build.json +13 -0
  272. package/packs/docker/checks/compose-db-needs-auth.json +14 -0
  273. package/packs/docker/checks/compose-image-pinned.json +14 -0
  274. package/packs/docker/checks/compose-no-hardcoded-ip.json +12 -0
  275. package/packs/docker/checks/compose-no-host-bind-for-data.json +18 -0
  276. package/packs/docker/checks/compose-no-plaintext-secret.json +13 -0
  277. package/packs/docker/checks/compose-no-swarm-ignored-keys.json +13 -0
  278. package/packs/docker/checks/compose-overlay-not-bridge.json +13 -0
  279. package/packs/docker/checks/compose-service-needs-healthcheck.json +11 -0
  280. package/packs/docker/checks/compose-service-needs-init.json +11 -0
  281. package/packs/docker/checks/copy-needs-chown-with-user.json +17 -0
  282. package/packs/docker/checks/copy-source-before-deps.json +13 -0
  283. package/packs/docker/checks/docker-exec-form.json +16 -0
  284. package/packs/docker/checks/dockerfile-needs-healthcheck.json +17 -0
  285. package/packs/docker/checks/dockerfile-needs-user.json +21 -0
  286. package/packs/docker/checks/dockerignore-has-the-basics.json +21 -0
  287. package/packs/docker/checks/gitattributes-forces-lf.json +17 -0
  288. package/packs/docker/checks/health-checks-nothing.json +25 -0
  289. package/packs/docker/checks/no-crlf-in-scripts.json +15 -0
  290. package/packs/docker/checks/no-latest-base.json +13 -0
  291. package/packs/docker/checks/no-secret-in-image.json +13 -0
  292. package/packs/docker/checks/no-sensitive-file-copy.json +13 -0
  293. package/packs/docker/checks/node-env-before-install.json +13 -0
  294. package/packs/docker/checks/npm-ci-not-install.json +13 -0
  295. package/packs/docker/pack.json +46 -0
  296. package/packs/docker/rules/compose-pinned-and-closed.md +21 -0
  297. package/packs/docker/rules/compose-swarm-safe.md +26 -0
  298. package/packs/docker/rules/docker-exec-form.md +19 -0
  299. package/packs/docker/rules/dockerfile-multistage.md +13 -0
  300. package/packs/docker/rules/dockerfile-production.md +25 -0
  301. package/packs/docker/skills/docker-diagnose/SKILL.md +23 -0
  302. package/packs/dynamic-data/checks/draft-on-the-server.json +27 -0
  303. package/packs/dynamic-data/checks/guard-does-its-job.json +28 -0
  304. package/packs/dynamic-data/checks/key-is-not-a-display-name.json +28 -0
  305. package/packs/dynamic-data/checks/no-code-from-data.json +29 -0
  306. package/packs/dynamic-data/checks/no-collection-from-request.json +27 -0
  307. package/packs/dynamic-data/checks/no-pipeline-from-stored-text.json +27 -0
  308. package/packs/dynamic-data/checks/no-regexp-from-stored-config.json +27 -0
  309. package/packs/dynamic-data/checks/no-template-from-stored-text.json +27 -0
  310. package/packs/dynamic-data/checks/save-takes-named-paths.json +27 -0
  311. package/packs/dynamic-data/pack.json +23 -0
  312. package/packs/dynamic-data/rules/a-list-is-a-saved-query.md +23 -0
  313. package/packs/dynamic-data/rules/definitions-are-validated-data.md +24 -0
  314. package/packs/dynamic-data/rules/every-dynamic-surface-has-a-boundary.md +29 -0
  315. package/packs/dynamic-data/rules/fields-have-owners.md +22 -0
  316. package/packs/dynamic-data/rules/imports-drop-nothing.md +26 -0
  317. package/packs/dynamic-data/rules/one-definition-many-surfaces.md +24 -0
  318. package/packs/dynamic-data/rules/one-fact-one-place.md +28 -0
  319. package/packs/dynamic-data/rules/rules-live-in-the-engine.md +29 -0
  320. package/packs/dynamic-data/rules/saves-are-patches.md +28 -0
  321. package/packs/dynamic-data/rules/tenant-costs-one-document.md +22 -0
  322. package/packs/dynamic-data/skills/design-a-definition/SKILL.md +24 -0
  323. package/packs/fastify/checks/api-routes-versioned.json +28 -0
  324. package/packs/fastify/checks/cookie-host-prefix.json +24 -0
  325. package/packs/fastify/checks/hijack-needs-try.json +28 -0
  326. package/packs/fastify/checks/no-cast-at-route-boundary.json +24 -0
  327. package/packs/fastify/checks/no-db-in-route-file.json +28 -0
  328. package/packs/fastify/checks/no-err-message-to-client.json +24 -0
  329. package/packs/fastify/checks/no-regexp-from-input.json +24 -0
  330. package/packs/fastify/checks/no-trust-proxy-true.json +25 -0
  331. package/packs/fastify/checks/one-error-body.json +26 -0
  332. package/packs/fastify/checks/origin-from-config-not-host.json +31 -0
  333. package/packs/fastify/checks/password-needs-slow-hash.json +30 -0
  334. package/packs/fastify/checks/sec-headers-present.json +28 -0
  335. package/packs/fastify/checks/secrets-compared-constant-time.json +24 -0
  336. package/packs/fastify/checks/sse-needs-error-listener.json +28 -0
  337. package/packs/fastify/checks/user-bytes-need-disposition.json +29 -0
  338. package/packs/fastify/pack.json +41 -0
  339. package/packs/fastify/rules/credentials-and-input.md +23 -0
  340. package/packs/fastify/rules/security-one-switch.md +28 -0
  341. package/packs/fastify/rules/streams-and-hijacks.md +22 -0
  342. package/packs/fastify/rules/tests-use-inject.md +13 -0
  343. package/packs/fastify/rules/three-layers.md +20 -0
  344. package/packs/fastify/rules/trust-config-not-headers.md +24 -0
  345. package/packs/full-stack/checks/no-express-no-vite.json +23 -0
  346. package/packs/full-stack/hooks/stack-guard.mjs +90 -0
  347. package/packs/full-stack/pack.json +76 -0
  348. package/packs/full-stack/rules/stack-is-fastify-and-nextjs.md +20 -0
  349. package/packs/go/checks/go-exec-result-ignored.json +15 -0
  350. package/packs/go/checks/go-unmarshal-error-ignored.json +15 -0
  351. package/packs/go/pack.json +26 -0
  352. package/packs/go/rules/go-errors-are-handled.md +22 -0
  353. package/packs/gpu-painter/checks/dawn-backends-and-validation.json +9 -0
  354. package/packs/gpu-painter/checks/dawn-no-spontaneous.json +10 -0
  355. package/packs/gpu-painter/checks/dawn-present-on-render-thread.json +17 -0
  356. package/packs/gpu-painter/checks/gpu-no-frame-stalls.json +12 -0
  357. package/packs/gpu-painter/checks/no-opengl-link.json +11 -0
  358. package/packs/gpu-painter/checks/no-opengl.json +13 -0
  359. package/packs/gpu-painter/hooks/browser-guard.py +196 -0
  360. package/packs/gpu-painter/pack.json +91 -0
  361. package/packs/gpu-painter/rules/dawn-build-and-shaders.md +27 -0
  362. package/packs/gpu-painter/rules/dawn-device-and-render-thread.md +26 -0
  363. package/packs/gpu-painter/rules/gpu-antialiasing.md +20 -0
  364. package/packs/gpu-painter/rules/gpu-blend-order.md +22 -0
  365. package/packs/gpu-painter/rules/gpu-bloom.md +20 -0
  366. package/packs/gpu-painter/rules/gpu-frame-budget.md +25 -0
  367. package/packs/gpu-painter/rules/gpu-frame-pacing-and-power.md +27 -0
  368. package/packs/gpu-painter/rules/gpu-frame-work.md +30 -0
  369. package/packs/gpu-painter/rules/gpu-golden-images.md +21 -0
  370. package/packs/gpu-painter/rules/gpu-hdr-and-tonemap.md +23 -0
  371. package/packs/gpu-painter/rules/gpu-picking-on-cpu.md +19 -0
  372. package/packs/gpu-painter/rules/gpu-render-lifecycle.md +25 -0
  373. package/packs/gpu-painter/rules/gpu-text-atlas.md +24 -0
  374. package/packs/gpu-painter/rules/gpu-travellers-from-snapshot.md +24 -0
  375. package/packs/gpu-painter/rules/hover-every-pressable.md +25 -0
  376. package/packs/gpu-painter/skills/gpu-capture/SKILL.md +15 -0
  377. package/packs/gpu-painter/skills/gpu-frame-bench/SKILL.md +14 -0
  378. package/packs/gpu-painter/skills/gpu-golden-check/SKILL.md +13 -0
  379. package/packs/gpu-painter/skills/gpu-golden-update/SKILL.md +16 -0
  380. package/packs/gpu-painter/skills/gpu-lifecycle-stress/SKILL.md +15 -0
  381. package/packs/gpu-painter/skills/hover-state/SKILL.md +33 -0
  382. package/packs/hook-proof/checks/hook-catch-must-not-allow.json +16 -0
  383. package/packs/hook-proof/checks/hook-command-no-pipe.json +16 -0
  384. package/packs/hook-proof/checks/hook-exit-1-does-not-block.json +17 -0
  385. package/packs/hook-proof/checks/hook-no-or-true.json +18 -0
  386. package/packs/hook-proof/checks/hook-refusal-on-stderr.json +17 -0
  387. package/packs/hook-proof/pack.json +38 -0
  388. package/packs/hook-proof/rules/a-refusal-is-exit-2.md +28 -0
  389. package/packs/hook-proof/skills/prove-a-hook/SKILL.md +21 -0
  390. package/packs/host-agent/checks/file-path-from-param.json +27 -0
  391. package/packs/host-agent/checks/integrity-check-optional.json +27 -0
  392. package/packs/host-agent/checks/quoted-value-into-config.json +24 -0
  393. package/packs/host-agent/checks/secret-on-argv.json +28 -0
  394. package/packs/host-agent/checks/ssh-verifies-host-key.json +27 -0
  395. package/packs/host-agent/checks/system-file-written-in-place.json +26 -0
  396. package/packs/host-agent/checks/tmp-path-predictable.json +27 -0
  397. package/packs/host-agent/pack.json +22 -0
  398. package/packs/host-agent/rules/root-on-other-machines.md +27 -0
  399. package/packs/html-ui/checks/email-html-escapes.json +25 -0
  400. package/packs/html-ui/checks/external-link-rel.json +21 -0
  401. package/packs/html-ui/checks/no-duplicate-escape.json +26 -0
  402. package/packs/html-ui/checks/no-inline-client-script.json +21 -0
  403. package/packs/html-ui/checks/no-inline-style.json +23 -0
  404. package/packs/html-ui/pack.json +33 -0
  405. package/packs/html-ui/rules/email-html-escapes.md +19 -0
  406. package/packs/html-ui/rules/server-html-escapes-everything.md +22 -0
  407. package/packs/http-api/checks/api-path-versioned.json +31 -0
  408. package/packs/http-api/checks/authz-from-request-body.json +26 -0
  409. package/packs/http-api/checks/client-calls-a-version.json +28 -0
  410. package/packs/http-api/checks/client-ip-not-leftmost-xff.json +28 -0
  411. package/packs/http-api/checks/cors-needs-origin.json +26 -0
  412. package/packs/http-api/checks/csp-not-switched-off.json +28 -0
  413. package/packs/http-api/checks/debug-route-not-shipped.json +26 -0
  414. package/packs/http-api/checks/encrypted-name-plaintext-value.json +26 -0
  415. package/packs/http-api/checks/err-text-stays-server-side.json +27 -0
  416. package/packs/http-api/checks/failure-is-not-empty.json +28 -0
  417. package/packs/http-api/checks/gate-is-not-a-todo.json +27 -0
  418. package/packs/http-api/checks/guard-fails-open.json +28 -0
  419. package/packs/http-api/checks/hmac-over-reserialised-body.json +26 -0
  420. package/packs/http-api/checks/jwt-verify-pins-algorithm.json +26 -0
  421. package/packs/http-api/checks/middleware-skips-without-user.json +26 -0
  422. package/packs/http-api/checks/next-api-route-versioned.json +47 -0
  423. package/packs/http-api/checks/no-security-off-switch.json +28 -0
  424. package/packs/http-api/checks/oauth-state-signed.json +26 -0
  425. package/packs/http-api/checks/one-time-code-compared-raw.json +26 -0
  426. package/packs/http-api/checks/query-cast-is-not-validation.json +28 -0
  427. package/packs/http-api/checks/queue-action-from-client.json +26 -0
  428. package/packs/http-api/checks/rate-limit-one-module.json +28 -0
  429. package/packs/http-api/checks/role-checked-in-one-guard.json +27 -0
  430. package/packs/http-api/checks/route-body-needs-schema.json +31 -0
  431. package/packs/http-api/checks/route-scopes-to-the-caller.json +31 -0
  432. package/packs/http-api/checks/secret-compared-constant-time-any.json +28 -0
  433. package/packs/http-api/checks/secret-in-job-record.json +27 -0
  434. package/packs/http-api/checks/server-fetches-tenant-url.json +30 -0
  435. package/packs/http-api/checks/short-code-needs-limit.json +26 -0
  436. package/packs/http-api/checks/user-url-through-safe-fetch.json +28 -0
  437. package/packs/http-api/checks/webhook-dedupes-event-id.json +30 -0
  438. package/packs/http-api/pack.json +45 -0
  439. package/packs/http-api/rules/adapters-one-db-gateway.md +18 -0
  440. package/packs/http-api/rules/apis-are-versioned.md +27 -0
  441. package/packs/http-api/rules/credentials-handled-safely.md +22 -0
  442. package/packs/http-api/rules/handlers-own-the-work.md +17 -0
  443. package/packs/http-api/rules/health-and-correlation.md +17 -0
  444. package/packs/http-api/rules/one-error-contract.md +17 -0
  445. package/packs/http-api/rules/routes-are-thin.md +17 -0
  446. package/packs/http-api/rules/routes-scope-to-the-caller.md +26 -0
  447. package/packs/http-api/rules/routes-validate-and-answer.md +25 -0
  448. package/packs/http-api/skills/change-an-api/SKILL.md +20 -0
  449. package/packs/http-api/skills/secure-a-route/SKILL.md +21 -0
  450. package/packs/instrument-shell/checks/no-raw-struct-blob.json +23 -0
  451. package/packs/instrument-shell/pack.json +22 -0
  452. package/packs/instrument-shell/rules/fold-keeps-every-route.md +24 -0
  453. package/packs/instrument-shell/rules/quiet-announces-itself.md +22 -0
  454. package/packs/instrument-shell/rules/render-the-extremes.md +25 -0
  455. package/packs/instrument-shell/rules/seams-are-declared.md +27 -0
  456. package/packs/instrument-shell/rules/session-blob-append-only.md +25 -0
  457. package/packs/instrument-shell/skills/gates-from-commit-one/SKILL.md +20 -0
  458. package/packs/instrument-shell/skills/hit-the-painted-control/SKILL.md +18 -0
  459. package/packs/js-ts/checks/async-callback-unguarded.json +26 -0
  460. package/packs/js-ts/checks/background-loop-needs-stop.json +28 -0
  461. package/packs/js-ts/checks/child-process-error-handler.json +28 -0
  462. package/packs/js-ts/checks/entry-registers-shutdown.json +31 -0
  463. package/packs/js-ts/checks/fetch-needs-timeout.json +30 -0
  464. package/packs/js-ts/checks/job-only-in-memory.json +28 -0
  465. package/packs/js-ts/checks/json-only-through-helper.json +29 -0
  466. package/packs/js-ts/checks/line-under-200-chars.json +34 -0
  467. package/packs/js-ts/checks/localhost-default-in-server.json +29 -0
  468. package/packs/js-ts/checks/no-any.json +27 -0
  469. package/packs/js-ts/checks/no-cast-escape-hatches.json +24 -0
  470. package/packs/js-ts/checks/no-console-in-app.json +31 -0
  471. package/packs/js-ts/checks/no-dynamic-import-node-builtin.json +25 -0
  472. package/packs/js-ts/checks/no-inline-binary.json +20 -0
  473. package/packs/js-ts/checks/no-inline-zod-outside-schemas.json +27 -0
  474. package/packs/js-ts/checks/no-local-sleep.json +25 -0
  475. package/packs/js-ts/checks/no-nested-ternary.json +20 -0
  476. package/packs/js-ts/checks/no-secret-in-log.json +24 -0
  477. package/packs/js-ts/checks/no-shell-string-interpolation.json +24 -0
  478. package/packs/js-ts/checks/no-swallowed-errors.json +25 -0
  479. package/packs/js-ts/checks/no-ts-enum.json +20 -0
  480. package/packs/js-ts/checks/process-env-only-in-config.json +31 -0
  481. package/packs/js-ts/checks/race-leaves-work-running.json +23 -0
  482. package/packs/js-ts/checks/reject-as-catch-all-exists.json +24 -0
  483. package/packs/js-ts/checks/secret-has-no-fallback.json +24 -0
  484. package/packs/js-ts/checks/secret-needs-crypto-random.json +24 -0
  485. package/packs/js-ts/checks/server-close-awaited.json +27 -0
  486. package/packs/js-ts/checks/session-user-typed-once.json +24 -0
  487. package/packs/js-ts/checks/switch-is-a-table.json +24 -0
  488. package/packs/js-ts/checks/test-imports-the-source.json +19 -0
  489. package/packs/js-ts/checks/test-name-says-behaviour.json +16 -0
  490. package/packs/js-ts/checks/tsconfig-flags.json +21 -0
  491. package/packs/js-ts/checks/void-needs-catch.json +24 -0
  492. package/packs/js-ts/checks/zod-string-needs-max.json +25 -0
  493. package/packs/js-ts/checks/zod-v4-formats.json +23 -0
  494. package/packs/js-ts/pack.json +84 -0
  495. package/packs/js-ts/rules/await-handled-at-a-boundary.md +66 -0
  496. package/packs/js-ts/rules/env-through-config.md +36 -0
  497. package/packs/js-ts/rules/errors-never-swallowed.md +33 -0
  498. package/packs/js-ts/rules/files-under-300-lines.md +18 -0
  499. package/packs/js-ts/rules/guard-clauses-over-nesting.md +34 -0
  500. package/packs/js-ts/rules/js-repeats-become-templates.md +26 -0
  501. package/packs/js-ts/rules/json-only-through-one-helper.md +62 -0
  502. package/packs/js-ts/rules/named-constants-not-magic-numbers.md +34 -0
  503. package/packs/js-ts/rules/no-any.md +34 -0
  504. package/packs/js-ts/rules/no-console.md +30 -0
  505. package/packs/js-ts/rules/no-floating-promises.md +31 -0
  506. package/packs/js-ts/rules/no-param-mutation.md +28 -0
  507. package/packs/js-ts/rules/no-unsafe-assertions.md +30 -0
  508. package/packs/js-ts/rules/one-logger.md +24 -0
  509. package/packs/js-ts/rules/outbound-calls-have-a-limit.md +20 -0
  510. package/packs/js-ts/rules/parallel-independent-awaits.md +29 -0
  511. package/packs/js-ts/rules/process-lifecycle.md +47 -0
  512. package/packs/js-ts/rules/schema-single-source-of-truth.md +36 -0
  513. package/packs/js-ts/rules/secrets-stay-secret.md +22 -0
  514. package/packs/js-ts/rules/small-functions.md +20 -0
  515. package/packs/js-ts/rules/test-names-describe-behavior.md +28 -0
  516. package/packs/js-ts/rules/tests-can-fail.md +19 -0
  517. package/packs/js-ts/rules/tsconfig-strict.md +32 -0
  518. package/packs/js-ts/rules/typed-exports.md +27 -0
  519. package/packs/js-ts/rules/types-once-at-the-edge.md +18 -0
  520. package/packs/js-ts/rules/unions-over-enums.md +29 -0
  521. package/packs/js-ts/rules/zod-at-route-boundaries.md +40 -0
  522. package/packs/midi/checks/active-sensing-no-pulse.json +24 -0
  523. package/packs/midi/checks/clock-not-at-sample-zero.json +23 -0
  524. package/packs/midi/checks/midi-realtime-first.json +27 -0
  525. package/packs/midi/checks/no-tempo-writeback.json +23 -0
  526. package/packs/midi/checks/position-not-integrated.json +29 -0
  527. package/packs/midi/checks/stub-playhead-advances.json +27 -0
  528. package/packs/midi/checks/sysex-length-literal.json +23 -0
  529. package/packs/midi/checks/sysex-not-on-audio.json +24 -0
  530. package/packs/midi/checks/sysex-survives-realtime.json +27 -0
  531. package/packs/midi/pack.json +22 -0
  532. package/packs/midi/rules/clock-is-a-pulse-stream.md +30 -0
  533. package/packs/midi/rules/imports-count-every-loss.md +25 -0
  534. package/packs/midi/rules/measure-the-clock-in-audio.md +30 -0
  535. package/packs/midi/rules/sync-is-a-mode.md +29 -0
  536. package/packs/midi/rules/sysex-is-a-record.md +29 -0
  537. package/packs/midi/skills/clock-probe/SKILL.md +23 -0
  538. package/packs/midi/skills/clock-probe/clock-law.md +417 -0
  539. package/packs/midi/skills/does-it-sync/SKILL.md +19 -0
  540. package/packs/mongo/checks/bulk-over-many.json +28 -0
  541. package/packs/mongo/checks/created-at-immutable.json +25 -0
  542. package/packs/mongo/checks/driver-outside-gateway.json +24 -0
  543. package/packs/mongo/checks/key-lookup-is-hashed.json +24 -0
  544. package/packs/mongo/checks/mongoclient-cached-and-named.json +34 -0
  545. package/packs/mongo/checks/mongoclient-outside-gateway.json +24 -0
  546. package/packs/mongo/checks/no-count-plus-one-ids.json +25 -0
  547. package/packs/mongo/checks/no-db-write-in-loop.json +25 -0
  548. package/packs/mongo/checks/no-drop-in-code.json +27 -0
  549. package/packs/mongo/checks/no-empty-deletemany.json +26 -0
  550. package/packs/mongo/checks/no-find-reads.json +26 -0
  551. package/packs/mongo/checks/no-input-spread-into-write.json +24 -0
  552. package/packs/mongo/checks/no-mongoose.json +23 -0
  553. package/packs/mongo/checks/no-negation-delete.json +26 -0
  554. package/packs/mongo/checks/no-non-null-after-findone.json +25 -0
  555. package/packs/mongo/checks/objectid-equals.json +26 -0
  556. package/packs/mongo/checks/update-then-reread.json +24 -0
  557. package/packs/mongo/checks/watch-not-poll.json +25 -0
  558. package/packs/mongo/pack.json +52 -0
  559. package/packs/mongo/rules/deletes-name-what-dies.md +21 -0
  560. package/packs/mongo/rules/driver-only-in-gateway.md +26 -0
  561. package/packs/mongo/rules/keys-hashed-input-picked.md +21 -0
  562. package/packs/mongo/rules/one-client-one-pool.md +32 -0
  563. package/packs/mongo/rules/reads-aggregate-writes-bulk.md +25 -0
  564. package/packs/mongo/rules/writes-are-atomic.md +27 -0
  565. package/packs/multi-tenant/checks/role-sees-all-tenants.json +26 -0
  566. package/packs/multi-tenant/checks/tenant-filter-from-url.json +25 -0
  567. package/packs/multi-tenant/pack.json +22 -0
  568. package/packs/multi-tenant/rules/no-role-crosses-a-tenant.md +21 -0
  569. package/packs/multi-tenant/skills/prove-tenant-isolation/SKILL.md +19 -0
  570. package/packs/nginx/checks/modsec-no-blanket-off.json +16 -0
  571. package/packs/nginx/checks/nginx-csp-no-unsafe.json +15 -0
  572. package/packs/nginx/checks/nginx-headers-always.json +15 -0
  573. package/packs/nginx/checks/nginx-keepalive-http11.json +20 -0
  574. package/packs/nginx/checks/nginx-logs-to-stdout.json +15 -0
  575. package/packs/nginx/checks/nginx-no-crlf.json +17 -0
  576. package/packs/nginx/checks/nginx-resolver-ttl.json +19 -0
  577. package/packs/nginx/pack.json +43 -0
  578. package/packs/nginx/rules/modsecurity-tuning.md +22 -0
  579. package/packs/nginx/rules/nginx-production.md +26 -0
  580. package/packs/nginx/skills/waf-rollout/SKILL.md +20 -0
  581. package/packs/postgres/checks/pg-bind-values.json +33 -0
  582. package/packs/postgres/checks/pg-concurrently-in-txn.json +18 -0
  583. package/packs/postgres/checks/pg-fk-not-valid.json +18 -0
  584. package/packs/postgres/checks/pg-index-concurrently.json +18 -0
  585. package/packs/postgres/checks/pg-no-float-money.json +19 -0
  586. package/packs/postgres/checks/pg-no-money.json +18 -0
  587. package/packs/postgres/checks/pg-no-required-column.json +18 -0
  588. package/packs/postgres/checks/pg-no-volatile-default.json +18 -0
  589. package/packs/postgres/checks/pg-not-exists.json +18 -0
  590. package/packs/postgres/checks/pg-timestamptz.json +18 -0
  591. package/packs/postgres/hooks/db-wipe-guard.mjs +95 -0
  592. package/packs/postgres/pack.json +48 -0
  593. package/packs/postgres/rules/postgres-migrations-never-stop-traffic.md +28 -0
  594. package/packs/postgres/rules/postgres-one-pool-per-process.md +21 -0
  595. package/packs/postgres/rules/postgres-queries-are-null-safe-and-bounded.md +26 -0
  596. package/packs/postgres/rules/postgres-types-say-what-they-hold.md +22 -0
  597. package/packs/postgres/rules/postgres-values-are-bound.md +130 -0
  598. package/packs/postgres/skills/postgres-safe-migration/SKILL.md +45 -0
  599. package/packs/python/checks/py-no-bare-except.json +18 -0
  600. package/packs/python/checks/py-no-eval.json +18 -0
  601. package/packs/python/checks/py-no-mutable-default.json +18 -0
  602. package/packs/python/checks/py-no-shell-true.json +18 -0
  603. package/packs/python/checks/py-no-star-import.json +18 -0
  604. package/packs/python/checks/py-no-swallowed-exception.json +18 -0
  605. package/packs/python/checks/py-none-by-is.json +18 -0
  606. package/packs/python/checks/py-open-with-with.json +18 -0
  607. package/packs/python/checks/py-requests-timeout.json +18 -0
  608. package/packs/python/checks/py-subprocess-output-checked.json +18 -0
  609. package/packs/python/checks/py-yaml-safe-load.json +18 -0
  610. package/packs/python/pack.json +26 -0
  611. package/packs/python/rules/python-errors-and-resources.md +26 -0
  612. package/packs/python/rules/python-repeats-become-templates.md +27 -0
  613. package/packs/python/skills/python-extract-template/SKILL.md +35 -0
  614. package/packs/react/checks/dialog-needs-role.json +28 -0
  615. package/packs/react/checks/effect-not-for-derived-state.json +24 -0
  616. package/packs/react/checks/icon-button-needs-name.json +24 -0
  617. package/packs/react/checks/label-needs-a-field.json +24 -0
  618. package/packs/react/checks/ui-failed-fetch-says-so.json +23 -0
  619. package/packs/react/checks/ui-ok-branch-has-an-else.json +23 -0
  620. package/packs/react/pack.json +20 -0
  621. package/packs/react/rules/react-accessible-controls.md +20 -0
  622. package/packs/react/rules/react-state-and-effects.md +23 -0
  623. package/packs/reverse-engineering/checks/ear-constant-tagged.json +23 -0
  624. package/packs/reverse-engineering/checks/no-default-on-distrust.json +24 -0
  625. package/packs/reverse-engineering/checks/no-rom-table-literal.json +29 -0
  626. package/packs/reverse-engineering/checks/prose-never-decides.json +22 -0
  627. package/packs/reverse-engineering/hooks/firmware-out-of-git.mjs +49 -0
  628. package/packs/reverse-engineering/pack.json +35 -0
  629. package/packs/reverse-engineering/rules/a-negative-names-what-was-scanned.md +19 -0
  630. package/packs/reverse-engineering/rules/account-every-term.md +20 -0
  631. package/packs/reverse-engineering/rules/addresses-name-their-space.md +22 -0
  632. package/packs/reverse-engineering/rules/every-law-has-a-source.md +18 -0
  633. package/packs/reverse-engineering/rules/findings-are-withdrawn-in-place.md +17 -0
  634. package/packs/reverse-engineering/rules/firmware-stays-out.md +18 -0
  635. package/packs/reverse-engineering/rules/names-before-code.md +19 -0
  636. package/packs/reverse-engineering/rules/reproduction-or-original.md +18 -0
  637. package/packs/reverse-engineering/rules/two-sources-before-naming.md +21 -0
  638. package/packs/reverse-engineering/skills/bank-census/SKILL.md +18 -0
  639. package/packs/reverse-engineering/skills/gather-sources/SKILL.md +22 -0
  640. package/packs/reverse-engineering/skills/menu-map/SKILL.md +28 -0
  641. package/packs/reverse-engineering/skills/names-first/SKILL.md +41 -0
  642. package/packs/reverse-engineering/skills/re-deliverables/SKILL.md +21 -0
  643. package/packs/reverse-engineering/skills/tripwire-the-law/SKILL.md +19 -0
  644. package/packs/reverse-engineering/tools/lib/unwrap.mjs +115 -0
  645. package/packs/reverse-engineering/tools/names-sweep.mjs +264 -0
  646. package/packs/rust/checks/rust-allow-needs-reason.json +16 -0
  647. package/packs/rust/checks/rust-blocking-in-async.json +32 -0
  648. package/packs/rust/checks/rust-if-chain-is-a-match.json +32 -0
  649. package/packs/rust/checks/rust-static-mut.json +32 -0
  650. package/packs/rust/checks/rust-string-as-error.json +34 -0
  651. package/packs/rust/checks/rust-stub-left-in.json +32 -0
  652. package/packs/rust/checks/rust-unsafe-needs-safety.json +31 -0
  653. package/packs/rust/checks/rust-unwrap-in-library.json +34 -0
  654. package/packs/rust/checks/rust-wildcard-dependency.json +16 -0
  655. package/packs/rust/clippy.toml +5 -0
  656. package/packs/rust/pack.json +27 -0
  657. package/packs/rust/rules/rust-async-never-blocks.md +20 -0
  658. package/packs/rust/rules/rust-borrow-before-you-clone.md +19 -0
  659. package/packs/rust/rules/rust-errors-are-returned.md +22 -0
  660. package/packs/rust/rules/rust-lints-are-the-gate.md +23 -0
  661. package/packs/rust/rules/rust-repeats-become-templates.md +28 -0
  662. package/packs/rust/rules/rust-unsafe-is-proved.md +21 -0
  663. package/packs/rust/skills/rust-extract-template/SKILL.md +50 -0
  664. package/packs/rust/skills/rust-port/SKILL.md +22 -0
  665. package/packs/rust/skills/rust-review/SKILL.md +24 -0
  666. package/packs/rust/tools/rust-lints.toml +19 -0
  667. package/packs/shell/checks/sh-mktemp.json +18 -0
  668. package/packs/shell/checks/sh-no-backticks.json +18 -0
  669. package/packs/shell/checks/sh-no-eval.json +18 -0
  670. package/packs/shell/checks/sh-no-parse-ls.json +18 -0
  671. package/packs/shell/checks/sh-no-pipe-to-shell.json +18 -0
  672. package/packs/shell/checks/sh-no-program-in-heredoc.json +18 -0
  673. package/packs/shell/checks/sh-quote-arguments.json +18 -0
  674. package/packs/shell/checks/sh-rm-guarded.json +18 -0
  675. package/packs/shell/checks/sh-strict-mode.json +20 -0
  676. package/packs/shell/pack.json +28 -0
  677. package/packs/shell/rules/shell-repeats-become-templates.md +23 -0
  678. package/packs/shell/rules/shell-strict-and-quoted.md +27 -0
  679. package/packs/shell/skills/shell-extract-template/SKILL.md +32 -0
  680. package/packs/shell-hooks/checks/gnu-only-in-shell.json +18 -0
  681. package/packs/shell-hooks/checks/hook-command-anchored.json +12 -0
  682. package/packs/shell-hooks/checks/hook-json-by-tool.json +18 -0
  683. package/packs/shell-hooks/checks/no-bash-c-with-variable.json +20 -0
  684. package/packs/shell-hooks/pack.json +36 -0
  685. package/packs/shell-hooks/rules/hooks-portable-anchored-quoted.md +26 -0
  686. package/packs/sound-design/checks/audio-seed-fixed.json +23 -0
  687. package/packs/sound-design/checks/mix-is-a-crossfade.json +30 -0
  688. package/packs/sound-design/checks/no-hash-in-the-signal.json +30 -0
  689. package/packs/sound-design/checks/no-literal-key-anchor.json +30 -0
  690. package/packs/sound-design/checks/test-compares-a-function-with-itself.json +22 -0
  691. package/packs/sound-design/pack.json +22 -0
  692. package/packs/sound-design/rules/algorithms-are-data.md +26 -0
  693. package/packs/sound-design/rules/meter-before-engine.md +27 -0
  694. package/packs/sound-design/rules/neutral-is-exact.md +26 -0
  695. package/packs/sound-design/rules/test-off-the-easy-point.md +28 -0
  696. package/packs/sound-design/rules/unreachable-is-said.md +25 -0
  697. package/packs/sound-design/rules/waveforms-and-octaves.md +24 -0
  698. package/packs/sound-design/skills/bounce-a-plugin/SKILL.md +40 -0
  699. package/packs/sound-design/skills/choose-observable/SKILL.md +18 -0
  700. package/packs/sound-design/skills/measure-a-law/SKILL.md +18 -0
  701. package/packs/sound-design/skills/measure-reverb/SKILL.md +19 -0
  702. package/packs/sound-design/skills/spread-probe/SKILL.md +18 -0
  703. package/packs/sound-design/tools/vst3host/build.sh +73 -0
  704. package/packs/sound-design/tools/vst3host/host_events.h +101 -0
  705. package/packs/sound-design/tools/vst3host/options.h +172 -0
  706. package/packs/sound-design/tools/vst3host/render.cpp +245 -0
  707. package/packs/sound-design/tools/vst3host/session.h +241 -0
  708. package/packs/stellix/checks/no-keyboard-focus.json +12 -0
  709. package/packs/stellix/checks/one-seeded-random.json +16 -0
  710. package/packs/stellix/checks/world-never-includes-painter.json +12 -0
  711. package/packs/stellix/checks/world-no-libm.json +15 -0
  712. package/packs/stellix/checks/world-no-unordered.json +10 -0
  713. package/packs/stellix/hooks/no-shipped-images.mjs +88 -0
  714. package/packs/stellix/pack.json +61 -0
  715. package/packs/stellix/rules/stellix-deterministic-world.md +29 -0
  716. package/packs/stellix/rules/stellix-reset-generated.md +24 -0
  717. package/packs/stellix/rules/stellix-world-snapshot.md +27 -0
  718. package/packs/stellix/rules/world-continuous-collision.md +26 -0
  719. package/packs/stellix/rules/world-fp-determinism.md +28 -0
  720. package/packs/stored-text/checks/no-raw-html-from-data.json +31 -0
  721. package/packs/stored-text/checks/stored-text-libs-only-in-renderer.json +31 -0
  722. package/packs/stored-text/checks/stored-text-renderer-complete.json +24 -0
  723. package/packs/stored-text/checks/stored-text-through-renderer.json +25 -0
  724. package/packs/stored-text/pack.json +41 -0
  725. package/packs/stored-text/rules/stored-text-renders-once.md +26 -0
  726. package/packs/stored-text/skills/render-stored-text/SKILL.md +24 -0
  727. package/packs/synth-creator/checks/timing-from-synthcore.json +24 -0
  728. package/packs/synth-creator/checks/ui-drawn-in-code.json +23 -0
  729. package/packs/synth-creator/hooks/build-guard.mjs +232 -0
  730. package/packs/synth-creator/hooks/build-sweep.mjs +166 -0
  731. package/packs/synth-creator/hooks/frozen-files.mjs +63 -0
  732. package/packs/synth-creator/hooks/idle-wake.mjs +90 -0
  733. package/packs/synth-creator/hooks/protect-vendor.mjs +175 -0
  734. package/packs/synth-creator/hooks/spec-lock.mjs +117 -0
  735. package/packs/synth-creator/hooks/stage-guard.mjs +50 -0
  736. package/packs/synth-creator/hooks/time-guard.mjs +292 -0
  737. package/packs/synth-creator/hooks/user-asks.mjs +165 -0
  738. package/packs/synth-creator/pack.json +136 -0
  739. package/packs/synth-creator/rules/copy-trees-read-only.md +25 -0
  740. package/packs/synth-creator/rules/debug-by-measurement.md +20 -0
  741. package/packs/synth-creator/rules/done-means-fresh-evidence.md +18 -0
  742. package/packs/synth-creator/rules/hooks-and-gates.md +21 -0
  743. package/packs/synth-creator/rules/long-work-in-the-background.md +16 -0
  744. package/packs/synth-creator/rules/timing-from-synthcore.md +16 -0
  745. package/packs/synth-creator/skills/build-step/SKILL.md +125 -0
  746. package/packs/synth-creator/skills/build-through-the-queue/SKILL.md +21 -0
  747. package/packs/synth-creator/tools/buildq.mjs +74 -0
  748. package/packs/synth-creator/tools/freeze.mjs +36 -0
  749. package/packs/tui/checks/tui-entry-restores-terminal.json +27 -0
  750. package/packs/tui/checks/tui-gates-on-tty.json +25 -0
  751. package/packs/tui/checks/tui-no-ris-reset.json +22 -0
  752. package/packs/tui/checks/tui-resize-listener-removed.json +26 -0
  753. package/packs/tui/checks/tui-width-is-state.json +33 -0
  754. package/packs/tui/pack.json +44 -0
  755. package/packs/tui/rules/tui-resize-and-screen.md +25 -0
  756. package/packs/tui/skills/build-tui/SKILL.md +21 -0
  757. package/packs/ui-craft/checks/ui-input-needs-autocomplete.json +23 -0
  758. package/packs/ui-craft/checks/ui-intl-for-dates.json +21 -0
  759. package/packs/ui-craft/checks/ui-no-ai-palette.json +22 -0
  760. package/packs/ui-craft/checks/ui-no-animate-layout.json +22 -0
  761. package/packs/ui-craft/checks/ui-no-assistant-palette.json +23 -0
  762. package/packs/ui-craft/checks/ui-no-bounce-easing.json +22 -0
  763. package/packs/ui-craft/checks/ui-no-custom-cursor.json +22 -0
  764. package/packs/ui-craft/checks/ui-no-emoji-as-ui.json +22 -0
  765. package/packs/ui-craft/checks/ui-no-empty-image.json +21 -0
  766. package/packs/ui-craft/checks/ui-no-eyebrow.json +21 -0
  767. package/packs/ui-craft/checks/ui-no-furniture-text.json +22 -0
  768. package/packs/ui-craft/checks/ui-no-gradient-text.json +22 -0
  769. package/packs/ui-craft/checks/ui-no-index-numbering.json +21 -0
  770. package/packs/ui-craft/checks/ui-no-lorem.json +22 -0
  771. package/packs/ui-craft/checks/ui-no-marketing-buzzword.json +22 -0
  772. package/packs/ui-craft/checks/ui-no-paste-block.json +21 -0
  773. package/packs/ui-craft/checks/ui-no-placeholder-names.json +21 -0
  774. package/packs/ui-craft/checks/ui-no-scroll-hijack.json +21 -0
  775. package/packs/ui-craft/checks/ui-no-side-tab.json +21 -0
  776. package/packs/ui-craft/checks/ui-no-stock-labels.json +22 -0
  777. package/packs/ui-craft/checks/ui-no-transition-all.json +22 -0
  778. package/packs/ui-craft/checks/ui-no-uppercase-table-header.json +21 -0
  779. package/packs/ui-craft/checks/ui-no-zebra-rows.json +22 -0
  780. package/packs/ui-craft/checks/ui-no-zoom-lock.json +21 -0
  781. package/packs/ui-craft/pack.json +43 -0
  782. package/packs/ui-craft/rules/apps-are-not-pages.md +26 -0
  783. package/packs/ui-craft/rules/data-tells-the-truth.md +26 -0
  784. package/packs/ui-craft/rules/dates-and-numbers.md +18 -0
  785. package/packs/ui-craft/rules/forms-never-fight.md +22 -0
  786. package/packs/ui-craft/rules/interface-copy.md +26 -0
  787. package/packs/ui-craft/rules/motion-is-rare.md +31 -0
  788. package/packs/ui-craft/rules/no-generated-look.md +37 -0
  789. package/packs/ui-craft/rules/page-holds-its-frame.md +28 -0
  790. package/packs/ui-craft/rules/page-proved-rendered.md +19 -0
  791. package/packs/ui-craft/rules/pictures-do-a-job.md +25 -0
  792. package/packs/ui-craft/rules/pointer-feedback.md +28 -0
  793. package/packs/ui-craft/rules/screen-answers-one-question.md +24 -0
  794. package/packs/ui-craft/rules/survives-real-data.md +23 -0
  795. package/packs/ui-craft/rules/touch-and-small-screens.md +19 -0
  796. package/packs/ui-craft/rules/type-space-colour.md +26 -0
  797. package/packs/ui-craft/rules/url-holds-the-state.md +19 -0
  798. package/packs/ui-craft/skills/app-screen/SKILL.md +33 -0
  799. package/packs/ui-craft/skills/build-from-reference/SKILL.md +28 -0
  800. package/packs/ui-craft/skills/chart-choice/SKILL.md +34 -0
  801. package/packs/ui-craft/skills/hover-state/SKILL.md +28 -0
  802. package/packs/ui-craft/skills/page-critique/SKILL.md +33 -0
  803. package/packs/ui-craft/skills/prove-page/SKILL.md +23 -0
  804. package/packs/ui-craft/skills/redesign-page/SKILL.md +19 -0
  805. package/packs/ui-craft/skills/ui-code-review/SKILL.md +22 -0
  806. package/packs/ui-craft/skills/write-the-page/SKILL.md +21 -0
  807. package/packs/ui-craft/tools/page-measure.mjs +41 -0
  808. package/packs/web/checks/a11y-img-needs-alt.json +26 -0
  809. package/packs/web/checks/a11y-no-bare-outline-none.json +21 -0
  810. package/packs/web/checks/a11y-no-clickable-div.json +26 -0
  811. package/packs/web/checks/a11y-no-positive-tabindex.json +26 -0
  812. package/packs/web/checks/client-no-api-key.json +29 -0
  813. package/packs/web/checks/client-no-browser-global-at-module-scope.json +28 -0
  814. package/packs/web/checks/client-no-server-import.json +31 -0
  815. package/packs/web/checks/client-no-window-location-nav.json +28 -0
  816. package/packs/web/checks/css-no-inline-style.json +30 -0
  817. package/packs/web/checks/ds-pages-compose-primitives.json +28 -0
  818. package/packs/web/checks/key-from-index.json +23 -0
  819. package/packs/web/checks/prodbuild-no-cdn-runtime-deps.json +21 -0
  820. package/packs/web/checks/prodbuild-no-dev-flags.json +21 -0
  821. package/packs/web/checks/prodbuild-no-remote-fonts.json +22 -0
  822. package/packs/web/checks/rcss-button-cursor.json +30 -0
  823. package/packs/web/checks/rcss-no-100vw.json +21 -0
  824. package/packs/web/checks/rcss-no-fixed-wide-width.json +21 -0
  825. package/packs/web/checks/rcss-viewport-meta.json +28 -0
  826. package/packs/web/checks/secret-not-in-web-storage.json +25 -0
  827. package/packs/web/checks/tw-no-raw-hex-in-markup.json +34 -0
  828. package/packs/web/checks/wp-hero-not-lazy.json +27 -0
  829. package/packs/web/checks/wp-img-needs-dimensions.json +26 -0
  830. package/packs/web/pack.json +73 -0
  831. package/packs/web/rules/accessibility.md +26 -0
  832. package/packs/web/rules/client-boundaries.md +23 -0
  833. package/packs/web/rules/production-build.md +22 -0
  834. package/packs/web/rules/secrets-not-in-the-browser.md +18 -0
  835. package/packs/web/rules/styles-live-in-stylesheets.md +23 -0
  836. package/packs/web/rules/tailwind-v4.md +23 -0
  837. package/packs/web/rules/ui-primitives-one-module.md +30 -0
  838. package/packs/web/rules/web-performance.md +21 -0
  839. package/packs/web/skills/design-direction/SKILL.md +30 -0
  840. package/packs/web/skills/design-review/SKILL.md +28 -0
  841. package/packs/web/skills/pick-rendering-mode/SKILL.md +21 -0
  842. package/packs/web/skills/preflight-build/SKILL.md +23 -0
  843. package/packs/web/skills/seo-audit/SKILL.md +22 -0
  844. package/packs/websocket/checks/no-token-in-query.json +26 -0
  845. package/packs/websocket/checks/stale-socket-deletes-new-entry.json +25 -0
  846. package/packs/websocket/checks/ws-identity-from-message.json +26 -0
  847. package/packs/websocket/pack.json +21 -0
  848. package/packs/websocket/rules/identity-comes-from-the-connection.md +24 -0
  849. package/packs/writing/checks/ascii-no-em-dash.json +17 -0
  850. package/packs/writing/checks/no-copula-dodging.json +18 -0
  851. package/packs/writing/checks/no-dramatic-colon.json +18 -0
  852. package/packs/writing/checks/no-not-x-but-y.json +18 -0
  853. package/packs/writing/checks/no-participial-opener.json +18 -0
  854. package/packs/writing/checks/no-pseudo-wisdom.json +18 -0
  855. package/packs/writing/checks/no-slop-words.json +18 -0
  856. package/packs/writing/checks/no-stock-connectors.json +18 -0
  857. package/packs/writing/checks/no-time-or-date.json +27 -0
  858. package/packs/writing/checks/no-trailing-ing.json +18 -0
  859. package/packs/writing/checks/no-vague-attribution.json +18 -0
  860. package/packs/writing/pack.json +43 -0
  861. package/packs/writing/rules/ascii-no-em-dash.md +21 -0
  862. package/packs/writing/rules/cut-the-padding.md +20 -0
  863. package/packs/writing/rules/direct-voice.md +22 -0
  864. package/packs/writing/rules/no-cargo-cult.md +16 -0
  865. package/packs/writing/rules/no-scaffolding.md +19 -0
  866. package/packs/writing/rules/no-stock-language.md +27 -0
  867. package/packs/writing/rules/no-time-or-date.md +18 -0
  868. package/packs/writing/rules/rhythm-like-talk.md +20 -0
  869. package/packs/writing/rules/write-from-your-own-corner.md +20 -0
  870. package/packs/writing/skills/argument-post/SKILL.md +28 -0
  871. package/packs/writing/skills/humanize/SKILL.md +28 -0
  872. package/packs/writing/skills/launch-post/SKILL.md +38 -0
  873. package/packs/writing/skills/pick-subreddit/SKILL.md +69 -0
  874. package/packs/writing/skills/post-voice/SKILL.md +22 -0
  875. package/packs/writing/skills/reddit-post/SKILL.md +63 -0
  876. package/packs/writing/skills/reddit-title/SKILL.md +23 -0
  877. package/packs/writing/skills/reply-moves/SKILL.md +40 -0
  878. package/packs/writing/skills/reply-stance/SKILL.md +23 -0
  879. package/packs/writing/skills/should-i-reply/SKILL.md +21 -0
  880. package/packs/zod/hooks/schemas-only.mjs +53 -0
  881. package/packs/zod/pack.json +44 -0
  882. package/packs/zod/rules/env-shapes-only.md +14 -0
  883. package/packs/zod/rules/zod-4-schemas.md +14 -0
  884. package/profiles/stellix.layout.json +315 -0
  885. package/profiles/sub37.layout.json +247 -0
  886. package/prompts/scan-review.md +40 -0
  887. package/prompts/survey.md +82 -0
  888. package/prompts/workorder/PROMPT.md +53 -0
  889. package/prompts/workorder/run.sh +36 -0
  890. package/prompts/workorder/workorder.md +59 -0
@@ -0,0 +1,178 @@
1
+ #!/usr/bin/env node
2
+ // The generated gate shape_symmetry (the shape law, 0.9.0). For every MANY concept in design/shape.json:
3
+ // members: every instance has the same set of members (the concept's `symmetry.members` command, run once per instance,
4
+ // prints that instance's members one per line; {i} is replaced by the instance);
5
+ // swap: every unordered pair, all N·(N-1)/2 of them, swaps the same (`symmetry.swap`, {i} and {j} replaced, exit 0).
6
+ // The project only declares the commands in shape.json; this file never holds a project's test. It was the instances-by-index
7
+ // swap check, which a folder list scoped to the engine and which let a world-side difference through.
8
+ //
9
+ // node .claude/tools/shape-symmetry.mjs run <concept> [--dir <root>] the gate for one concept (what the generated test calls)
10
+ // node .claude/tools/shape-symmetry.mjs gen --cmake <out.cmake> [--dir <root>] add_test lines, one per many concept
11
+ // node .claude/tools/shape-symmetry.mjs gen --list [--dir <root>] "<name>\t<command>" lines, for any other build system
12
+ // node .claude/tools/shape-symmetry.mjs --selftest
13
+ // The kit's CLI runs the same: `npx --no-install @thedecipherist/claude-packs symmetry run|gen ...`.
14
+ import { spawnSync } from 'node:child_process';
15
+ import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from 'node:fs';
16
+ import { dirname, join, resolve } from 'node:path';
17
+ import { fileURLToPath } from 'node:url';
18
+
19
+ const SELF = fileURLToPath(import.meta.url);
20
+ const TIMEOUT_S = 600;
21
+
22
+ export function readManifest(root) {
23
+ const file = join(root, 'design', 'shape.json');
24
+ if (!existsSync(file)) throw new Error(`no design/shape.json in ${root} (every project declares its concepts there: one or many)`);
25
+ return JSON.parse(readFileSync(file, 'utf8'));
26
+ }
27
+
28
+ export const manyConcepts = (shape) => Object.entries(shape.concepts ?? {}).filter(([, c]) => c.shape === 'many').map(([name]) => name);
29
+ export const testName = (concept) => `shape_symmetry.${concept}`;
30
+
31
+ const sh = (cmd, root, vars) => {
32
+ const line = cmd.replace(/\{([ij])\}/g, (_, k) => String(vars[k]));
33
+ const r = spawnSync(line, { shell: true, cwd: root, encoding: 'utf8', timeout: TIMEOUT_S * 1000, maxBuffer: 64 << 20 });
34
+ return { line, code: r.status ?? (r.error ? 127 : 1), out: r.stdout ?? '', err: `${r.stderr ?? ''}${r.error ? r.error.message : ''}` };
35
+ };
36
+ const tail = (text, n = 4) => text.trim().split('\n').filter(Boolean).slice(-n).map((l) => `\n ${l}`).join('');
37
+
38
+ // The instances, in order: count from the concept (many(N)), or the symmetry block's `instances` command (many, no fixed N).
39
+ function instancesOf(name, concept, root) {
40
+ const sym = concept.symmetry;
41
+ let n = concept.count;
42
+ if (n === undefined && sym.instances) {
43
+ const r = sh(sym.instances, root, {});
44
+ n = r.code === 0 ? Number(r.out.trim()) : NaN;
45
+ if (!Number.isInteger(n)) throw new Error(`${name}: the instances command "${sym.instances}" printed no count (exit ${r.code})`);
46
+ }
47
+ if (!Number.isInteger(n) || n < 1) throw new Error(`${name} is many with no count: give it "count": N, or "symmetry": { "instances": "<command printing N>" }`);
48
+ const first = sym.first ?? 0;
49
+ return Array.from({ length: n }, (_, k) => first + k);
50
+ }
51
+
52
+ // Runs the gate for one concept; prints every reading; returns 0 (same) or 1 (red).
53
+ export function runConcept(root, name, log = console.log) {
54
+ const shape = readManifest(root);
55
+ const concept = shape.concepts?.[name];
56
+ const head = `shape_symmetry ${name}`;
57
+ if (!concept) { log(`${head}: RED: no concept "${name}" in design/shape.json`); return 1; }
58
+ if (concept.shape !== 'many') { log(`${head}: RED: "${name}" is ${concept.shape}, not many; only a many concept has symmetry`); return 1; }
59
+ const sym = concept.symmetry;
60
+ if (!sym?.members || !sym?.swap) {
61
+ log(`${head}: RED: "${name}" is many but design/shape.json gives it no symmetry block. Add "symmetry": { "members": "<command printing instance {i}'s members, one per line>", "swap": "<command: exit 0 when instances {i} and {j} swap the same>" }`);
62
+ return 1;
63
+ }
64
+ let ids;
65
+ try { ids = instancesOf(name, concept, root); } catch (e) { log(`${head}: RED: ${e.message}`); return 1; }
66
+ log(`${head}: ${ids.length} instances (${ids.join(', ')}); owns: ${(concept.owns ?? []).join(', ') || '(not listed)'}`);
67
+ let red = 0;
68
+
69
+ // (a) members
70
+ const sets = new Map();
71
+ for (const i of ids) {
72
+ const r = sh(sym.members, root, { i });
73
+ const members = new Set(r.out.split('\n').map((l) => l.trim()).filter(Boolean));
74
+ if (r.code !== 0) { red += 1; log(` members ${i}: RED: "${r.line}" exited ${r.code}${tail(r.err || r.out)}`); continue; }
75
+ if (members.size === 0) { red += 1; log(` members ${i}: RED: "${r.line}" printed no members`); continue; }
76
+ sets.set(i, members);
77
+ log(` members ${i}: ${members.size}`);
78
+ }
79
+ let diffs = 0;
80
+ const first = sets.keys().next().value;
81
+ // Identical to the first means identical to each other, so many instances cost one pass, not N squared (0.22.0).
82
+ for (const i of sets.keys()) for (const j of ids.length > ALL_PAIRS_UP_TO ? [first] : sets.keys()) {
83
+ if (i === j) continue;
84
+ const lacks = [...sets.get(i)].filter((m) => !sets.get(j).has(m)).sort();
85
+ if (lacks.length) { diffs += 1; log(` members DIFFER: instance ${i} has ${lacks.join(', ')} that instance ${j} lacks`); }
86
+ }
87
+ if (diffs) red += 1;
88
+ else if (sets.size === ids.length) log(` members: every instance has the same ${sets.values().next().value.size} members`);
89
+
90
+ // (b) swap: every unordered pair of a few instances; of many, the first against an even spread (testing thousands of the same control
91
+ // is a complete waste of time; `members` above already read every one)
92
+ let pairs = 0, differ = 0;
93
+ const chosen = swapPairs(ids);
94
+ for (const [i, j] of chosen) {
95
+ const r = sh(sym.swap, root, { i, j });
96
+ pairs += 1;
97
+ if (r.code === 0) log(` swap ${i}<->${j}: same`);
98
+ else { differ += 1; log(` swap ${i}<->${j}: DIFFERS: "${r.line}" exited ${r.code}${tail(r.out + r.err)}`); }
99
+ }
100
+ const want = chosen.length;
101
+ log(ids.length > ALL_PAIRS_UP_TO ? ` swap: ${pairs} pairs checked (a spread of N = ${ids.length}), ${differ} differ` : ` swap: ${pairs} pairs checked (N·(N-1)/2 = ${want} for N = ${ids.length}), ${differ} differ`);
102
+ if (differ || pairs !== want) red += 1;
103
+ log(`${head}: ${red ? 'RED' : 'GREEN'}`);
104
+ return red ? 1 : 0;
105
+ }
106
+
107
+ const ALL_PAIRS_UP_TO = 8;
108
+ const SPREAD = 8;
109
+ function swapPairs(ids) {
110
+ if (ids.length <= ALL_PAIRS_UP_TO) return ids.flatMap((a, x) => ids.slice(x + 1).map((b) => [a, b]));
111
+ const step = (ids.length - 1) / SPREAD;
112
+ return [...new Set(Array.from({ length: SPREAD }, (_, k) => Math.round((k + 1) * step)))].map((x) => [ids[0], ids[x]]);
113
+ }
114
+
115
+ // One test per many concept. A many concept with no symmetry block still gets its test, which is red until it has one.
116
+ export function generate(root, { cmake, list } = {}, log = console.log) {
117
+ const shape = readManifest(root);
118
+ const names = manyConcepts(shape);
119
+ const abs = resolve(root);
120
+ const argv = (n) => [process.execPath, SELF, 'run', n, '--dir', abs];
121
+ if (list) for (const n of names) log(`${testName(n)}\t${argv(n).map((a) => (/\s/.test(a) ? `"${a}"` : a)).join(' ')}`);
122
+ if (cmake) {
123
+ const q = (s) => `"${s.replace(/\\/g, '/').replace(/"/g, '\\"')}"`;
124
+ const lines = [
125
+ '# Generated by claude-packs (shape-symmetry.mjs gen) from design/shape.json at configure time. Never edit, never commit:',
126
+ '# a change to the manifest re-runs the configure step, which writes this file again.',
127
+ `set_property(DIRECTORY APPEND PROPERTY CMAKE_CONFIGURE_DEPENDS ${q(join(abs, 'design', 'shape.json'))})`,
128
+ ...names.flatMap((n) => [
129
+ `add_test(NAME ${testName(n)} COMMAND ${argv(n).map(q).join(' ')})`,
130
+ `set_tests_properties(${testName(n)} PROPERTIES LABELS shape_symmetry TIMEOUT 3600)`,
131
+ ]),
132
+ '',
133
+ ];
134
+ mkdirSync(dirname(resolve(cmake)), { recursive: true });
135
+ writeFileSync(resolve(cmake), lines.join('\n'));
136
+ const none = names.filter((n) => !shape.concepts[n].symmetry);
137
+ log(`shape_symmetry: ${names.length} test(s) in ${cmake}: ${names.map(testName).join(', ') || '(no many concept)'}${none.length ? `; red until they have a symmetry block: ${none.join(', ')}` : ''}`);
138
+ }
139
+ return 0;
140
+ }
141
+
142
+ function args(argv) {
143
+ const o = { rest: [], dir: process.env.CLAUDE_PROJECT_DIR ?? process.cwd() };
144
+ for (let k = 0; k < argv.length; k += 1) {
145
+ if (argv[k] === '--dir') o.dir = argv[++k];
146
+ else if (argv[k] === '--cmake') o.cmake = argv[++k];
147
+ else if (argv[k] === '--list') o.list = true;
148
+ else o.rest.push(argv[k]);
149
+ }
150
+ o.dir = resolve(o.dir);
151
+ return o;
152
+ }
153
+
154
+ export const USAGE = `usage: shape-symmetry run <concept> [--dir <root>]
155
+ shape-symmetry gen --cmake <out.cmake> | --list [--dir <root>]
156
+ In CMakeLists.txt (configure time):
157
+ execute_process(COMMAND node \${CMAKE_SOURCE_DIR}/.claude/tools/shape-symmetry.mjs gen --dir \${CMAKE_SOURCE_DIR}
158
+ --cmake \${CMAKE_BINARY_DIR}/shape_symmetry.cmake COMMAND_ERROR_IS_FATAL ANY)
159
+ include(\${CMAKE_BINARY_DIR}/shape_symmetry.cmake)`;
160
+
161
+ export async function main(argv) {
162
+ if (argv[0] === '--selftest') return (await import('./shape-symmetry-selftest.mjs')).selftest(SELF);
163
+ const o = args(argv);
164
+ const [cmd, concept] = o.rest;
165
+ try {
166
+ if (cmd === 'run' && concept) return runConcept(o.dir, concept);
167
+ if (cmd === 'gen' && (o.cmake || o.list)) return generate(o.dir, o);
168
+ } catch (e) {
169
+ console.error(`shape_symmetry: ${e.message}`);
170
+ return 2;
171
+ }
172
+ console.error(USAGE);
173
+ return 2;
174
+ }
175
+
176
+ // realpath: the module's own URL is the real path, the command line may go through a symlink (/var is /private/var on macOS),
177
+ // and a tool that silently does nothing reads as green.
178
+ if (process.argv[1] && realpathSync(process.argv[1]) === realpathSync(SELF)) main(process.argv.slice(2)).then((c) => process.exit(c));
@@ -0,0 +1,75 @@
1
+ #!/usr/bin/env node
2
+ // Run the test command and hand back only the verdict, so a 5,000-line CTest log never enters
3
+ // the conversation. The full output goes to a log file whose path is in the JSON.
4
+ // node .claude/tools/test-verdict.mjs [-R <regex>] project test command (layout.commands.test)
5
+ // node .claude/tools/test-verdict.mjs --red <name,name> [-R <regex>] Red Gate: these tests MUST fail
6
+ // node .claude/tools/test-verdict.mjs -- <any command> your own command
7
+ // Exit 0: verdict as required (green, or the --red tests all failing). Exit 1: real failures
8
+ // (or a --red test passing). Exit 2: the runner itself broke (no tests ran, command missing):
9
+ // never a verdict about the code; fix the runner first.
10
+ import { spawnSync } from 'node:child_process';
11
+ import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
12
+ import { join } from 'node:path';
13
+
14
+ const ROOT = process.env.CLAUDE_PROJECT_DIR ?? process.cwd();
15
+
16
+ export function parseCtest(out) {
17
+ const total = out.match(/(\d+)% tests passed, (\d+) tests? failed out of (\d+)/);
18
+ const failed = [];
19
+ const block = out.split(/The following tests FAILED:/)[1] ?? '';
20
+ for (const m of block.matchAll(/^\s*\d+\s+-\s+(\S+)\s+\(([^)]+)\)/gm)) failed.push({ name: m[1], why: m[2] });
21
+ if (!total) return null;
22
+ return { total: Number(total[3]), failed };
23
+ }
24
+
25
+ function detail(out, name) {
26
+ const at = out.indexOf(`Test: ${name}`) >= 0 ? out.indexOf(`Test: ${name}`) : out.indexOf(name);
27
+ return at < 0 ? '' : out.slice(at, at + 1200).split('\n').slice(0, 15).join('\n');
28
+ }
29
+
30
+ function command(args) {
31
+ const dash = args.indexOf('--');
32
+ if (dash >= 0) return args.slice(dash + 1).join(' ');
33
+ let base;
34
+ try {
35
+ base = JSON.parse(readFileSync(join(ROOT, '.claude', 'layout.json'), 'utf8')).commands?.test;
36
+ } catch { /* no layout */ }
37
+ base ??= 'ctest --test-dir build --output-on-failure';
38
+ const r = args.indexOf('-R');
39
+ return r >= 0 ? `${base} -R '${args[r + 1]}'` : base;
40
+ }
41
+
42
+ function main(args) {
43
+ const red = args.includes('--red') ? args[args.indexOf('--red') + 1].split(',').filter(Boolean) : null;
44
+ const cmd = command(args);
45
+ const run = spawnSync('bash', ['-c', cmd], { cwd: ROOT, encoding: 'utf8', maxBuffer: 256 * 1024 * 1024 });
46
+ const out = `${run.stdout ?? ''}${run.stderr ?? ''}`;
47
+ mkdirSync(join(ROOT, '.claude', 'state'), { recursive: true });
48
+ const log = join('.claude', 'state', 'last-test.log');
49
+ writeFileSync(join(ROOT, log), out);
50
+ const parsed = parseCtest(out);
51
+ if (!parsed || parsed.total === 0) {
52
+ console.log(JSON.stringify({ verdict: 'RUNNER_BROKEN', command: cmd, exit: run.status, log, tail: out.split('\n').slice(-15).join('\n') }, null, 1));
53
+ return 2;
54
+ }
55
+ const failures = parsed.failed.map((f) => ({ ...f, detail: detail(out, f.name) }));
56
+ if (red) {
57
+ const failedNames = new Set(parsed.failed.map((f) => f.name));
58
+ const passing = red.filter((n) => !failedNames.has(n));
59
+ const verdict = passing.length ? 'RED_GATE_FAILED' : 'RED_CONFIRMED';
60
+ console.log(JSON.stringify({ verdict, mustFail: red, passingUnexpectedly: passing, total: parsed.total, log }, null, 1));
61
+ return passing.length ? 1 : 0;
62
+ }
63
+ const verdict = failures.length ? 'FAILED' : 'GREEN';
64
+ console.log(JSON.stringify({ verdict, total: parsed.total, failed: failures, log }, null, 1));
65
+ return failures.length ? 1 : 0;
66
+ }
67
+
68
+ if (process.argv.includes('--selftest')) {
69
+ const sample = '50% tests passed, 1 tests failed out of 2\n\nThe following tests FAILED:\n\t 2 - svf_stable_under_fm (Failed)\nErrors while running CTest\n';
70
+ const p = parseCtest(sample);
71
+ const ok = p?.total === 2 && p.failed[0]?.name === 'svf_stable_under_fm' && parseCtest('100% tests passed, 0 tests failed out of 9')?.failed.length === 0 && parseCtest('No tests were found!!!') === null;
72
+ console.log(ok ? 'test-verdict selftest: OK (3 cases)' : 'test-verdict selftest FAILED');
73
+ process.exit(ok ? 0 : 1);
74
+ }
75
+ process.exit(main(process.argv.slice(2)));
@@ -0,0 +1,18 @@
1
+ {
2
+ "id": "ci-permissions-stated",
3
+ "why": "With no permissions block a workflow gets the repository default, which can write.",
4
+ "rule": ".claude/rules/ci-covers-what-ships.md",
5
+ "globs": [
6
+ ".github/workflows/*.yml",
7
+ ".github/workflows/*.yaml"
8
+ ],
9
+ "exclude": [],
10
+ "pattern": "^on:",
11
+ "flags": "m",
12
+ "mode": "needs",
13
+ "needs": [
14
+ "^permissions:|^\\s+permissions:"
15
+ ],
16
+ "bad": "on: push\njobs:\n test:\n runs-on: ubuntu-latest\n",
17
+ "good": "on: push\npermissions:\n contents: read\njobs:\n test:\n runs-on: ubuntu-latest\n"
18
+ }
@@ -0,0 +1,14 @@
1
+ {
2
+ "id": "ci-tools-pinned",
3
+ "why": "A floating tool version changes the build under you, and the Dockerfile that pins it no longer matches.",
4
+ "rule": ".claude/rules/ci-covers-what-ships.md",
5
+ "globs": [
6
+ ".github/workflows/*.yml",
7
+ ".github/workflows/*.yaml"
8
+ ],
9
+ "exclude": [],
10
+ "pattern": "^\\s*(?:version|node-version|python-version|go-version):\\s*['\\\"]?latest\\b",
11
+ "flags": "m",
12
+ "bad": " - uses: pnpm/action-setup@v4\n with:\n version: latest\n",
13
+ "good": " - uses: pnpm/action-setup@v4\n with:\n version: 9.15.0\n"
14
+ }
@@ -0,0 +1,21 @@
1
+ {
2
+ "name": "ci",
3
+ "version": "1.0.0",
4
+ "description": "CI: every language in the repo is built and tested, actions and tools are pinned, and permissions are stated.",
5
+ "type": "stock",
6
+ "author": "claude-packs",
7
+ "license": "MIT",
8
+ "homepage": "https://github.com/TheDecipherist/claude-packs",
9
+ "repository": {
10
+ "type": "git",
11
+ "url": "https://github.com/TheDecipherist/claude-packs.git",
12
+ "directory": "packs/ci"
13
+ },
14
+ "keywords": [
15
+ "ci",
16
+ "github-actions"
17
+ ],
18
+ "engines": {
19
+ "claude-packs": ">=0.25.0"
20
+ }
21
+ }
@@ -0,0 +1,20 @@
1
+ ---
2
+ paths:
3
+ - ".github/workflows/**"
4
+ ---
5
+
6
+ # CI builds and tests every language the repo ships, with pinned tools and stated permissions
7
+
8
+ <constraints>
9
+ Always do:
10
+ - Run a build and the tests for every language in the repo, and build the images.
11
+ - Pin actions and tools to a version.
12
+ - State `permissions:` at the top of each workflow, as narrow as it needs.
13
+
14
+ Never do:
15
+ - Use `version: latest` for a tool.
16
+ - Treat a language CI never runs as tested.
17
+ </constraints>
18
+
19
+ ## Check
20
+ `ci-tools-pinned`, `ci-permissions-stated`.
@@ -0,0 +1,15 @@
1
+ ---
2
+ paths:
3
+ - ".github/workflows/**"
4
+ - "**/CMakeLists.txt"
5
+ ---
6
+
7
+ # Regenerating a generated file gives no diff
8
+
9
+ <constraints>
10
+ Always do:
11
+ - Regenerate generated headers and tables in CI, and fail on `git diff --exit-code`.
12
+
13
+ Never do:
14
+ - Trust a generated file nobody regenerates: modes once stayed clamped for weeks, with everything green.
15
+ </constraints>
@@ -0,0 +1,27 @@
1
+ {
2
+ "id": "captcha-is-not-constant",
3
+ "why": "A constant captcha answer is passed by any script that has seen it once.",
4
+ "rule": ".claude/rules/public-forms-are-defended.md",
5
+ "globs": [
6
+ "**/*.ts",
7
+ "**/*.tsx",
8
+ "**/*.js",
9
+ "**/*.mjs",
10
+ "**/*.cjs"
11
+ ],
12
+ "exclude": [
13
+ "**/tests/**",
14
+ "**/test/**",
15
+ "**/*.test.*",
16
+ "**/*.spec.*",
17
+ "**/e2e/**",
18
+ "**/node_modules/**",
19
+ "**/dist/**",
20
+ "**/build/**",
21
+ "**/.next/**"
22
+ ],
23
+ "pattern": "\\b\\w*CAPTCHA\\w*ANSWER\\w*\\s*=\\s*['\\\"`]|\\b(?:captcha|challenge)\\w*[Aa]nswer\\s*=\\s*['\\\"`]",
24
+ "bad": "const CAPTCHA_ANSWER = 'K';",
25
+ "good": "const answer = await newChallenge(session);",
26
+ "kind": "security"
27
+ }
@@ -0,0 +1,20 @@
1
+ {
2
+ "id": "img-has-size",
3
+ "why": "An image with no size makes the page jump as it loads.",
4
+ "rule": ".claude/rules/media-is-sized.md",
5
+ "globs": [
6
+ "**/*.html"
7
+ ],
8
+ "exclude": [
9
+ "**/node_modules/**",
10
+ "**/dist/**",
11
+ "**/build/**",
12
+ "**/admin*/**",
13
+ "**/*template*",
14
+ "**/partials/**",
15
+ "**/_*/**"
16
+ ],
17
+ "pattern": "<img\\b(?![^>]*\\bwidth=)[^>]*>",
18
+ "bad": "<img src=\"/a.webp\" alt=\"A\">",
19
+ "good": "<img src=\"/a.webp\" alt=\"A\" width=\"800\" height=\"600\">"
20
+ }
@@ -0,0 +1,26 @@
1
+ {
2
+ "id": "page-head-complete",
3
+ "why": "A page with no canonical, description or social image is found less, and shared badly.",
4
+ "rule": ".claude/rules/page-head-is-complete.md",
5
+ "globs": [
6
+ "**/*.html"
7
+ ],
8
+ "exclude": [
9
+ "**/node_modules/**",
10
+ "**/dist/**",
11
+ "**/build/**",
12
+ "**/admin*/**",
13
+ "**/*template*",
14
+ "**/partials/**",
15
+ "**/_*/**"
16
+ ],
17
+ "pattern": "<html\\b",
18
+ "bad": "<html lang=\"en\"><head><title>A</title></head></html>",
19
+ "good": "<html lang=\"en\"><head><title>A</title><meta name=\"description\" content=\"x\"><link rel=\"canonical\" href=\"/a\"><meta property=\"og:image\" content=\"/a.png\"></head></html>",
20
+ "mode": "needs",
21
+ "needs": [
22
+ "rel=[\"']canonical",
23
+ "name=[\"']description",
24
+ "property=[\"']og:image"
25
+ ]
26
+ }
@@ -0,0 +1,22 @@
1
+ {
2
+ "name": "content-site",
3
+ "version": "1.0.0",
4
+ "description": "Sites that publish: blogs, docs and marketing pages. Every page has a complete head, a page has one source, public forms are defended, comments are moderated, and media is sized.",
5
+ "type": "stock",
6
+ "author": "claude-packs",
7
+ "license": "MIT",
8
+ "homepage": "https://github.com/TheDecipherist/claude-packs",
9
+ "repository": {
10
+ "type": "git",
11
+ "url": "https://github.com/TheDecipherist/claude-packs.git",
12
+ "directory": "packs/content-site"
13
+ },
14
+ "keywords": [
15
+ "seo",
16
+ "blog",
17
+ "content"
18
+ ],
19
+ "engines": {
20
+ "claude-packs": ">=0.27.0"
21
+ }
22
+ }
@@ -0,0 +1,23 @@
1
+ ---
2
+ paths:
3
+ - "**/*.html"
4
+ - "**/*.md"
5
+ - "**/*.mdx"
6
+ - "**/*.tsx"
7
+ - "**/*.ts"
8
+ - "**/*.js"
9
+ ---
10
+
11
+ # A page has one source, and what is built from it is never edited
12
+
13
+ <constraints>
14
+ Always do:
15
+ - Keep one source for each page, and generate the rest: HTML, the index, the sitemap, the feed.
16
+ - Regenerate the sitemap in the build, so a new page cannot be left out.
17
+ - Keep URLs stable. A renamed page gets a redirect, in the same change.
18
+ - Keep tutorial files and sample code in a folder scans can tell from the project's own.
19
+
20
+ Never do:
21
+ - Edit generated HTML by hand, or keep two folders with the same article under different slugs.
22
+ - Change a published URL without a redirect.
23
+ </constraints>
@@ -0,0 +1,24 @@
1
+ ---
2
+ paths:
3
+ - "**/*.html"
4
+ - "**/*.md"
5
+ - "**/*.mdx"
6
+ - "**/*.tsx"
7
+ - "**/*.ts"
8
+ - "**/*.js"
9
+ ---
10
+
11
+ # Images are sized and light, and big files stay out of git
12
+
13
+ <constraints>
14
+ Always do:
15
+ - Give every image `width` and `height`, so the page does not jump.
16
+ - Lazy load what is below the fold, and serve modern formats.
17
+ - Keep large media in object storage or a release, out of the repo.
18
+
19
+ Never do:
20
+ - Commit a working screenshot or a debug dump (`repo-litter` refuses them).
21
+ </constraints>
22
+
23
+ ## Check
24
+ `img-has-size`.
@@ -0,0 +1,26 @@
1
+ ---
2
+ paths:
3
+ - "**/*.html"
4
+ - "**/*.md"
5
+ - "**/*.mdx"
6
+ - "**/*.tsx"
7
+ - "**/*.ts"
8
+ - "**/*.js"
9
+ ---
10
+
11
+ # Every public page has a complete head
12
+
13
+ <constraints>
14
+ Always do:
15
+ - Give every public page a unique `<title>`, a `description`, a `canonical` link, Open Graph tags with an image, and `lang` on `<html>`.
16
+ - Add structured data (`application/ld+json`) for articles.
17
+ - Build the head from one template, fed by the page's own data.
18
+ - Keep admin and preview pages out of search with `noindex`.
19
+
20
+ Never do:
21
+ - Copy a head from page to page by hand.
22
+ - Ship a page with no canonical link: duplicates then compete with each other.
23
+ </constraints>
24
+
25
+ ## Check
26
+ `page-head-complete`.
@@ -0,0 +1,27 @@
1
+ ---
2
+ paths:
3
+ - "**/*.html"
4
+ - "**/*.md"
5
+ - "**/*.mdx"
6
+ - "**/*.tsx"
7
+ - "**/*.ts"
8
+ - "**/*.js"
9
+ ---
10
+
11
+ # A public form expects abuse: rate limits, a real challenge, moderation
12
+
13
+ <constraints>
14
+ Always do:
15
+ - Rate limit every public form, per IP and per account.
16
+ - Use a challenge that cannot be replayed or read from the page, or a honeypot and a time check.
17
+ - Hold comments for moderation by default, with a status field.
18
+ - Render user text through one sanitiser, on the server, and store the source as well as the output.
19
+ - Escape every value that goes into `innerHTML`, or use `textContent`.
20
+
21
+ Never do:
22
+ - Use a constant captcha answer: a script passes it.
23
+ - Trust the client's copy of a score, a rating or a counter.
24
+ </constraints>
25
+
26
+ ## Check
27
+ `captcha-is-not-constant`.
@@ -0,0 +1,21 @@
1
+ ---
2
+ name: publish-a-page
3
+ description: Use when adding or renaming an article, a blog post or a public page.
4
+ ---
5
+
6
+ # Publish a page (one job: it is found, it loads fast, and old links still work)
7
+
8
+ <constraints>
9
+ Always do:
10
+ 1. Write the source, and build the page from it. Never edit the built HTML.
11
+ 2. Check the head: title, description, canonical, Open Graph image, structured data.
12
+ 3. Size and compress every image.
13
+ 4. Run the build, so the index, the sitemap and the feed include it.
14
+ 5. For a rename, add the redirect in the same change.
15
+ 6. Open the page at phone width, and read it once as a stranger.
16
+ 7. Run the `humanize` skill on the text.
17
+
18
+ Never do:
19
+ - Publish with a placeholder image or description.
20
+ - Reuse a slug for different content.
21
+ </constraints>
@@ -0,0 +1,16 @@
1
+ {
2
+ "id": "cpp-clamp-before-cast",
3
+ "why": "Casting a NaN or an out-of-range float to an integer is undefined, so a clamp after the cast comes too late. Clamp the float, then cast, and check a computed value is finite first.",
4
+ "rule": ".claude/rules/cpp-numbers-and-casts.md",
5
+ "concepts": [
6
+ "cpp"
7
+ ],
8
+ "globs": [],
9
+ "exclude": [
10
+ "**/build/**"
11
+ ],
12
+ "code": true,
13
+ "pattern": "std::(?:clamp|min|max)(?:<\\w+>)?\\s*\\(\\s*(?:-?[\\w.]+\\s*,\\s*)?(?:(?:int|long|int\\d+_t|size_t)\\s*\\(|static_cast<\\s*(?:int|long|std::int\\d+_t|int\\d+_t|std::size_t|size_t)\\s*>\\s*\\()(?!\\s*std::l+r(?:ound|int)\\b)(?=[^;\\n]*(?:\\d\\.\\d|std::(?:floor|ceil|round|trunc|log|log2|log10|sqrt|pow|exp)\\b|float\\s*\\(|double\\s*\\(|/))",
14
+ "bad": "const int steps = std::clamp (int (dist / 0.25f), 8, 240);",
15
+ "good": "const int steps = int (std::clamp (dist / 0.25f, 8.0f, 240.0f));\nstd::clamp (int (std::lround (x)), 0, 4);\nstd::max (0, int (list.size()) - 1);"
16
+ }
@@ -0,0 +1,12 @@
1
+ {
2
+ "id": "cpp-find-with-the-library",
3
+ "why": "A search loop over a list, compared on one member, is short enough to be copied everywhere, and every copy treats a miss its own way. std::ranges::find with a projection says it in one call; a search used twice is one named function.",
4
+ "rule": ".claude/rules/cpp-find-with-the-library.md",
5
+ "concepts": ["cpp"],
6
+ "globs": [],
7
+ "exclude": ["**/build/**"],
8
+ "code": true,
9
+ "pattern": "for\\s*\\(\\s*(?:const\\s+)?auto\\s*&&?\\s*(\\w+)\\s*:\\s*[^;{}\\n]+\\)\\s*\\{?\\s*if\\s*\\(\\s*\\1\\s*(?:\\.|->)\\s*\\w+\\s*==[^\\n]*\\)\\s*(?:\\{[^{}]{0,200}?)?\\b(?:return|break)\\b",
10
+ "bad": "for (const auto& c : shown().controls) if (c.id == id) return &c;",
11
+ "good": "const auto it = std::ranges::find (controls, id, &Control::id);\nfor (const auto& c : controls) total += c.width;\nfor (const auto& c : controls) if (c.width > limit) wide.push_back (c);\nfor (const auto& target : targets) if (target.kind == none) continue;"
12
+ }
@@ -0,0 +1,18 @@
1
+ {
2
+ "id": "cpp-hardened-test-build",
3
+ "why": "Standard library hardening turns an out-of-range index into a stop instead of silent memory access. A test build should have it.",
4
+ "rule": ".claude/rules/cpp-absent-and-failed-are-types.md",
5
+ "concepts": [],
6
+ "globs": [
7
+ "**/CMakePresets.json"
8
+ ],
9
+ "exclude": [],
10
+ "code": false,
11
+ "pattern": "\"CMAKE_CXX_FLAGS\"\\s*:",
12
+ "bad": "{\"CMAKE_CXX_FLAGS\": \"-O2\"}",
13
+ "good": "{\"CMAKE_CXX_FLAGS\": \"-D_LIBCPP_HARDENING_MODE=_LIBCPP_HARDENING_MODE_FAST\"}",
14
+ "mode": "needs",
15
+ "needs": [
16
+ "_LIBCPP_HARDENING_MODE|_GLIBCXX_ASSERTIONS"
17
+ ]
18
+ }
@@ -0,0 +1,23 @@
1
+ {
2
+ "id": "cpp-m-pi-not-standard",
3
+ "why": "M_PI is not standard C++: MSVC hides it, and the missing name cascades into strange errors. std::numbers has it.",
4
+ "rule": ".claude/rules/cpp-builds-everywhere.md",
5
+ "globs": [
6
+ "**/*.cpp",
7
+ "**/*.cc",
8
+ "**/*.h",
9
+ "**/*.hpp",
10
+ "**/*.mm"
11
+ ],
12
+ "exclude": [
13
+ "**/build/**",
14
+ "**/out/**",
15
+ "**/_deps/**",
16
+ "**/JUCE/**",
17
+ "**/node_modules/**"
18
+ ],
19
+ "pattern": "\\bM_(?:PI|PI_2|PI_4|E|SQRT2|LN2)\\b",
20
+ "bad": "const double w = 2.0 * M_PI * f;",
21
+ "good": "const double w = 2.0 * std::numbers::pi * f;",
22
+ "code": true
23
+ }