@thedecipherist/claude-packs 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 (827) hide show
  1. package/CHANGELOG.md +680 -0
  2. package/LICENSE +21 -0
  3. package/README.md +316 -2
  4. package/bin/claude-packs.mjs +204 -0
  5. package/configurations/base/config.json +85 -0
  6. package/configurations/cpp/config.json +92 -0
  7. package/configurations/full-stack/config.json +152 -0
  8. package/configurations/go/config.json +96 -0
  9. package/configurations/node/config.json +100 -0
  10. package/configurations/python/config.json +97 -0
  11. package/configurations/synth-creator/config.json +148 -0
  12. package/global/hooks/gnu-shell.mjs +131 -0
  13. package/global/hooks/lib/program-read.mjs +196 -0
  14. package/global/hooks/lib/program-writes.mjs +177 -0
  15. package/global/hooks/lib/shell-writes.mjs +293 -0
  16. package/global/hooks/shell-traps.mjs +79 -0
  17. package/global/hooks/version-pin-guard.mjs +280 -0
  18. package/global/skills/latest-versions/SKILL.md +49 -0
  19. package/lib/backup.mjs +34 -0
  20. package/lib/claude-md.mjs +58 -0
  21. package/lib/config-cli.mjs +36 -0
  22. package/lib/configs.mjs +145 -0
  23. package/lib/coverage.mjs +86 -0
  24. package/lib/custom-packs.mjs +93 -0
  25. package/lib/doctor.mjs +115 -0
  26. package/lib/fix-plan.mjs +71 -0
  27. package/lib/git-tokens.mjs +64 -0
  28. package/lib/global.mjs +125 -0
  29. package/lib/hook-proof.mjs +28 -0
  30. package/lib/hook-timing.mjs +42 -0
  31. package/lib/hover-gate.mjs +29 -0
  32. package/lib/kit-lock.mjs +149 -0
  33. package/lib/layout.mjs +75 -0
  34. package/lib/logs.mjs +69 -0
  35. package/lib/manifest.mjs +24 -0
  36. package/lib/new.mjs +49 -0
  37. package/lib/once-only-report.mjs +54 -0
  38. package/lib/pack-manifest.mjs +20 -0
  39. package/lib/packs.mjs +107 -0
  40. package/lib/planner.mjs +59 -0
  41. package/lib/repeats.mjs +65 -0
  42. package/lib/repo-weight.mjs +28 -0
  43. package/lib/rules.mjs +40 -0
  44. package/lib/scan-detect.mjs +94 -0
  45. package/lib/scan.mjs +168 -0
  46. package/lib/selftest-cache.mjs +39 -0
  47. package/lib/settings.mjs +138 -0
  48. package/lib/shape-cli.mjs +76 -0
  49. package/lib/shape.mjs +4 -0
  50. package/lib/suggest.mjs +18 -0
  51. package/lib/switches.mjs +44 -0
  52. package/lib/symmetry-doctor.mjs +26 -0
  53. package/lib/sync.mjs +130 -0
  54. package/package.json +34 -4
  55. package/packs/ai/checks/boundary-computes-its-own-hash.json +30 -0
  56. package/packs/ai/checks/model-call-needs-boundary.json +29 -0
  57. package/packs/ai/checks/model-id-from-config.json +28 -0
  58. package/packs/ai/checks/model-output-validated.json +26 -0
  59. package/packs/ai/pack.json +38 -0
  60. package/packs/ai/rules/ai-input-sha-boundary.md +31 -0
  61. package/packs/ai/rules/llm-pipeline-security.md +26 -0
  62. package/packs/audio-core/checks/denormals-not-in-prepare.json +12 -0
  63. package/packs/audio-core/checks/dsp-without-apvts.json +12 -0
  64. package/packs/audio-core/checks/float-phase-or-rate.json +12 -0
  65. package/packs/audio-core/checks/juce-snap-to-zero-off.json +12 -0
  66. package/packs/audio-core/checks/keep-werror.json +12 -0
  67. package/packs/audio-core/checks/no-fast-math.json +14 -0
  68. package/packs/audio-core/checks/no-locale-change.json +12 -0
  69. package/packs/audio-core/checks/no-march-native.json +14 -0
  70. package/packs/audio-core/clang-tidy +28 -0
  71. package/packs/audio-core/hooks/lib/realtime-checks.mjs +56 -0
  72. package/packs/audio-core/hooks/param-id-lock.mjs +129 -0
  73. package/packs/audio-core/hooks/realtime-guard.mjs +67 -0
  74. package/packs/audio-core/pack.json +187 -0
  75. package/packs/audio-core/rules/audio-thread-realtime-safe.md +27 -0
  76. package/packs/audio-core/rules/audio-ui-thread-handoff.md +21 -0
  77. package/packs/audio-core/rules/boundary-tests-cross-the-boundary.md +16 -0
  78. package/packs/audio-core/rules/build-flags-safe.md +20 -0
  79. package/packs/audio-core/rules/cached-parameter-pointers.md +28 -0
  80. package/packs/audio-core/rules/clang-tidy-core-guidelines.md +21 -0
  81. package/packs/audio-core/rules/control-reaches-every-surface.md +23 -0
  82. package/packs/audio-core/rules/cpu-worst-case-per-block.md +26 -0
  83. package/packs/audio-core/rules/dc-block-after-asymmetry.md +22 -0
  84. package/packs/audio-core/rules/discrete-params-snap.md +19 -0
  85. package/packs/audio-core/rules/double-where-precision-matters.md +20 -0
  86. package/packs/audio-core/rules/filters-stable-under-modulation.md +29 -0
  87. package/packs/audio-core/rules/host-parameters-at-scale.md +24 -0
  88. package/packs/audio-core/rules/house-control-behaviours.md +34 -0
  89. package/packs/audio-core/rules/math-domain-guards.md +19 -0
  90. package/packs/audio-core/rules/modulated-delay-interpolation.md +22 -0
  91. package/packs/audio-core/rules/multiband-phase-coherent.md +22 -0
  92. package/packs/audio-core/rules/nonlinear-stages-antialiased.md +28 -0
  93. package/packs/audio-core/rules/note-ledger-and-pedals.md +22 -0
  94. package/packs/audio-core/rules/one-formula-per-value.md +20 -0
  95. package/packs/audio-core/rules/optimisations-are-null-tested.md +23 -0
  96. package/packs/audio-core/rules/oscillators-bandlimited.md +23 -0
  97. package/packs/audio-core/rules/output-limiter.md +23 -0
  98. package/packs/audio-core/rules/parameter-ids-never-change.md +20 -0
  99. package/packs/audio-core/rules/params-and-state-thread-safe.md +19 -0
  100. package/packs/audio-core/rules/params-snapshot-per-block.md +21 -0
  101. package/packs/audio-core/rules/patch-excludes-performance-controls.md +18 -0
  102. package/packs/audio-core/rules/per-sample-code-inlinable.md +22 -0
  103. package/packs/audio-core/rules/prepare-is-repeatable.md +23 -0
  104. package/packs/audio-core/rules/recursive-state-nan-guard.md +20 -0
  105. package/packs/audio-core/rules/reverb-loop-gain-bounded.md +24 -0
  106. package/packs/audio-core/rules/sample-accurate-midi.md +22 -0
  107. package/packs/audio-core/rules/sample-rate-and-block-size-from-host.md +23 -0
  108. package/packs/audio-core/rules/scoped-no-denormals.md +26 -0
  109. package/packs/audio-core/rules/smooth-continuous-parameters.md +22 -0
  110. package/packs/audio-core/rules/state-load-versioned-and-safe.md +22 -0
  111. package/packs/audio-core/rules/straight-on-and-aligned.md +21 -0
  112. package/packs/audio-core/rules/ui-matches-reference-look.md +21 -0
  113. package/packs/audio-core/rules/undo-one-gesture-one-step.md +21 -0
  114. package/packs/audio-core/rules/voice-steal-fades.md +21 -0
  115. package/packs/audio-core/rules/voice-sum-headroom.md +20 -0
  116. package/packs/audio-core/skills/analyse-reference-look/SKILL.md +21 -0
  117. package/packs/audio-core/skills/copy-and-prove/SKILL.md +98 -0
  118. package/packs/audio-core/skills/juce-realtime-audit/SKILL.md +22 -0
  119. package/packs/audio-core/skills/measure-tone/SKILL.md +20 -0
  120. package/packs/audio-core/skills/new-panel-control/SKILL.md +15 -0
  121. package/packs/audio-core/skills/prove-control/SKILL.md +23 -0
  122. package/packs/audio-core/skills/trace-parameter/SKILL.md +29 -0
  123. package/packs/audio-core/tools/lib/spectrum.mjs +112 -0
  124. package/packs/audio-core/tools/lib/wav.mjs +41 -0
  125. package/packs/audio-core/tools/tone-report.mjs +47 -0
  126. package/packs/base/checks/field-map-over-if-runs.json +25 -0
  127. package/packs/base/checks/lookup-over-if-chains.json +25 -0
  128. package/packs/base/checks/lookup-over-ternary-chains.json +20 -0
  129. package/packs/base/checks/no-code-after-midline-comment.json +12 -0
  130. package/packs/base/checks/one-walk-per-template.json +23 -0
  131. package/packs/base/checks/stub-reports-success.json +31 -0
  132. package/packs/base/checks/test-skip-on-failed-setup.json +17 -0
  133. package/packs/base/hooks/brief-guard.mjs +96 -0
  134. package/packs/base/hooks/code-shape.mjs +95 -0
  135. package/packs/base/hooks/dispatch-once.mjs +87 -0
  136. package/packs/base/hooks/file-size-guard.mjs +61 -0
  137. package/packs/base/hooks/folder-law.mjs +74 -0
  138. package/packs/base/hooks/git-guard.mjs +289 -0
  139. package/packs/base/hooks/lesson-checks.mjs +174 -0
  140. package/packs/base/hooks/lib/apply-edit.mjs +20 -0
  141. package/packs/base/hooks/lib/code-shapes.mjs +137 -0
  142. package/packs/base/hooks/lib/content.mjs +14 -0
  143. package/packs/base/hooks/lib/cpp-scan.mjs +94 -0
  144. package/packs/base/hooks/lib/dup-index.mjs +199 -0
  145. package/packs/base/hooks/lib/dup.mjs +127 -0
  146. package/packs/base/hooks/lib/elements.mjs +87 -0
  147. package/packs/base/hooks/lib/event-log.mjs +67 -0
  148. package/packs/base/hooks/lib/function-shapes.mjs +90 -0
  149. package/packs/base/hooks/lib/git-adds.mjs +20 -0
  150. package/packs/base/hooks/lib/git-guard-selftest.mjs +99 -0
  151. package/packs/base/hooks/lib/glob.mjs +33 -0
  152. package/packs/base/hooks/lib/hook-log.mjs +100 -0
  153. package/packs/base/hooks/lib/house.py +77 -0
  154. package/packs/base/hooks/lib/languages.mjs +66 -0
  155. package/packs/base/hooks/lib/layout.mjs +54 -0
  156. package/packs/base/hooks/lib/making-check-selftest.mjs +109 -0
  157. package/packs/base/hooks/lib/near-copies.mjs +76 -0
  158. package/packs/base/hooks/lib/program-read.mjs +196 -0
  159. package/packs/base/hooks/lib/program-writes.mjs +177 -0
  160. package/packs/base/hooks/lib/project.mjs +81 -0
  161. package/packs/base/hooks/lib/prose.mjs +11 -0
  162. package/packs/base/hooks/lib/pushed.mjs +201 -0
  163. package/packs/base/hooks/lib/repo-index.mjs +52 -0
  164. package/packs/base/hooks/lib/secret-patterns.mjs +18 -0
  165. package/packs/base/hooks/lib/selftest.mjs +45 -0
  166. package/packs/base/hooks/lib/shape-code.mjs +126 -0
  167. package/packs/base/hooks/lib/shape.mjs +294 -0
  168. package/packs/base/hooks/lib/shell-writes-selftest.mjs +65 -0
  169. package/packs/base/hooks/lib/shell-writes.mjs +293 -0
  170. package/packs/base/hooks/lib/turn.mjs +81 -0
  171. package/packs/base/hooks/lib/writes.mjs +71 -0
  172. package/packs/base/hooks/making-check.mjs +243 -0
  173. package/packs/base/hooks/making.mjs +106 -0
  174. package/packs/base/hooks/once-only.mjs +150 -0
  175. package/packs/base/hooks/placement-law.mjs +84 -0
  176. package/packs/base/hooks/repo-litter.mjs +75 -0
  177. package/packs/base/hooks/reuse-hint.mjs +75 -0
  178. package/packs/base/hooks/run-hooks.mjs +132 -0
  179. package/packs/base/hooks/secrets-guard.mjs +99 -0
  180. package/packs/base/hooks/shape-law.mjs +133 -0
  181. package/packs/base/hooks/suite-once.mjs +80 -0
  182. package/packs/base/hooks/template-law.mjs +148 -0
  183. package/packs/base/hooks/untrusted-boundary.mjs +53 -0
  184. package/packs/base/pack.json +214 -0
  185. package/packs/base/rules/a-control-is-seen-to-fire.md +27 -0
  186. package/packs/base/rules/behaviour-lives-with-its-kind.md +51 -0
  187. package/packs/base/rules/bug-fix-starts-red.md +25 -0
  188. package/packs/base/rules/field-map-over-if-runs.md +47 -0
  189. package/packs/base/rules/finished-work-lands.md +17 -0
  190. package/packs/base/rules/git-right-first-time.md +19 -0
  191. package/packs/base/rules/instances-by-index-identities-by-id.md +54 -0
  192. package/packs/base/rules/lookup-over-if-chains.md +49 -0
  193. package/packs/base/rules/making-line-first.md +14 -0
  194. package/packs/base/rules/open-items-tagged.md +17 -0
  195. package/packs/base/rules/plan-and-logs.md +22 -0
  196. package/packs/base/rules/references-use-anchors.md +19 -0
  197. package/packs/base/rules/refusals-are-judged.md +18 -0
  198. package/packs/base/rules/reuse-before-writing.md +15 -0
  199. package/packs/base/rules/secrets-never-committed.md +16 -0
  200. package/packs/base/rules/skill-writing.md +23 -0
  201. package/packs/base/rules/split-before-the-limit.md +14 -0
  202. package/packs/base/rules/subagent-dispatch.md +26 -0
  203. package/packs/base/rules/test-only-what-changed.md +17 -0
  204. package/packs/base/rules/test-the-template-once.md +22 -0
  205. package/packs/base/rules/untrusted-content-boundary.md +15 -0
  206. package/packs/base/skills/add-lesson-check/SKILL.md +26 -0
  207. package/packs/base/skills/fix-from-scan/SKILL.md +25 -0
  208. package/packs/base/skills/land-branch/SKILL.md +24 -0
  209. package/packs/base/skills/make-it-a-template/SKILL.md +23 -0
  210. package/packs/base/skills/pdf-to-md/SKILL.md +25 -0
  211. package/packs/base/skills/pick-tests/SKILL.md +20 -0
  212. package/packs/base/skills/pressure-test-skill/SKILL.md +23 -0
  213. package/packs/base/skills/prove-instances-identical/SKILL.md +37 -0
  214. package/packs/base/tools/shape-symmetry-selftest.mjs +66 -0
  215. package/packs/base/tools/shape-symmetry.mjs +178 -0
  216. package/packs/base/tools/test-verdict.mjs +75 -0
  217. package/packs/ci/checks/ci-permissions-stated.json +18 -0
  218. package/packs/ci/checks/ci-tools-pinned.json +14 -0
  219. package/packs/ci/pack.json +21 -0
  220. package/packs/ci/rules/ci-covers-what-ships.md +20 -0
  221. package/packs/ci/rules/generated-files-have-no-diff.md +15 -0
  222. package/packs/content-site/checks/captcha-is-not-constant.json +27 -0
  223. package/packs/content-site/checks/img-has-size.json +20 -0
  224. package/packs/content-site/checks/page-head-complete.json +26 -0
  225. package/packs/content-site/pack.json +22 -0
  226. package/packs/content-site/rules/content-has-one-source.md +23 -0
  227. package/packs/content-site/rules/media-is-sized.md +24 -0
  228. package/packs/content-site/rules/page-head-is-complete.md +26 -0
  229. package/packs/content-site/rules/public-forms-are-defended.md +27 -0
  230. package/packs/content-site/skills/publish-a-page/SKILL.md +21 -0
  231. package/packs/cpp/checks/cpp-clamp-before-cast.json +16 -0
  232. package/packs/cpp/checks/cpp-find-with-the-library.json +12 -0
  233. package/packs/cpp/checks/cpp-hardened-test-build.json +18 -0
  234. package/packs/cpp/checks/cpp-m-pi-not-standard.json +23 -0
  235. package/packs/cpp/checks/cpp-no-atoi.json +16 -0
  236. package/packs/cpp/checks/cpp-no-const-cast.json +16 -0
  237. package/packs/cpp/checks/cpp-no-float-loop-counter.json +16 -0
  238. package/packs/cpp/checks/cpp-no-getenv-in-product.json +22 -0
  239. package/packs/cpp/checks/cpp-no-mutable-global.json +20 -0
  240. package/packs/cpp/checks/cpp-no-mutable-local-static.json +23 -0
  241. package/packs/cpp/checks/cpp-no-unchecked-fwrite.json +17 -0
  242. package/packs/cpp/checks/cpp-no-using-namespace-in-header.json +19 -0
  243. package/packs/cpp/checks/cpp-no-zero-size-array.json +23 -0
  244. package/packs/cpp/checks/cpp-numbers-pi.json +16 -0
  245. package/packs/cpp/pack.json +22 -0
  246. package/packs/cpp/rules/cpp-absent-and-failed-are-types.md +24 -0
  247. package/packs/cpp/rules/cpp-builds-everywhere.md +26 -0
  248. package/packs/cpp/rules/cpp-faults-only-in-the-test-build.md +21 -0
  249. package/packs/cpp/rules/cpp-find-with-the-library.md +19 -0
  250. package/packs/cpp/rules/cpp-gates-share-one-reader.md +22 -0
  251. package/packs/cpp/rules/cpp-headers-declare.md +22 -0
  252. package/packs/cpp/rules/cpp-numbers-and-casts.md +22 -0
  253. package/packs/cpp/rules/cpp-repeats-become-templates.md +33 -0
  254. package/packs/cpp/rules/cpp-static-analysis-runs.md +22 -0
  255. package/packs/cpp/rules/cpp-thread-contracts-are-code.md +23 -0
  256. package/packs/cpp/skills/cpp-extract-template/SKILL.md +38 -0
  257. package/packs/docker/checks/alpine-with-native-build.json +13 -0
  258. package/packs/docker/checks/compose-db-needs-auth.json +14 -0
  259. package/packs/docker/checks/compose-image-pinned.json +14 -0
  260. package/packs/docker/checks/compose-no-hardcoded-ip.json +12 -0
  261. package/packs/docker/checks/compose-no-host-bind-for-data.json +18 -0
  262. package/packs/docker/checks/compose-no-plaintext-secret.json +13 -0
  263. package/packs/docker/checks/compose-no-swarm-ignored-keys.json +13 -0
  264. package/packs/docker/checks/compose-overlay-not-bridge.json +13 -0
  265. package/packs/docker/checks/compose-service-needs-healthcheck.json +11 -0
  266. package/packs/docker/checks/compose-service-needs-init.json +11 -0
  267. package/packs/docker/checks/copy-needs-chown-with-user.json +17 -0
  268. package/packs/docker/checks/copy-source-before-deps.json +13 -0
  269. package/packs/docker/checks/docker-exec-form.json +16 -0
  270. package/packs/docker/checks/dockerfile-needs-healthcheck.json +17 -0
  271. package/packs/docker/checks/dockerfile-needs-user.json +21 -0
  272. package/packs/docker/checks/dockerignore-has-the-basics.json +21 -0
  273. package/packs/docker/checks/gitattributes-forces-lf.json +17 -0
  274. package/packs/docker/checks/health-checks-nothing.json +25 -0
  275. package/packs/docker/checks/no-crlf-in-scripts.json +15 -0
  276. package/packs/docker/checks/no-latest-base.json +13 -0
  277. package/packs/docker/checks/no-secret-in-image.json +13 -0
  278. package/packs/docker/checks/no-sensitive-file-copy.json +13 -0
  279. package/packs/docker/checks/node-env-before-install.json +13 -0
  280. package/packs/docker/checks/npm-ci-not-install.json +13 -0
  281. package/packs/docker/pack.json +46 -0
  282. package/packs/docker/rules/compose-pinned-and-closed.md +21 -0
  283. package/packs/docker/rules/compose-swarm-safe.md +26 -0
  284. package/packs/docker/rules/docker-exec-form.md +19 -0
  285. package/packs/docker/rules/dockerfile-multistage.md +13 -0
  286. package/packs/docker/rules/dockerfile-production.md +25 -0
  287. package/packs/docker/skills/docker-diagnose/SKILL.md +23 -0
  288. package/packs/dynamic-data/checks/draft-on-the-server.json +27 -0
  289. package/packs/dynamic-data/checks/guard-does-its-job.json +28 -0
  290. package/packs/dynamic-data/checks/key-is-not-a-display-name.json +28 -0
  291. package/packs/dynamic-data/checks/no-code-from-data.json +29 -0
  292. package/packs/dynamic-data/checks/no-collection-from-request.json +27 -0
  293. package/packs/dynamic-data/checks/no-pipeline-from-stored-text.json +27 -0
  294. package/packs/dynamic-data/checks/no-regexp-from-stored-config.json +27 -0
  295. package/packs/dynamic-data/checks/no-template-from-stored-text.json +27 -0
  296. package/packs/dynamic-data/checks/save-takes-named-paths.json +27 -0
  297. package/packs/dynamic-data/pack.json +23 -0
  298. package/packs/dynamic-data/rules/a-list-is-a-saved-query.md +23 -0
  299. package/packs/dynamic-data/rules/definitions-are-validated-data.md +24 -0
  300. package/packs/dynamic-data/rules/every-dynamic-surface-has-a-boundary.md +29 -0
  301. package/packs/dynamic-data/rules/fields-have-owners.md +22 -0
  302. package/packs/dynamic-data/rules/imports-drop-nothing.md +26 -0
  303. package/packs/dynamic-data/rules/one-definition-many-surfaces.md +24 -0
  304. package/packs/dynamic-data/rules/one-fact-one-place.md +28 -0
  305. package/packs/dynamic-data/rules/rules-live-in-the-engine.md +29 -0
  306. package/packs/dynamic-data/rules/saves-are-patches.md +28 -0
  307. package/packs/dynamic-data/rules/tenant-costs-one-document.md +22 -0
  308. package/packs/dynamic-data/skills/design-a-definition/SKILL.md +24 -0
  309. package/packs/fastify/checks/api-routes-versioned.json +28 -0
  310. package/packs/fastify/checks/cookie-host-prefix.json +24 -0
  311. package/packs/fastify/checks/hijack-needs-try.json +28 -0
  312. package/packs/fastify/checks/no-cast-at-route-boundary.json +24 -0
  313. package/packs/fastify/checks/no-db-in-route-file.json +28 -0
  314. package/packs/fastify/checks/no-err-message-to-client.json +24 -0
  315. package/packs/fastify/checks/no-regexp-from-input.json +24 -0
  316. package/packs/fastify/checks/no-trust-proxy-true.json +25 -0
  317. package/packs/fastify/checks/one-error-body.json +26 -0
  318. package/packs/fastify/checks/origin-from-config-not-host.json +31 -0
  319. package/packs/fastify/checks/password-needs-slow-hash.json +30 -0
  320. package/packs/fastify/checks/sec-headers-present.json +28 -0
  321. package/packs/fastify/checks/secrets-compared-constant-time.json +24 -0
  322. package/packs/fastify/checks/sse-needs-error-listener.json +28 -0
  323. package/packs/fastify/checks/user-bytes-need-disposition.json +29 -0
  324. package/packs/fastify/pack.json +41 -0
  325. package/packs/fastify/rules/credentials-and-input.md +23 -0
  326. package/packs/fastify/rules/security-one-switch.md +28 -0
  327. package/packs/fastify/rules/streams-and-hijacks.md +22 -0
  328. package/packs/fastify/rules/tests-use-inject.md +13 -0
  329. package/packs/fastify/rules/three-layers.md +20 -0
  330. package/packs/fastify/rules/trust-config-not-headers.md +24 -0
  331. package/packs/full-stack/checks/no-express-no-vite.json +23 -0
  332. package/packs/full-stack/hooks/stack-guard.mjs +90 -0
  333. package/packs/full-stack/pack.json +76 -0
  334. package/packs/full-stack/rules/stack-is-fastify-and-nextjs.md +20 -0
  335. package/packs/go/checks/go-exec-result-ignored.json +15 -0
  336. package/packs/go/checks/go-unmarshal-error-ignored.json +15 -0
  337. package/packs/go/pack.json +21 -0
  338. package/packs/go/rules/go-errors-are-handled.md +22 -0
  339. package/packs/gpu-painter/checks/dawn-backends-and-validation.json +9 -0
  340. package/packs/gpu-painter/checks/dawn-no-spontaneous.json +10 -0
  341. package/packs/gpu-painter/checks/dawn-present-on-render-thread.json +17 -0
  342. package/packs/gpu-painter/checks/gpu-no-frame-stalls.json +12 -0
  343. package/packs/gpu-painter/checks/no-opengl-link.json +11 -0
  344. package/packs/gpu-painter/checks/no-opengl.json +13 -0
  345. package/packs/gpu-painter/hooks/browser-guard.py +196 -0
  346. package/packs/gpu-painter/pack.json +91 -0
  347. package/packs/gpu-painter/rules/dawn-build-and-shaders.md +27 -0
  348. package/packs/gpu-painter/rules/dawn-device-and-render-thread.md +26 -0
  349. package/packs/gpu-painter/rules/gpu-antialiasing.md +20 -0
  350. package/packs/gpu-painter/rules/gpu-blend-order.md +22 -0
  351. package/packs/gpu-painter/rules/gpu-bloom.md +20 -0
  352. package/packs/gpu-painter/rules/gpu-frame-budget.md +25 -0
  353. package/packs/gpu-painter/rules/gpu-frame-pacing-and-power.md +27 -0
  354. package/packs/gpu-painter/rules/gpu-frame-work.md +30 -0
  355. package/packs/gpu-painter/rules/gpu-golden-images.md +21 -0
  356. package/packs/gpu-painter/rules/gpu-hdr-and-tonemap.md +23 -0
  357. package/packs/gpu-painter/rules/gpu-picking-on-cpu.md +19 -0
  358. package/packs/gpu-painter/rules/gpu-render-lifecycle.md +25 -0
  359. package/packs/gpu-painter/rules/gpu-text-atlas.md +24 -0
  360. package/packs/gpu-painter/rules/gpu-travellers-from-snapshot.md +24 -0
  361. package/packs/gpu-painter/rules/hover-every-pressable.md +25 -0
  362. package/packs/gpu-painter/skills/gpu-capture/SKILL.md +15 -0
  363. package/packs/gpu-painter/skills/gpu-frame-bench/SKILL.md +14 -0
  364. package/packs/gpu-painter/skills/gpu-golden-check/SKILL.md +13 -0
  365. package/packs/gpu-painter/skills/gpu-golden-update/SKILL.md +16 -0
  366. package/packs/gpu-painter/skills/gpu-lifecycle-stress/SKILL.md +15 -0
  367. package/packs/gpu-painter/skills/hover-state/SKILL.md +33 -0
  368. package/packs/hook-proof/checks/hook-catch-must-not-allow.json +16 -0
  369. package/packs/hook-proof/checks/hook-command-no-pipe.json +16 -0
  370. package/packs/hook-proof/checks/hook-exit-1-does-not-block.json +17 -0
  371. package/packs/hook-proof/checks/hook-no-or-true.json +18 -0
  372. package/packs/hook-proof/checks/hook-refusal-on-stderr.json +17 -0
  373. package/packs/hook-proof/pack.json +38 -0
  374. package/packs/hook-proof/rules/a-refusal-is-exit-2.md +28 -0
  375. package/packs/hook-proof/skills/prove-a-hook/SKILL.md +21 -0
  376. package/packs/host-agent/checks/file-path-from-param.json +27 -0
  377. package/packs/host-agent/checks/integrity-check-optional.json +27 -0
  378. package/packs/host-agent/checks/quoted-value-into-config.json +24 -0
  379. package/packs/host-agent/checks/secret-on-argv.json +28 -0
  380. package/packs/host-agent/checks/ssh-verifies-host-key.json +27 -0
  381. package/packs/host-agent/checks/system-file-written-in-place.json +26 -0
  382. package/packs/host-agent/checks/tmp-path-predictable.json +27 -0
  383. package/packs/host-agent/pack.json +22 -0
  384. package/packs/host-agent/rules/root-on-other-machines.md +27 -0
  385. package/packs/html-ui/checks/email-html-escapes.json +25 -0
  386. package/packs/html-ui/checks/external-link-rel.json +21 -0
  387. package/packs/html-ui/checks/no-duplicate-escape.json +26 -0
  388. package/packs/html-ui/checks/no-inline-client-script.json +21 -0
  389. package/packs/html-ui/checks/no-inline-style.json +23 -0
  390. package/packs/html-ui/pack.json +33 -0
  391. package/packs/html-ui/rules/email-html-escapes.md +19 -0
  392. package/packs/html-ui/rules/server-html-escapes-everything.md +22 -0
  393. package/packs/http-api/checks/api-path-versioned.json +31 -0
  394. package/packs/http-api/checks/authz-from-request-body.json +26 -0
  395. package/packs/http-api/checks/client-calls-a-version.json +28 -0
  396. package/packs/http-api/checks/client-ip-not-leftmost-xff.json +28 -0
  397. package/packs/http-api/checks/cors-needs-origin.json +26 -0
  398. package/packs/http-api/checks/csp-not-switched-off.json +28 -0
  399. package/packs/http-api/checks/debug-route-not-shipped.json +26 -0
  400. package/packs/http-api/checks/encrypted-name-plaintext-value.json +26 -0
  401. package/packs/http-api/checks/err-text-stays-server-side.json +27 -0
  402. package/packs/http-api/checks/failure-is-not-empty.json +28 -0
  403. package/packs/http-api/checks/gate-is-not-a-todo.json +27 -0
  404. package/packs/http-api/checks/guard-fails-open.json +28 -0
  405. package/packs/http-api/checks/hmac-over-reserialised-body.json +26 -0
  406. package/packs/http-api/checks/jwt-verify-pins-algorithm.json +26 -0
  407. package/packs/http-api/checks/middleware-skips-without-user.json +26 -0
  408. package/packs/http-api/checks/next-api-route-versioned.json +47 -0
  409. package/packs/http-api/checks/no-security-off-switch.json +28 -0
  410. package/packs/http-api/checks/oauth-state-signed.json +26 -0
  411. package/packs/http-api/checks/one-time-code-compared-raw.json +26 -0
  412. package/packs/http-api/checks/query-cast-is-not-validation.json +28 -0
  413. package/packs/http-api/checks/queue-action-from-client.json +26 -0
  414. package/packs/http-api/checks/rate-limit-one-module.json +28 -0
  415. package/packs/http-api/checks/role-checked-in-one-guard.json +27 -0
  416. package/packs/http-api/checks/route-body-needs-schema.json +31 -0
  417. package/packs/http-api/checks/route-scopes-to-the-caller.json +31 -0
  418. package/packs/http-api/checks/secret-compared-constant-time-any.json +28 -0
  419. package/packs/http-api/checks/secret-in-job-record.json +27 -0
  420. package/packs/http-api/checks/server-fetches-tenant-url.json +30 -0
  421. package/packs/http-api/checks/short-code-needs-limit.json +26 -0
  422. package/packs/http-api/checks/user-url-through-safe-fetch.json +28 -0
  423. package/packs/http-api/checks/webhook-dedupes-event-id.json +30 -0
  424. package/packs/http-api/pack.json +45 -0
  425. package/packs/http-api/rules/adapters-one-db-gateway.md +18 -0
  426. package/packs/http-api/rules/apis-are-versioned.md +27 -0
  427. package/packs/http-api/rules/credentials-handled-safely.md +22 -0
  428. package/packs/http-api/rules/handlers-own-the-work.md +17 -0
  429. package/packs/http-api/rules/health-and-correlation.md +17 -0
  430. package/packs/http-api/rules/one-error-contract.md +17 -0
  431. package/packs/http-api/rules/routes-are-thin.md +17 -0
  432. package/packs/http-api/rules/routes-scope-to-the-caller.md +26 -0
  433. package/packs/http-api/rules/routes-validate-and-answer.md +25 -0
  434. package/packs/http-api/skills/change-an-api/SKILL.md +20 -0
  435. package/packs/http-api/skills/secure-a-route/SKILL.md +21 -0
  436. package/packs/instrument-shell/checks/no-raw-struct-blob.json +23 -0
  437. package/packs/instrument-shell/pack.json +22 -0
  438. package/packs/instrument-shell/rules/fold-keeps-every-route.md +24 -0
  439. package/packs/instrument-shell/rules/quiet-announces-itself.md +22 -0
  440. package/packs/instrument-shell/rules/render-the-extremes.md +25 -0
  441. package/packs/instrument-shell/rules/seams-are-declared.md +27 -0
  442. package/packs/instrument-shell/rules/session-blob-append-only.md +25 -0
  443. package/packs/instrument-shell/skills/gates-from-commit-one/SKILL.md +20 -0
  444. package/packs/instrument-shell/skills/hit-the-painted-control/SKILL.md +18 -0
  445. package/packs/js-ts/checks/async-callback-unguarded.json +26 -0
  446. package/packs/js-ts/checks/background-loop-needs-stop.json +28 -0
  447. package/packs/js-ts/checks/child-process-error-handler.json +28 -0
  448. package/packs/js-ts/checks/entry-registers-shutdown.json +31 -0
  449. package/packs/js-ts/checks/fetch-needs-timeout.json +30 -0
  450. package/packs/js-ts/checks/job-only-in-memory.json +28 -0
  451. package/packs/js-ts/checks/json-only-through-helper.json +29 -0
  452. package/packs/js-ts/checks/line-under-200-chars.json +34 -0
  453. package/packs/js-ts/checks/localhost-default-in-server.json +29 -0
  454. package/packs/js-ts/checks/no-any.json +27 -0
  455. package/packs/js-ts/checks/no-cast-escape-hatches.json +24 -0
  456. package/packs/js-ts/checks/no-console-in-app.json +31 -0
  457. package/packs/js-ts/checks/no-dynamic-import-node-builtin.json +25 -0
  458. package/packs/js-ts/checks/no-inline-binary.json +20 -0
  459. package/packs/js-ts/checks/no-inline-zod-outside-schemas.json +27 -0
  460. package/packs/js-ts/checks/no-local-sleep.json +25 -0
  461. package/packs/js-ts/checks/no-nested-ternary.json +20 -0
  462. package/packs/js-ts/checks/no-secret-in-log.json +24 -0
  463. package/packs/js-ts/checks/no-shell-string-interpolation.json +24 -0
  464. package/packs/js-ts/checks/no-swallowed-errors.json +25 -0
  465. package/packs/js-ts/checks/no-ts-enum.json +20 -0
  466. package/packs/js-ts/checks/process-env-only-in-config.json +31 -0
  467. package/packs/js-ts/checks/race-leaves-work-running.json +23 -0
  468. package/packs/js-ts/checks/reject-as-catch-all-exists.json +24 -0
  469. package/packs/js-ts/checks/secret-has-no-fallback.json +24 -0
  470. package/packs/js-ts/checks/secret-needs-crypto-random.json +24 -0
  471. package/packs/js-ts/checks/server-close-awaited.json +27 -0
  472. package/packs/js-ts/checks/session-user-typed-once.json +24 -0
  473. package/packs/js-ts/checks/switch-is-a-table.json +24 -0
  474. package/packs/js-ts/checks/test-imports-the-source.json +19 -0
  475. package/packs/js-ts/checks/test-name-says-behaviour.json +16 -0
  476. package/packs/js-ts/checks/tsconfig-flags.json +21 -0
  477. package/packs/js-ts/checks/void-needs-catch.json +24 -0
  478. package/packs/js-ts/checks/zod-string-needs-max.json +25 -0
  479. package/packs/js-ts/checks/zod-v4-formats.json +23 -0
  480. package/packs/js-ts/pack.json +84 -0
  481. package/packs/js-ts/rules/await-handled-at-a-boundary.md +66 -0
  482. package/packs/js-ts/rules/env-through-config.md +36 -0
  483. package/packs/js-ts/rules/errors-never-swallowed.md +33 -0
  484. package/packs/js-ts/rules/files-under-300-lines.md +18 -0
  485. package/packs/js-ts/rules/guard-clauses-over-nesting.md +34 -0
  486. package/packs/js-ts/rules/js-repeats-become-templates.md +26 -0
  487. package/packs/js-ts/rules/json-only-through-one-helper.md +62 -0
  488. package/packs/js-ts/rules/named-constants-not-magic-numbers.md +34 -0
  489. package/packs/js-ts/rules/no-any.md +34 -0
  490. package/packs/js-ts/rules/no-console.md +30 -0
  491. package/packs/js-ts/rules/no-floating-promises.md +31 -0
  492. package/packs/js-ts/rules/no-param-mutation.md +28 -0
  493. package/packs/js-ts/rules/no-unsafe-assertions.md +30 -0
  494. package/packs/js-ts/rules/one-logger.md +24 -0
  495. package/packs/js-ts/rules/outbound-calls-have-a-limit.md +20 -0
  496. package/packs/js-ts/rules/parallel-independent-awaits.md +29 -0
  497. package/packs/js-ts/rules/process-lifecycle.md +47 -0
  498. package/packs/js-ts/rules/schema-single-source-of-truth.md +36 -0
  499. package/packs/js-ts/rules/secrets-stay-secret.md +22 -0
  500. package/packs/js-ts/rules/small-functions.md +20 -0
  501. package/packs/js-ts/rules/test-names-describe-behavior.md +28 -0
  502. package/packs/js-ts/rules/tests-can-fail.md +19 -0
  503. package/packs/js-ts/rules/tsconfig-strict.md +32 -0
  504. package/packs/js-ts/rules/typed-exports.md +27 -0
  505. package/packs/js-ts/rules/types-once-at-the-edge.md +18 -0
  506. package/packs/js-ts/rules/unions-over-enums.md +29 -0
  507. package/packs/js-ts/rules/zod-at-route-boundaries.md +40 -0
  508. package/packs/midi/checks/active-sensing-no-pulse.json +24 -0
  509. package/packs/midi/checks/clock-not-at-sample-zero.json +23 -0
  510. package/packs/midi/checks/midi-realtime-first.json +27 -0
  511. package/packs/midi/checks/no-tempo-writeback.json +23 -0
  512. package/packs/midi/checks/position-not-integrated.json +25 -0
  513. package/packs/midi/checks/stub-playhead-advances.json +27 -0
  514. package/packs/midi/checks/sysex-length-literal.json +23 -0
  515. package/packs/midi/checks/sysex-not-on-audio.json +24 -0
  516. package/packs/midi/checks/sysex-survives-realtime.json +27 -0
  517. package/packs/midi/pack.json +22 -0
  518. package/packs/midi/rules/clock-is-a-pulse-stream.md +30 -0
  519. package/packs/midi/rules/imports-count-every-loss.md +25 -0
  520. package/packs/midi/rules/measure-the-clock-in-audio.md +30 -0
  521. package/packs/midi/rules/sync-is-a-mode.md +29 -0
  522. package/packs/midi/rules/sysex-is-a-record.md +29 -0
  523. package/packs/midi/skills/clock-probe/SKILL.md +23 -0
  524. package/packs/midi/skills/clock-probe/clock-law.md +417 -0
  525. package/packs/midi/skills/does-it-sync/SKILL.md +19 -0
  526. package/packs/mongo/checks/bulk-over-many.json +28 -0
  527. package/packs/mongo/checks/created-at-immutable.json +25 -0
  528. package/packs/mongo/checks/driver-outside-gateway.json +24 -0
  529. package/packs/mongo/checks/key-lookup-is-hashed.json +24 -0
  530. package/packs/mongo/checks/mongoclient-cached-and-named.json +34 -0
  531. package/packs/mongo/checks/mongoclient-outside-gateway.json +24 -0
  532. package/packs/mongo/checks/no-count-plus-one-ids.json +25 -0
  533. package/packs/mongo/checks/no-db-write-in-loop.json +25 -0
  534. package/packs/mongo/checks/no-drop-in-code.json +27 -0
  535. package/packs/mongo/checks/no-empty-deletemany.json +26 -0
  536. package/packs/mongo/checks/no-find-reads.json +26 -0
  537. package/packs/mongo/checks/no-input-spread-into-write.json +24 -0
  538. package/packs/mongo/checks/no-mongoose.json +23 -0
  539. package/packs/mongo/checks/no-negation-delete.json +26 -0
  540. package/packs/mongo/checks/no-non-null-after-findone.json +25 -0
  541. package/packs/mongo/checks/objectid-equals.json +26 -0
  542. package/packs/mongo/checks/update-then-reread.json +24 -0
  543. package/packs/mongo/checks/watch-not-poll.json +25 -0
  544. package/packs/mongo/pack.json +52 -0
  545. package/packs/mongo/rules/deletes-name-what-dies.md +21 -0
  546. package/packs/mongo/rules/driver-only-in-gateway.md +26 -0
  547. package/packs/mongo/rules/keys-hashed-input-picked.md +21 -0
  548. package/packs/mongo/rules/one-client-one-pool.md +32 -0
  549. package/packs/mongo/rules/reads-aggregate-writes-bulk.md +25 -0
  550. package/packs/mongo/rules/writes-are-atomic.md +27 -0
  551. package/packs/multi-tenant/checks/role-sees-all-tenants.json +26 -0
  552. package/packs/multi-tenant/checks/tenant-filter-from-url.json +25 -0
  553. package/packs/multi-tenant/pack.json +22 -0
  554. package/packs/multi-tenant/rules/no-role-crosses-a-tenant.md +21 -0
  555. package/packs/multi-tenant/skills/prove-tenant-isolation/SKILL.md +19 -0
  556. package/packs/nginx/checks/modsec-no-blanket-off.json +16 -0
  557. package/packs/nginx/checks/nginx-csp-no-unsafe.json +15 -0
  558. package/packs/nginx/checks/nginx-headers-always.json +15 -0
  559. package/packs/nginx/checks/nginx-keepalive-http11.json +20 -0
  560. package/packs/nginx/checks/nginx-logs-to-stdout.json +15 -0
  561. package/packs/nginx/checks/nginx-no-crlf.json +17 -0
  562. package/packs/nginx/checks/nginx-resolver-ttl.json +19 -0
  563. package/packs/nginx/pack.json +43 -0
  564. package/packs/nginx/rules/modsecurity-tuning.md +22 -0
  565. package/packs/nginx/rules/nginx-production.md +26 -0
  566. package/packs/nginx/skills/waf-rollout/SKILL.md +20 -0
  567. package/packs/python/checks/py-no-bare-except.json +18 -0
  568. package/packs/python/checks/py-no-eval.json +18 -0
  569. package/packs/python/checks/py-no-mutable-default.json +18 -0
  570. package/packs/python/checks/py-no-shell-true.json +18 -0
  571. package/packs/python/checks/py-no-star-import.json +18 -0
  572. package/packs/python/checks/py-no-swallowed-exception.json +18 -0
  573. package/packs/python/checks/py-none-by-is.json +18 -0
  574. package/packs/python/checks/py-open-with-with.json +18 -0
  575. package/packs/python/checks/py-requests-timeout.json +18 -0
  576. package/packs/python/checks/py-subprocess-output-checked.json +18 -0
  577. package/packs/python/checks/py-yaml-safe-load.json +18 -0
  578. package/packs/python/pack.json +26 -0
  579. package/packs/python/rules/python-errors-and-resources.md +26 -0
  580. package/packs/python/rules/python-repeats-become-templates.md +27 -0
  581. package/packs/python/skills/python-extract-template/SKILL.md +35 -0
  582. package/packs/react/checks/dialog-needs-role.json +28 -0
  583. package/packs/react/checks/effect-not-for-derived-state.json +24 -0
  584. package/packs/react/checks/icon-button-needs-name.json +24 -0
  585. package/packs/react/checks/label-needs-a-field.json +24 -0
  586. package/packs/react/checks/ui-failed-fetch-says-so.json +23 -0
  587. package/packs/react/checks/ui-ok-branch-has-an-else.json +23 -0
  588. package/packs/react/pack.json +20 -0
  589. package/packs/react/rules/react-accessible-controls.md +20 -0
  590. package/packs/react/rules/react-state-and-effects.md +23 -0
  591. package/packs/reverse-engineering/checks/ear-constant-tagged.json +23 -0
  592. package/packs/reverse-engineering/checks/no-default-on-distrust.json +24 -0
  593. package/packs/reverse-engineering/checks/no-rom-table-literal.json +29 -0
  594. package/packs/reverse-engineering/checks/prose-never-decides.json +22 -0
  595. package/packs/reverse-engineering/hooks/firmware-out-of-git.mjs +49 -0
  596. package/packs/reverse-engineering/pack.json +35 -0
  597. package/packs/reverse-engineering/rules/a-negative-names-what-was-scanned.md +19 -0
  598. package/packs/reverse-engineering/rules/account-every-term.md +20 -0
  599. package/packs/reverse-engineering/rules/addresses-name-their-space.md +21 -0
  600. package/packs/reverse-engineering/rules/every-law-has-a-source.md +18 -0
  601. package/packs/reverse-engineering/rules/findings-are-withdrawn-in-place.md +17 -0
  602. package/packs/reverse-engineering/rules/firmware-stays-out.md +18 -0
  603. package/packs/reverse-engineering/rules/names-before-code.md +19 -0
  604. package/packs/reverse-engineering/rules/reproduction-or-original.md +18 -0
  605. package/packs/reverse-engineering/rules/two-sources-before-naming.md +21 -0
  606. package/packs/reverse-engineering/skills/bank-census/SKILL.md +18 -0
  607. package/packs/reverse-engineering/skills/gather-sources/SKILL.md +21 -0
  608. package/packs/reverse-engineering/skills/menu-map/SKILL.md +28 -0
  609. package/packs/reverse-engineering/skills/names-first/SKILL.md +41 -0
  610. package/packs/reverse-engineering/skills/re-deliverables/SKILL.md +21 -0
  611. package/packs/reverse-engineering/skills/tripwire-the-law/SKILL.md +19 -0
  612. package/packs/reverse-engineering/tools/lib/unwrap.mjs +115 -0
  613. package/packs/reverse-engineering/tools/names-sweep.mjs +264 -0
  614. package/packs/shell/checks/sh-mktemp.json +18 -0
  615. package/packs/shell/checks/sh-no-backticks.json +18 -0
  616. package/packs/shell/checks/sh-no-eval.json +18 -0
  617. package/packs/shell/checks/sh-no-parse-ls.json +18 -0
  618. package/packs/shell/checks/sh-no-pipe-to-shell.json +18 -0
  619. package/packs/shell/checks/sh-no-program-in-heredoc.json +18 -0
  620. package/packs/shell/checks/sh-quote-arguments.json +18 -0
  621. package/packs/shell/checks/sh-rm-guarded.json +18 -0
  622. package/packs/shell/checks/sh-strict-mode.json +20 -0
  623. package/packs/shell/pack.json +28 -0
  624. package/packs/shell/rules/shell-repeats-become-templates.md +23 -0
  625. package/packs/shell/rules/shell-strict-and-quoted.md +27 -0
  626. package/packs/shell/skills/shell-extract-template/SKILL.md +32 -0
  627. package/packs/shell-hooks/checks/gnu-only-in-shell.json +18 -0
  628. package/packs/shell-hooks/checks/hook-command-anchored.json +12 -0
  629. package/packs/shell-hooks/checks/hook-json-by-tool.json +18 -0
  630. package/packs/shell-hooks/checks/no-bash-c-with-variable.json +20 -0
  631. package/packs/shell-hooks/pack.json +36 -0
  632. package/packs/shell-hooks/rules/hooks-portable-anchored-quoted.md +26 -0
  633. package/packs/sound-design/checks/audio-seed-fixed.json +23 -0
  634. package/packs/sound-design/checks/mix-is-a-crossfade.json +30 -0
  635. package/packs/sound-design/checks/no-hash-in-the-signal.json +30 -0
  636. package/packs/sound-design/checks/no-literal-key-anchor.json +30 -0
  637. package/packs/sound-design/checks/test-compares-a-function-with-itself.json +22 -0
  638. package/packs/sound-design/pack.json +22 -0
  639. package/packs/sound-design/rules/algorithms-are-data.md +26 -0
  640. package/packs/sound-design/rules/meter-before-engine.md +27 -0
  641. package/packs/sound-design/rules/neutral-is-exact.md +26 -0
  642. package/packs/sound-design/rules/test-off-the-easy-point.md +28 -0
  643. package/packs/sound-design/rules/unreachable-is-said.md +25 -0
  644. package/packs/sound-design/rules/waveforms-and-octaves.md +24 -0
  645. package/packs/sound-design/skills/choose-observable/SKILL.md +18 -0
  646. package/packs/sound-design/skills/measure-a-law/SKILL.md +18 -0
  647. package/packs/sound-design/skills/measure-reverb/SKILL.md +19 -0
  648. package/packs/sound-design/skills/spread-probe/SKILL.md +18 -0
  649. package/packs/stellix/checks/no-keyboard-focus.json +12 -0
  650. package/packs/stellix/checks/one-seeded-random.json +16 -0
  651. package/packs/stellix/checks/world-never-includes-painter.json +12 -0
  652. package/packs/stellix/checks/world-no-libm.json +15 -0
  653. package/packs/stellix/checks/world-no-unordered.json +10 -0
  654. package/packs/stellix/hooks/no-shipped-images.mjs +88 -0
  655. package/packs/stellix/pack.json +61 -0
  656. package/packs/stellix/rules/stellix-deterministic-world.md +29 -0
  657. package/packs/stellix/rules/stellix-reset-generated.md +24 -0
  658. package/packs/stellix/rules/stellix-world-snapshot.md +27 -0
  659. package/packs/stellix/rules/world-continuous-collision.md +26 -0
  660. package/packs/stellix/rules/world-fp-determinism.md +28 -0
  661. package/packs/stored-text/checks/no-raw-html-from-data.json +31 -0
  662. package/packs/stored-text/checks/stored-text-libs-only-in-renderer.json +31 -0
  663. package/packs/stored-text/checks/stored-text-renderer-complete.json +24 -0
  664. package/packs/stored-text/checks/stored-text-through-renderer.json +25 -0
  665. package/packs/stored-text/pack.json +41 -0
  666. package/packs/stored-text/rules/stored-text-renders-once.md +26 -0
  667. package/packs/stored-text/skills/render-stored-text/SKILL.md +24 -0
  668. package/packs/synth-creator/checks/timing-from-synthcore.json +24 -0
  669. package/packs/synth-creator/checks/ui-drawn-in-code.json +23 -0
  670. package/packs/synth-creator/hooks/build-guard.mjs +232 -0
  671. package/packs/synth-creator/hooks/build-sweep.mjs +166 -0
  672. package/packs/synth-creator/hooks/frozen-files.mjs +63 -0
  673. package/packs/synth-creator/hooks/idle-wake.mjs +90 -0
  674. package/packs/synth-creator/hooks/protect-vendor.mjs +174 -0
  675. package/packs/synth-creator/hooks/spec-lock.mjs +117 -0
  676. package/packs/synth-creator/hooks/stage-guard.mjs +50 -0
  677. package/packs/synth-creator/hooks/time-guard.mjs +292 -0
  678. package/packs/synth-creator/hooks/user-asks.mjs +165 -0
  679. package/packs/synth-creator/pack.json +136 -0
  680. package/packs/synth-creator/rules/copy-trees-read-only.md +25 -0
  681. package/packs/synth-creator/rules/debug-by-measurement.md +20 -0
  682. package/packs/synth-creator/rules/done-means-fresh-evidence.md +18 -0
  683. package/packs/synth-creator/rules/hooks-and-gates.md +21 -0
  684. package/packs/synth-creator/rules/long-work-in-the-background.md +16 -0
  685. package/packs/synth-creator/rules/timing-from-synthcore.md +16 -0
  686. package/packs/synth-creator/skills/build-step/SKILL.md +125 -0
  687. package/packs/synth-creator/skills/build-through-the-queue/SKILL.md +19 -0
  688. package/packs/synth-creator/tools/freeze.mjs +36 -0
  689. package/packs/tui/checks/tui-entry-restores-terminal.json +27 -0
  690. package/packs/tui/checks/tui-gates-on-tty.json +25 -0
  691. package/packs/tui/checks/tui-no-ris-reset.json +22 -0
  692. package/packs/tui/checks/tui-resize-listener-removed.json +26 -0
  693. package/packs/tui/checks/tui-width-is-state.json +33 -0
  694. package/packs/tui/pack.json +44 -0
  695. package/packs/tui/rules/tui-resize-and-screen.md +25 -0
  696. package/packs/tui/skills/build-tui/SKILL.md +21 -0
  697. package/packs/ui-craft/checks/ui-input-needs-autocomplete.json +23 -0
  698. package/packs/ui-craft/checks/ui-intl-for-dates.json +21 -0
  699. package/packs/ui-craft/checks/ui-no-ai-palette.json +22 -0
  700. package/packs/ui-craft/checks/ui-no-animate-layout.json +22 -0
  701. package/packs/ui-craft/checks/ui-no-assistant-palette.json +23 -0
  702. package/packs/ui-craft/checks/ui-no-bounce-easing.json +22 -0
  703. package/packs/ui-craft/checks/ui-no-custom-cursor.json +22 -0
  704. package/packs/ui-craft/checks/ui-no-emoji-as-ui.json +22 -0
  705. package/packs/ui-craft/checks/ui-no-empty-image.json +21 -0
  706. package/packs/ui-craft/checks/ui-no-eyebrow.json +21 -0
  707. package/packs/ui-craft/checks/ui-no-furniture-text.json +22 -0
  708. package/packs/ui-craft/checks/ui-no-gradient-text.json +22 -0
  709. package/packs/ui-craft/checks/ui-no-index-numbering.json +21 -0
  710. package/packs/ui-craft/checks/ui-no-lorem.json +22 -0
  711. package/packs/ui-craft/checks/ui-no-marketing-buzzword.json +22 -0
  712. package/packs/ui-craft/checks/ui-no-paste-block.json +21 -0
  713. package/packs/ui-craft/checks/ui-no-placeholder-names.json +21 -0
  714. package/packs/ui-craft/checks/ui-no-scroll-hijack.json +21 -0
  715. package/packs/ui-craft/checks/ui-no-side-tab.json +21 -0
  716. package/packs/ui-craft/checks/ui-no-stock-labels.json +22 -0
  717. package/packs/ui-craft/checks/ui-no-transition-all.json +22 -0
  718. package/packs/ui-craft/checks/ui-no-uppercase-table-header.json +21 -0
  719. package/packs/ui-craft/checks/ui-no-zebra-rows.json +22 -0
  720. package/packs/ui-craft/checks/ui-no-zoom-lock.json +21 -0
  721. package/packs/ui-craft/pack.json +43 -0
  722. package/packs/ui-craft/rules/apps-are-not-pages.md +26 -0
  723. package/packs/ui-craft/rules/data-tells-the-truth.md +26 -0
  724. package/packs/ui-craft/rules/dates-and-numbers.md +18 -0
  725. package/packs/ui-craft/rules/forms-never-fight.md +22 -0
  726. package/packs/ui-craft/rules/interface-copy.md +26 -0
  727. package/packs/ui-craft/rules/motion-is-rare.md +31 -0
  728. package/packs/ui-craft/rules/no-generated-look.md +37 -0
  729. package/packs/ui-craft/rules/page-holds-its-frame.md +28 -0
  730. package/packs/ui-craft/rules/page-proved-rendered.md +19 -0
  731. package/packs/ui-craft/rules/pictures-do-a-job.md +25 -0
  732. package/packs/ui-craft/rules/pointer-feedback.md +28 -0
  733. package/packs/ui-craft/rules/screen-answers-one-question.md +24 -0
  734. package/packs/ui-craft/rules/survives-real-data.md +23 -0
  735. package/packs/ui-craft/rules/touch-and-small-screens.md +19 -0
  736. package/packs/ui-craft/rules/type-space-colour.md +26 -0
  737. package/packs/ui-craft/rules/url-holds-the-state.md +19 -0
  738. package/packs/ui-craft/skills/app-screen/SKILL.md +33 -0
  739. package/packs/ui-craft/skills/build-from-reference/SKILL.md +28 -0
  740. package/packs/ui-craft/skills/chart-choice/SKILL.md +34 -0
  741. package/packs/ui-craft/skills/hover-state/SKILL.md +28 -0
  742. package/packs/ui-craft/skills/page-critique/SKILL.md +33 -0
  743. package/packs/ui-craft/skills/prove-page/SKILL.md +23 -0
  744. package/packs/ui-craft/skills/redesign-page/SKILL.md +19 -0
  745. package/packs/ui-craft/skills/ui-code-review/SKILL.md +22 -0
  746. package/packs/ui-craft/skills/write-the-page/SKILL.md +21 -0
  747. package/packs/ui-craft/tools/page-measure.mjs +41 -0
  748. package/packs/web/checks/a11y-img-needs-alt.json +26 -0
  749. package/packs/web/checks/a11y-no-bare-outline-none.json +21 -0
  750. package/packs/web/checks/a11y-no-clickable-div.json +26 -0
  751. package/packs/web/checks/a11y-no-positive-tabindex.json +26 -0
  752. package/packs/web/checks/client-no-api-key.json +29 -0
  753. package/packs/web/checks/client-no-browser-global-at-module-scope.json +28 -0
  754. package/packs/web/checks/client-no-server-import.json +31 -0
  755. package/packs/web/checks/client-no-window-location-nav.json +28 -0
  756. package/packs/web/checks/css-no-inline-style.json +30 -0
  757. package/packs/web/checks/ds-pages-compose-primitives.json +28 -0
  758. package/packs/web/checks/key-from-index.json +23 -0
  759. package/packs/web/checks/prodbuild-no-cdn-runtime-deps.json +21 -0
  760. package/packs/web/checks/prodbuild-no-dev-flags.json +21 -0
  761. package/packs/web/checks/prodbuild-no-remote-fonts.json +22 -0
  762. package/packs/web/checks/rcss-button-cursor.json +30 -0
  763. package/packs/web/checks/rcss-no-100vw.json +21 -0
  764. package/packs/web/checks/rcss-no-fixed-wide-width.json +21 -0
  765. package/packs/web/checks/rcss-viewport-meta.json +28 -0
  766. package/packs/web/checks/secret-not-in-web-storage.json +25 -0
  767. package/packs/web/checks/tw-no-raw-hex-in-markup.json +34 -0
  768. package/packs/web/checks/wp-hero-not-lazy.json +27 -0
  769. package/packs/web/checks/wp-img-needs-dimensions.json +26 -0
  770. package/packs/web/pack.json +73 -0
  771. package/packs/web/rules/accessibility.md +26 -0
  772. package/packs/web/rules/client-boundaries.md +23 -0
  773. package/packs/web/rules/production-build.md +22 -0
  774. package/packs/web/rules/secrets-not-in-the-browser.md +18 -0
  775. package/packs/web/rules/styles-live-in-stylesheets.md +23 -0
  776. package/packs/web/rules/tailwind-v4.md +23 -0
  777. package/packs/web/rules/ui-primitives-one-module.md +30 -0
  778. package/packs/web/rules/web-performance.md +21 -0
  779. package/packs/web/skills/design-direction/SKILL.md +30 -0
  780. package/packs/web/skills/design-review/SKILL.md +28 -0
  781. package/packs/web/skills/pick-rendering-mode/SKILL.md +21 -0
  782. package/packs/web/skills/preflight-build/SKILL.md +23 -0
  783. package/packs/web/skills/seo-audit/SKILL.md +22 -0
  784. package/packs/websocket/checks/no-token-in-query.json +26 -0
  785. package/packs/websocket/checks/stale-socket-deletes-new-entry.json +25 -0
  786. package/packs/websocket/checks/ws-identity-from-message.json +26 -0
  787. package/packs/websocket/pack.json +21 -0
  788. package/packs/websocket/rules/identity-comes-from-the-connection.md +24 -0
  789. package/packs/writing/checks/ascii-no-em-dash.json +17 -0
  790. package/packs/writing/checks/no-copula-dodging.json +18 -0
  791. package/packs/writing/checks/no-dramatic-colon.json +18 -0
  792. package/packs/writing/checks/no-not-x-but-y.json +18 -0
  793. package/packs/writing/checks/no-participial-opener.json +18 -0
  794. package/packs/writing/checks/no-pseudo-wisdom.json +18 -0
  795. package/packs/writing/checks/no-slop-words.json +18 -0
  796. package/packs/writing/checks/no-stock-connectors.json +18 -0
  797. package/packs/writing/checks/no-time-or-date.json +27 -0
  798. package/packs/writing/checks/no-trailing-ing.json +18 -0
  799. package/packs/writing/checks/no-vague-attribution.json +18 -0
  800. package/packs/writing/pack.json +43 -0
  801. package/packs/writing/rules/ascii-no-em-dash.md +21 -0
  802. package/packs/writing/rules/cut-the-padding.md +20 -0
  803. package/packs/writing/rules/direct-voice.md +22 -0
  804. package/packs/writing/rules/no-cargo-cult.md +16 -0
  805. package/packs/writing/rules/no-scaffolding.md +19 -0
  806. package/packs/writing/rules/no-stock-language.md +27 -0
  807. package/packs/writing/rules/no-time-or-date.md +18 -0
  808. package/packs/writing/rules/rhythm-like-talk.md +20 -0
  809. package/packs/writing/rules/write-from-your-own-corner.md +20 -0
  810. package/packs/writing/skills/argument-post/SKILL.md +28 -0
  811. package/packs/writing/skills/humanize/SKILL.md +28 -0
  812. package/packs/writing/skills/launch-post/SKILL.md +38 -0
  813. package/packs/writing/skills/pick-subreddit/SKILL.md +69 -0
  814. package/packs/writing/skills/post-voice/SKILL.md +22 -0
  815. package/packs/writing/skills/reddit-post/SKILL.md +63 -0
  816. package/packs/writing/skills/reddit-title/SKILL.md +23 -0
  817. package/packs/writing/skills/reply-moves/SKILL.md +40 -0
  818. package/packs/writing/skills/reply-stance/SKILL.md +23 -0
  819. package/packs/writing/skills/should-i-reply/SKILL.md +21 -0
  820. package/packs/zod/hooks/schemas-only.mjs +53 -0
  821. package/packs/zod/pack.json +44 -0
  822. package/packs/zod/rules/env-shapes-only.md +14 -0
  823. package/packs/zod/rules/zod-4-schemas.md +14 -0
  824. package/profiles/stellix.layout.json +315 -0
  825. package/profiles/sub37.layout.json +247 -0
  826. package/prompts/scan-review.md +40 -0
  827. package/prompts/survey.md +82 -0
@@ -0,0 +1,66 @@
1
+ // shape-symmetry.mjs --selftest: a throwaway project whose design/shape.json declares fake members and swap commands, and the
2
+ // gate run as the generated test runs it. Planted: a member missing from one instance, a swap difference on one pair, a
3
+ // members command that fails, a many concept with no symmetry block, a one concept asked for symmetry. Each must be red;
4
+ // the clean manifest green with every pair printed (6 for N = 4, 3 for N = 3).
5
+ import { spawnSync } from 'node:child_process';
6
+ import { existsSync, readFileSync } from 'node:fs';
7
+ import { join } from 'node:path';
8
+ import { scratchProject, verdicts } from '../hooks/lib/selftest.mjs';
9
+
10
+ const FAKE = `const [what, i, j] = process.argv.slice(2);
11
+ if (what === 'members') {
12
+ if (process.env.PLANT_MEMBERS_FAIL === i) process.exit(3);
13
+ for (const m of ['gain', 'cutoff', 'reverb', 'delay']) if (!(m === 'delay' && process.env.PLANT_MISSING === i)) console.log(m);
14
+ } else if (what === 'swap') process.exit(process.env.PLANT_SWAP === i + ',' + j ? 1 : 0);
15
+ `;
16
+
17
+ export function selftest(tool) {
18
+ const node = JSON.stringify(process.execPath);
19
+ const sym = { members: `${node} fake.mjs members {i}`, swap: `${node} fake.mjs swap {i} {j}` };
20
+ const shape = {
21
+ concepts: {
22
+ slot: { shape: 'many', count: 4, generator: 'slotId(i, field)', owns: ['parameters', 'effects'], symmetry: sym },
23
+ lane: { shape: 'many', count: 3, symmetry: { ...sym, first: 1 } },
24
+ band: { shape: 'many', count: 8 },
25
+ mixer: { shape: 'one', id: 'mixer' },
26
+ },
27
+ };
28
+ const dir = scratchProject({ 'design/shape.json': JSON.stringify(shape), 'fake.mjs': FAKE });
29
+ const run = (concept, env = {}) => {
30
+ const r = spawnSync(process.execPath, [tool, 'run', concept, '--dir', dir], { encoding: 'utf8', env: { ...process.env, ...env } });
31
+ return { code: r.status, out: r.stdout + r.stderr };
32
+ };
33
+ const swaps = (out) => (out.match(/^ {2}swap \d+<->\d+:/gm) ?? []).length;
34
+
35
+ const clean = run('slot');
36
+ const missing = run('slot', { PLANT_MISSING: '2' });
37
+ const swapped = run('slot', { PLANT_SWAP: '1,3' });
38
+ const failing = run('slot', { PLANT_MEMBERS_FAIL: '0' });
39
+ const lane = run('lane');
40
+ const cmake = join(dir, 'out', 'shape_symmetry.cmake');
41
+ const gen = spawnSync(process.execPath, [tool, 'gen', '--cmake', cmake, '--dir', dir], { encoding: 'utf8' });
42
+ const list = spawnSync(process.execPath, [tool, 'gen', '--list', '--dir', dir], { encoding: 'utf8' }).stdout.trim().split('\n');
43
+ const text = existsSync(cmake) ? readFileSync(cmake, 'utf8') : '';
44
+
45
+ if (process.env.SHAPE_SYMMETRY_SELFTEST_VERBOSE) for (const r of [clean, missing, swapped]) console.log(r.out);
46
+ return verdicts('shape-symmetry', [
47
+ ['the clean manifest is green', clean.code, 0],
48
+ ['the clean run prints all 6 pairs for N = 4', swaps(clean.out), 6],
49
+ ['the clean run says 6 pairs checked', /6 pairs checked/.test(clean.out), true],
50
+ ['planted: a member missing from instance 2 is red', missing.code, 1],
51
+ ['planted: the missing member is named, with who has it and who lacks it', /instance 0 has delay that instance 2 lacks/.test(missing.out), true],
52
+ ['planted: a swap difference on pair 1<->3 is red', swapped.code, 1],
53
+ ['planted: the differing pair is named', /swap 1<->3: DIFFERS/.test(swapped.out), true],
54
+ ['planted swap: every pair is still checked (6)', swaps(swapped.out), 6],
55
+ ['planted: a members command that fails is red', failing.code, 1],
56
+ ['N = 3, counted from 1: green with 3 pairs', `${lane.code} ${swaps(lane.out)} ${/swap 1<->2/.test(lane.out)}`, '0 3 true'],
57
+ ['a many concept with no symmetry block is red, and says what to add', `${run('band').code} ${/no symmetry block/.test(run('band').out)}`, '1 true'],
58
+ ['a one concept has no symmetry: red', run('mixer').code, 1],
59
+ ['an unknown concept: red', run('nothing').code, 1],
60
+ ['gen --cmake succeeds', gen.status, 0],
61
+ ['gen --cmake: one add_test per many concept (slot, lane, band)', (text.match(/^add_test\(NAME shape_symmetry\.(slot|lane|band) /gm) ?? []).length, 3],
62
+ ['gen --cmake: no test for a one concept', /shape_symmetry\.mixer/.test(text), false],
63
+ ['gen --cmake: the manifest is a configure dependency', /CMAKE_CONFIGURE_DEPENDS .*design\/shape\.json/.test(text), true],
64
+ ['gen --list: one line per many concept', list.length, 3],
65
+ ]);
66
+ }
@@ -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>