@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.
- package/CHANGELOG.md +754 -0
- package/LICENSE +21 -0
- package/README.md +573 -2
- package/bin/claude-packs.mjs +212 -0
- package/configurations/base/config.json +85 -0
- package/configurations/cpp/config.json +93 -0
- package/configurations/full-stack/config.json +153 -0
- package/configurations/go/config.json +98 -0
- package/configurations/node/config.json +102 -0
- package/configurations/python/config.json +99 -0
- package/configurations/rust/config.json +106 -0
- package/configurations/synth-creator/config.json +148 -0
- package/global/hooks/gnu-shell.mjs +131 -0
- package/global/hooks/lib/shell-writes.mjs +2 -0
- package/global/hooks/shell-traps.mjs +79 -0
- package/global/hooks/version-pin-guard.mjs +280 -0
- package/global/skills/latest-versions/SKILL.md +49 -0
- package/lib/backup.mjs +34 -0
- package/lib/build-queue.mjs +22 -0
- package/lib/claude-md.mjs +60 -0
- package/lib/config-cli.mjs +36 -0
- package/lib/configs.mjs +145 -0
- package/lib/coverage.mjs +94 -0
- package/lib/custom-packs.mjs +93 -0
- package/lib/doctor.mjs +126 -0
- package/lib/fix-plan.mjs +72 -0
- package/lib/found-folders.mjs +25 -0
- package/lib/git-tokens.mjs +64 -0
- package/lib/global.mjs +125 -0
- package/lib/hook-proof.mjs +45 -0
- package/lib/hook-timing.mjs +42 -0
- package/lib/hover-gate.mjs +29 -0
- package/lib/kit-command.mjs +14 -0
- package/lib/kit-lock.mjs +149 -0
- package/lib/layout.mjs +99 -0
- package/lib/logs.mjs +109 -0
- package/lib/manifest.mjs +24 -0
- package/lib/new.mjs +49 -0
- package/lib/once-only-report.mjs +54 -0
- package/lib/pack-manifest.mjs +20 -0
- package/lib/packs.mjs +109 -0
- package/lib/planner.mjs +59 -0
- package/lib/repeats.mjs +65 -0
- package/lib/repo-weight.mjs +28 -0
- package/lib/rule-tests.mjs +42 -0
- package/lib/rules.mjs +40 -0
- package/lib/scan-detect.mjs +130 -0
- package/lib/scan.mjs +171 -0
- package/lib/selftest-cache.mjs +39 -0
- package/lib/settings.mjs +138 -0
- package/lib/shape-cli.mjs +76 -0
- package/lib/shape.mjs +4 -0
- package/lib/suggest.mjs +31 -0
- package/lib/switches.mjs +44 -0
- package/lib/symmetry-doctor.mjs +26 -0
- package/lib/sync.mjs +133 -0
- package/lib/workorder.mjs +26 -0
- package/package.json +34 -4
- package/packs/ai/checks/boundary-computes-its-own-hash.json +30 -0
- package/packs/ai/checks/model-call-needs-boundary.json +29 -0
- package/packs/ai/checks/model-id-from-config.json +28 -0
- package/packs/ai/checks/model-output-validated.json +26 -0
- package/packs/ai/pack.json +38 -0
- package/packs/ai/rules/ai-input-sha-boundary.md +31 -0
- package/packs/ai/rules/llm-pipeline-security.md +26 -0
- package/packs/audio-core/checks/denormals-not-in-prepare.json +12 -0
- package/packs/audio-core/checks/dsp-without-apvts.json +12 -0
- package/packs/audio-core/checks/float-phase-or-rate.json +12 -0
- package/packs/audio-core/checks/juce-snap-to-zero-off.json +12 -0
- package/packs/audio-core/checks/keep-werror.json +12 -0
- package/packs/audio-core/checks/no-fast-math.json +14 -0
- package/packs/audio-core/checks/no-locale-change.json +12 -0
- package/packs/audio-core/checks/no-march-native.json +14 -0
- package/packs/audio-core/clang-tidy +28 -0
- package/packs/audio-core/hooks/lib/realtime-checks.mjs +56 -0
- package/packs/audio-core/hooks/param-id-lock.mjs +172 -0
- package/packs/audio-core/hooks/realtime-guard.mjs +67 -0
- package/packs/audio-core/pack.json +192 -0
- package/packs/audio-core/rules/a-control-is-proved-through-its-input.md +26 -0
- package/packs/audio-core/rules/audio-thread-realtime-safe.md +27 -0
- package/packs/audio-core/rules/audio-ui-thread-handoff.md +21 -0
- package/packs/audio-core/rules/boundary-tests-cross-the-boundary.md +16 -0
- package/packs/audio-core/rules/build-flags-safe.md +20 -0
- package/packs/audio-core/rules/cached-parameter-pointers.md +28 -0
- package/packs/audio-core/rules/clang-tidy-core-guidelines.md +21 -0
- package/packs/audio-core/rules/control-reaches-every-surface.md +23 -0
- package/packs/audio-core/rules/cpu-worst-case-per-block.md +28 -0
- package/packs/audio-core/rules/dc-block-after-asymmetry.md +22 -0
- package/packs/audio-core/rules/discrete-params-snap.md +19 -0
- package/packs/audio-core/rules/double-where-precision-matters.md +20 -0
- package/packs/audio-core/rules/filters-stable-under-modulation.md +29 -0
- package/packs/audio-core/rules/host-parameters-at-scale.md +24 -0
- package/packs/audio-core/rules/house-control-behaviours.md +34 -0
- package/packs/audio-core/rules/math-domain-guards.md +19 -0
- package/packs/audio-core/rules/modulated-delay-interpolation.md +22 -0
- package/packs/audio-core/rules/multiband-phase-coherent.md +22 -0
- package/packs/audio-core/rules/nonlinear-stages-antialiased.md +28 -0
- package/packs/audio-core/rules/note-ledger-and-pedals.md +22 -0
- package/packs/audio-core/rules/one-formula-per-value.md +20 -0
- package/packs/audio-core/rules/optimisations-are-null-tested.md +23 -0
- package/packs/audio-core/rules/oscillators-bandlimited.md +23 -0
- package/packs/audio-core/rules/output-limiter.md +23 -0
- package/packs/audio-core/rules/parameter-ids-never-change.md +20 -0
- package/packs/audio-core/rules/params-and-state-thread-safe.md +19 -0
- package/packs/audio-core/rules/params-snapshot-per-block.md +21 -0
- package/packs/audio-core/rules/patch-excludes-performance-controls.md +18 -0
- package/packs/audio-core/rules/per-sample-code-inlinable.md +22 -0
- package/packs/audio-core/rules/prepare-is-repeatable.md +23 -0
- package/packs/audio-core/rules/recursive-state-nan-guard.md +20 -0
- package/packs/audio-core/rules/reverb-loop-gain-bounded.md +24 -0
- package/packs/audio-core/rules/sample-accurate-midi.md +22 -0
- package/packs/audio-core/rules/sample-rate-and-block-size-from-host.md +23 -0
- package/packs/audio-core/rules/scoped-no-denormals.md +26 -0
- package/packs/audio-core/rules/smooth-continuous-parameters.md +22 -0
- package/packs/audio-core/rules/state-load-versioned-and-safe.md +22 -0
- package/packs/audio-core/rules/straight-on-and-aligned.md +21 -0
- package/packs/audio-core/rules/ui-matches-reference-look.md +23 -0
- package/packs/audio-core/rules/undo-one-gesture-one-step.md +21 -0
- package/packs/audio-core/rules/voice-steal-fades.md +21 -0
- package/packs/audio-core/rules/voice-sum-headroom.md +20 -0
- package/packs/audio-core/skills/analyse-reference-look/SKILL.md +35 -0
- package/packs/audio-core/skills/copy-and-prove/SKILL.md +98 -0
- package/packs/audio-core/skills/juce-realtime-audit/SKILL.md +22 -0
- package/packs/audio-core/skills/measure-tone/SKILL.md +20 -0
- package/packs/audio-core/skills/new-panel-control/SKILL.md +15 -0
- package/packs/audio-core/skills/prove-control/SKILL.md +25 -0
- package/packs/audio-core/skills/trace-parameter/SKILL.md +29 -0
- package/packs/audio-core/tools/lib/spectrum.mjs +112 -0
- package/packs/audio-core/tools/lib/wav.mjs +41 -0
- package/packs/audio-core/tools/tone-report.mjs +47 -0
- package/packs/base/checks/field-map-over-if-runs.json +25 -0
- package/packs/base/checks/lookup-over-if-chains.json +25 -0
- package/packs/base/checks/lookup-over-ternary-chains.json +20 -0
- package/packs/base/checks/no-code-after-midline-comment.json +12 -0
- package/packs/base/checks/one-walk-per-template.json +23 -0
- package/packs/base/checks/stub-reports-success.json +31 -0
- package/packs/base/checks/test-skip-on-failed-setup.json +17 -0
- package/packs/base/hooks/brief-guard.mjs +96 -0
- package/packs/base/hooks/code-shape.mjs +99 -0
- package/packs/base/hooks/dispatch-once.mjs +124 -0
- package/packs/base/hooks/file-size-guard.mjs +61 -0
- package/packs/base/hooks/folder-law.mjs +77 -0
- package/packs/base/hooks/git-guard.mjs +202 -0
- package/packs/base/hooks/lesson-checks.mjs +182 -0
- package/packs/base/hooks/lib/apply-edit.mjs +20 -0
- package/packs/base/hooks/lib/code-shapes.mjs +142 -0
- package/packs/base/hooks/lib/content.mjs +14 -0
- package/packs/base/hooks/lib/cpp-scan.mjs +94 -0
- package/packs/base/hooks/lib/crash-policy.mjs +47 -0
- package/packs/base/hooks/lib/dup-index.mjs +204 -0
- package/packs/base/hooks/lib/dup.mjs +127 -0
- package/packs/base/hooks/lib/elements.mjs +87 -0
- package/packs/base/hooks/lib/event-log.mjs +68 -0
- package/packs/base/hooks/lib/function-shapes.mjs +90 -0
- package/packs/base/hooks/lib/git-adds.mjs +21 -0
- package/packs/base/hooks/lib/git-auth.mjs +44 -0
- package/packs/base/hooks/lib/git-guard-selftest.mjs +192 -0
- package/packs/base/hooks/lib/glob.mjs +33 -0
- package/packs/base/hooks/lib/hook-log.mjs +100 -0
- package/packs/base/hooks/lib/house.py +77 -0
- package/packs/base/hooks/lib/languages.mjs +69 -0
- package/packs/base/hooks/lib/layout.mjs +58 -0
- package/packs/base/hooks/lib/making-check-selftest.mjs +112 -0
- package/packs/base/hooks/lib/near-copies.mjs +76 -0
- package/packs/base/hooks/lib/program-read.mjs +199 -0
- package/packs/base/hooks/lib/program-writes.mjs +177 -0
- package/packs/base/hooks/lib/project.mjs +81 -0
- package/packs/base/hooks/lib/prose.mjs +11 -0
- package/packs/base/hooks/lib/pushed.mjs +201 -0
- package/packs/base/hooks/lib/repo-index.mjs +52 -0
- package/packs/base/hooks/lib/rust-scan.mjs +139 -0
- package/packs/base/hooks/lib/secret-patterns.mjs +18 -0
- package/packs/base/hooks/lib/selftest.mjs +45 -0
- package/packs/base/hooks/lib/shape-code.mjs +126 -0
- package/packs/base/hooks/lib/shape-lists.mjs +31 -0
- package/packs/base/hooks/lib/shape-prose.mjs +78 -0
- package/packs/base/hooks/lib/shape.mjs +273 -0
- package/packs/base/hooks/lib/shell-writes-selftest.mjs +65 -0
- package/packs/base/hooks/lib/shell-writes.mjs +293 -0
- package/packs/base/hooks/lib/turn.mjs +86 -0
- package/packs/base/hooks/lib/unread-writes.mjs +24 -0
- package/packs/base/hooks/lib/writes.mjs +71 -0
- package/packs/base/hooks/making-check.mjs +248 -0
- package/packs/base/hooks/making.mjs +106 -0
- package/packs/base/hooks/once-only.mjs +150 -0
- package/packs/base/hooks/placement-law.mjs +84 -0
- package/packs/base/hooks/repo-litter.mjs +75 -0
- package/packs/base/hooks/reuse-hint.mjs +75 -0
- package/packs/base/hooks/run-hooks.mjs +140 -0
- package/packs/base/hooks/secrets-guard.mjs +99 -0
- package/packs/base/hooks/shape-law.mjs +140 -0
- package/packs/base/hooks/suite-once.mjs +96 -0
- package/packs/base/hooks/template-law.mjs +148 -0
- package/packs/base/hooks/untrusted-boundary.mjs +53 -0
- package/packs/base/pack.json +214 -0
- package/packs/base/rules/a-control-is-seen-to-fire.md +27 -0
- package/packs/base/rules/behaviour-lives-with-its-kind.md +51 -0
- package/packs/base/rules/bug-fix-starts-red.md +25 -0
- package/packs/base/rules/field-map-over-if-runs.md +47 -0
- package/packs/base/rules/finished-work-lands.md +17 -0
- package/packs/base/rules/git-right-first-time.md +19 -0
- package/packs/base/rules/instances-by-index-identities-by-id.md +54 -0
- package/packs/base/rules/lookup-over-if-chains.md +49 -0
- package/packs/base/rules/making-line-first.md +14 -0
- package/packs/base/rules/open-items-tagged.md +17 -0
- package/packs/base/rules/plan-and-logs.md +22 -0
- package/packs/base/rules/references-use-anchors.md +19 -0
- package/packs/base/rules/refusals-are-judged.md +19 -0
- package/packs/base/rules/reuse-before-writing.md +15 -0
- package/packs/base/rules/secrets-never-committed.md +16 -0
- package/packs/base/rules/skill-writing.md +23 -0
- package/packs/base/rules/split-before-the-limit.md +14 -0
- package/packs/base/rules/subagent-dispatch.md +26 -0
- package/packs/base/rules/test-only-what-changed.md +17 -0
- package/packs/base/rules/test-the-template-once.md +23 -0
- package/packs/base/rules/unattended-runs.md +15 -0
- package/packs/base/rules/untrusted-content-boundary.md +15 -0
- package/packs/base/skills/add-lesson-check/SKILL.md +26 -0
- package/packs/base/skills/fix-from-scan/SKILL.md +25 -0
- package/packs/base/skills/land-branch/SKILL.md +24 -0
- package/packs/base/skills/make-it-a-template/SKILL.md +23 -0
- package/packs/base/skills/new-project/SKILL.md +23 -0
- package/packs/base/skills/pdf-to-md/SKILL.md +25 -0
- package/packs/base/skills/pick-tests/SKILL.md +20 -0
- package/packs/base/skills/pressure-test-skill/SKILL.md +23 -0
- package/packs/base/skills/prove-instances-identical/SKILL.md +37 -0
- package/packs/base/skills/write-a-workorder/SKILL.md +41 -0
- package/packs/base/tools/shape-symmetry-selftest.mjs +66 -0
- package/packs/base/tools/shape-symmetry.mjs +178 -0
- package/packs/base/tools/test-verdict.mjs +75 -0
- package/packs/ci/checks/ci-permissions-stated.json +18 -0
- package/packs/ci/checks/ci-tools-pinned.json +14 -0
- package/packs/ci/pack.json +21 -0
- package/packs/ci/rules/ci-covers-what-ships.md +20 -0
- package/packs/ci/rules/generated-files-have-no-diff.md +15 -0
- package/packs/content-site/checks/captcha-is-not-constant.json +27 -0
- package/packs/content-site/checks/img-has-size.json +20 -0
- package/packs/content-site/checks/page-head-complete.json +26 -0
- package/packs/content-site/pack.json +22 -0
- package/packs/content-site/rules/content-has-one-source.md +23 -0
- package/packs/content-site/rules/media-is-sized.md +24 -0
- package/packs/content-site/rules/page-head-is-complete.md +26 -0
- package/packs/content-site/rules/public-forms-are-defended.md +27 -0
- package/packs/content-site/skills/publish-a-page/SKILL.md +21 -0
- package/packs/cpp/checks/cpp-clamp-before-cast.json +16 -0
- package/packs/cpp/checks/cpp-find-with-the-library.json +12 -0
- package/packs/cpp/checks/cpp-hardened-test-build.json +18 -0
- package/packs/cpp/checks/cpp-m-pi-not-standard.json +23 -0
- package/packs/cpp/checks/cpp-no-atoi.json +16 -0
- package/packs/cpp/checks/cpp-no-const-cast.json +16 -0
- package/packs/cpp/checks/cpp-no-float-loop-counter.json +16 -0
- package/packs/cpp/checks/cpp-no-getenv-in-product.json +22 -0
- package/packs/cpp/checks/cpp-no-mutable-global.json +20 -0
- package/packs/cpp/checks/cpp-no-mutable-local-static.json +23 -0
- package/packs/cpp/checks/cpp-no-unchecked-fwrite.json +17 -0
- package/packs/cpp/checks/cpp-no-using-namespace-in-header.json +19 -0
- package/packs/cpp/checks/cpp-no-zero-size-array.json +23 -0
- package/packs/cpp/checks/cpp-numbers-pi.json +16 -0
- package/packs/cpp/pack.json +22 -0
- package/packs/cpp/rules/cpp-absent-and-failed-are-types.md +24 -0
- package/packs/cpp/rules/cpp-builds-everywhere.md +26 -0
- package/packs/cpp/rules/cpp-faults-only-in-the-test-build.md +21 -0
- package/packs/cpp/rules/cpp-find-with-the-library.md +19 -0
- package/packs/cpp/rules/cpp-gates-share-one-reader.md +22 -0
- package/packs/cpp/rules/cpp-headers-declare.md +22 -0
- package/packs/cpp/rules/cpp-numbers-and-casts.md +22 -0
- package/packs/cpp/rules/cpp-repeats-become-templates.md +33 -0
- package/packs/cpp/rules/cpp-static-analysis-runs.md +22 -0
- package/packs/cpp/rules/cpp-thread-contracts-are-code.md +23 -0
- package/packs/cpp/skills/cpp-extract-template/SKILL.md +38 -0
- package/packs/docker/checks/alpine-with-native-build.json +13 -0
- package/packs/docker/checks/compose-db-needs-auth.json +14 -0
- package/packs/docker/checks/compose-image-pinned.json +14 -0
- package/packs/docker/checks/compose-no-hardcoded-ip.json +12 -0
- package/packs/docker/checks/compose-no-host-bind-for-data.json +18 -0
- package/packs/docker/checks/compose-no-plaintext-secret.json +13 -0
- package/packs/docker/checks/compose-no-swarm-ignored-keys.json +13 -0
- package/packs/docker/checks/compose-overlay-not-bridge.json +13 -0
- package/packs/docker/checks/compose-service-needs-healthcheck.json +11 -0
- package/packs/docker/checks/compose-service-needs-init.json +11 -0
- package/packs/docker/checks/copy-needs-chown-with-user.json +17 -0
- package/packs/docker/checks/copy-source-before-deps.json +13 -0
- package/packs/docker/checks/docker-exec-form.json +16 -0
- package/packs/docker/checks/dockerfile-needs-healthcheck.json +17 -0
- package/packs/docker/checks/dockerfile-needs-user.json +21 -0
- package/packs/docker/checks/dockerignore-has-the-basics.json +21 -0
- package/packs/docker/checks/gitattributes-forces-lf.json +17 -0
- package/packs/docker/checks/health-checks-nothing.json +25 -0
- package/packs/docker/checks/no-crlf-in-scripts.json +15 -0
- package/packs/docker/checks/no-latest-base.json +13 -0
- package/packs/docker/checks/no-secret-in-image.json +13 -0
- package/packs/docker/checks/no-sensitive-file-copy.json +13 -0
- package/packs/docker/checks/node-env-before-install.json +13 -0
- package/packs/docker/checks/npm-ci-not-install.json +13 -0
- package/packs/docker/pack.json +46 -0
- package/packs/docker/rules/compose-pinned-and-closed.md +21 -0
- package/packs/docker/rules/compose-swarm-safe.md +26 -0
- package/packs/docker/rules/docker-exec-form.md +19 -0
- package/packs/docker/rules/dockerfile-multistage.md +13 -0
- package/packs/docker/rules/dockerfile-production.md +25 -0
- package/packs/docker/skills/docker-diagnose/SKILL.md +23 -0
- package/packs/dynamic-data/checks/draft-on-the-server.json +27 -0
- package/packs/dynamic-data/checks/guard-does-its-job.json +28 -0
- package/packs/dynamic-data/checks/key-is-not-a-display-name.json +28 -0
- package/packs/dynamic-data/checks/no-code-from-data.json +29 -0
- package/packs/dynamic-data/checks/no-collection-from-request.json +27 -0
- package/packs/dynamic-data/checks/no-pipeline-from-stored-text.json +27 -0
- package/packs/dynamic-data/checks/no-regexp-from-stored-config.json +27 -0
- package/packs/dynamic-data/checks/no-template-from-stored-text.json +27 -0
- package/packs/dynamic-data/checks/save-takes-named-paths.json +27 -0
- package/packs/dynamic-data/pack.json +23 -0
- package/packs/dynamic-data/rules/a-list-is-a-saved-query.md +23 -0
- package/packs/dynamic-data/rules/definitions-are-validated-data.md +24 -0
- package/packs/dynamic-data/rules/every-dynamic-surface-has-a-boundary.md +29 -0
- package/packs/dynamic-data/rules/fields-have-owners.md +22 -0
- package/packs/dynamic-data/rules/imports-drop-nothing.md +26 -0
- package/packs/dynamic-data/rules/one-definition-many-surfaces.md +24 -0
- package/packs/dynamic-data/rules/one-fact-one-place.md +28 -0
- package/packs/dynamic-data/rules/rules-live-in-the-engine.md +29 -0
- package/packs/dynamic-data/rules/saves-are-patches.md +28 -0
- package/packs/dynamic-data/rules/tenant-costs-one-document.md +22 -0
- package/packs/dynamic-data/skills/design-a-definition/SKILL.md +24 -0
- package/packs/fastify/checks/api-routes-versioned.json +28 -0
- package/packs/fastify/checks/cookie-host-prefix.json +24 -0
- package/packs/fastify/checks/hijack-needs-try.json +28 -0
- package/packs/fastify/checks/no-cast-at-route-boundary.json +24 -0
- package/packs/fastify/checks/no-db-in-route-file.json +28 -0
- package/packs/fastify/checks/no-err-message-to-client.json +24 -0
- package/packs/fastify/checks/no-regexp-from-input.json +24 -0
- package/packs/fastify/checks/no-trust-proxy-true.json +25 -0
- package/packs/fastify/checks/one-error-body.json +26 -0
- package/packs/fastify/checks/origin-from-config-not-host.json +31 -0
- package/packs/fastify/checks/password-needs-slow-hash.json +30 -0
- package/packs/fastify/checks/sec-headers-present.json +28 -0
- package/packs/fastify/checks/secrets-compared-constant-time.json +24 -0
- package/packs/fastify/checks/sse-needs-error-listener.json +28 -0
- package/packs/fastify/checks/user-bytes-need-disposition.json +29 -0
- package/packs/fastify/pack.json +41 -0
- package/packs/fastify/rules/credentials-and-input.md +23 -0
- package/packs/fastify/rules/security-one-switch.md +28 -0
- package/packs/fastify/rules/streams-and-hijacks.md +22 -0
- package/packs/fastify/rules/tests-use-inject.md +13 -0
- package/packs/fastify/rules/three-layers.md +20 -0
- package/packs/fastify/rules/trust-config-not-headers.md +24 -0
- package/packs/full-stack/checks/no-express-no-vite.json +23 -0
- package/packs/full-stack/hooks/stack-guard.mjs +90 -0
- package/packs/full-stack/pack.json +76 -0
- package/packs/full-stack/rules/stack-is-fastify-and-nextjs.md +20 -0
- package/packs/go/checks/go-exec-result-ignored.json +15 -0
- package/packs/go/checks/go-unmarshal-error-ignored.json +15 -0
- package/packs/go/pack.json +26 -0
- package/packs/go/rules/go-errors-are-handled.md +22 -0
- package/packs/gpu-painter/checks/dawn-backends-and-validation.json +9 -0
- package/packs/gpu-painter/checks/dawn-no-spontaneous.json +10 -0
- package/packs/gpu-painter/checks/dawn-present-on-render-thread.json +17 -0
- package/packs/gpu-painter/checks/gpu-no-frame-stalls.json +12 -0
- package/packs/gpu-painter/checks/no-opengl-link.json +11 -0
- package/packs/gpu-painter/checks/no-opengl.json +13 -0
- package/packs/gpu-painter/hooks/browser-guard.py +196 -0
- package/packs/gpu-painter/pack.json +91 -0
- package/packs/gpu-painter/rules/dawn-build-and-shaders.md +27 -0
- package/packs/gpu-painter/rules/dawn-device-and-render-thread.md +26 -0
- package/packs/gpu-painter/rules/gpu-antialiasing.md +20 -0
- package/packs/gpu-painter/rules/gpu-blend-order.md +22 -0
- package/packs/gpu-painter/rules/gpu-bloom.md +20 -0
- package/packs/gpu-painter/rules/gpu-frame-budget.md +25 -0
- package/packs/gpu-painter/rules/gpu-frame-pacing-and-power.md +27 -0
- package/packs/gpu-painter/rules/gpu-frame-work.md +30 -0
- package/packs/gpu-painter/rules/gpu-golden-images.md +21 -0
- package/packs/gpu-painter/rules/gpu-hdr-and-tonemap.md +23 -0
- package/packs/gpu-painter/rules/gpu-picking-on-cpu.md +19 -0
- package/packs/gpu-painter/rules/gpu-render-lifecycle.md +25 -0
- package/packs/gpu-painter/rules/gpu-text-atlas.md +24 -0
- package/packs/gpu-painter/rules/gpu-travellers-from-snapshot.md +24 -0
- package/packs/gpu-painter/rules/hover-every-pressable.md +25 -0
- package/packs/gpu-painter/skills/gpu-capture/SKILL.md +15 -0
- package/packs/gpu-painter/skills/gpu-frame-bench/SKILL.md +14 -0
- package/packs/gpu-painter/skills/gpu-golden-check/SKILL.md +13 -0
- package/packs/gpu-painter/skills/gpu-golden-update/SKILL.md +16 -0
- package/packs/gpu-painter/skills/gpu-lifecycle-stress/SKILL.md +15 -0
- package/packs/gpu-painter/skills/hover-state/SKILL.md +33 -0
- package/packs/hook-proof/checks/hook-catch-must-not-allow.json +16 -0
- package/packs/hook-proof/checks/hook-command-no-pipe.json +16 -0
- package/packs/hook-proof/checks/hook-exit-1-does-not-block.json +17 -0
- package/packs/hook-proof/checks/hook-no-or-true.json +18 -0
- package/packs/hook-proof/checks/hook-refusal-on-stderr.json +17 -0
- package/packs/hook-proof/pack.json +38 -0
- package/packs/hook-proof/rules/a-refusal-is-exit-2.md +28 -0
- package/packs/hook-proof/skills/prove-a-hook/SKILL.md +21 -0
- package/packs/host-agent/checks/file-path-from-param.json +27 -0
- package/packs/host-agent/checks/integrity-check-optional.json +27 -0
- package/packs/host-agent/checks/quoted-value-into-config.json +24 -0
- package/packs/host-agent/checks/secret-on-argv.json +28 -0
- package/packs/host-agent/checks/ssh-verifies-host-key.json +27 -0
- package/packs/host-agent/checks/system-file-written-in-place.json +26 -0
- package/packs/host-agent/checks/tmp-path-predictable.json +27 -0
- package/packs/host-agent/pack.json +22 -0
- package/packs/host-agent/rules/root-on-other-machines.md +27 -0
- package/packs/html-ui/checks/email-html-escapes.json +25 -0
- package/packs/html-ui/checks/external-link-rel.json +21 -0
- package/packs/html-ui/checks/no-duplicate-escape.json +26 -0
- package/packs/html-ui/checks/no-inline-client-script.json +21 -0
- package/packs/html-ui/checks/no-inline-style.json +23 -0
- package/packs/html-ui/pack.json +33 -0
- package/packs/html-ui/rules/email-html-escapes.md +19 -0
- package/packs/html-ui/rules/server-html-escapes-everything.md +22 -0
- package/packs/http-api/checks/api-path-versioned.json +31 -0
- package/packs/http-api/checks/authz-from-request-body.json +26 -0
- package/packs/http-api/checks/client-calls-a-version.json +28 -0
- package/packs/http-api/checks/client-ip-not-leftmost-xff.json +28 -0
- package/packs/http-api/checks/cors-needs-origin.json +26 -0
- package/packs/http-api/checks/csp-not-switched-off.json +28 -0
- package/packs/http-api/checks/debug-route-not-shipped.json +26 -0
- package/packs/http-api/checks/encrypted-name-plaintext-value.json +26 -0
- package/packs/http-api/checks/err-text-stays-server-side.json +27 -0
- package/packs/http-api/checks/failure-is-not-empty.json +28 -0
- package/packs/http-api/checks/gate-is-not-a-todo.json +27 -0
- package/packs/http-api/checks/guard-fails-open.json +28 -0
- package/packs/http-api/checks/hmac-over-reserialised-body.json +26 -0
- package/packs/http-api/checks/jwt-verify-pins-algorithm.json +26 -0
- package/packs/http-api/checks/middleware-skips-without-user.json +26 -0
- package/packs/http-api/checks/next-api-route-versioned.json +47 -0
- package/packs/http-api/checks/no-security-off-switch.json +28 -0
- package/packs/http-api/checks/oauth-state-signed.json +26 -0
- package/packs/http-api/checks/one-time-code-compared-raw.json +26 -0
- package/packs/http-api/checks/query-cast-is-not-validation.json +28 -0
- package/packs/http-api/checks/queue-action-from-client.json +26 -0
- package/packs/http-api/checks/rate-limit-one-module.json +28 -0
- package/packs/http-api/checks/role-checked-in-one-guard.json +27 -0
- package/packs/http-api/checks/route-body-needs-schema.json +31 -0
- package/packs/http-api/checks/route-scopes-to-the-caller.json +31 -0
- package/packs/http-api/checks/secret-compared-constant-time-any.json +28 -0
- package/packs/http-api/checks/secret-in-job-record.json +27 -0
- package/packs/http-api/checks/server-fetches-tenant-url.json +30 -0
- package/packs/http-api/checks/short-code-needs-limit.json +26 -0
- package/packs/http-api/checks/user-url-through-safe-fetch.json +28 -0
- package/packs/http-api/checks/webhook-dedupes-event-id.json +30 -0
- package/packs/http-api/pack.json +45 -0
- package/packs/http-api/rules/adapters-one-db-gateway.md +18 -0
- package/packs/http-api/rules/apis-are-versioned.md +27 -0
- package/packs/http-api/rules/credentials-handled-safely.md +22 -0
- package/packs/http-api/rules/handlers-own-the-work.md +17 -0
- package/packs/http-api/rules/health-and-correlation.md +17 -0
- package/packs/http-api/rules/one-error-contract.md +17 -0
- package/packs/http-api/rules/routes-are-thin.md +17 -0
- package/packs/http-api/rules/routes-scope-to-the-caller.md +26 -0
- package/packs/http-api/rules/routes-validate-and-answer.md +25 -0
- package/packs/http-api/skills/change-an-api/SKILL.md +20 -0
- package/packs/http-api/skills/secure-a-route/SKILL.md +21 -0
- package/packs/instrument-shell/checks/no-raw-struct-blob.json +23 -0
- package/packs/instrument-shell/pack.json +22 -0
- package/packs/instrument-shell/rules/fold-keeps-every-route.md +24 -0
- package/packs/instrument-shell/rules/quiet-announces-itself.md +22 -0
- package/packs/instrument-shell/rules/render-the-extremes.md +25 -0
- package/packs/instrument-shell/rules/seams-are-declared.md +27 -0
- package/packs/instrument-shell/rules/session-blob-append-only.md +25 -0
- package/packs/instrument-shell/skills/gates-from-commit-one/SKILL.md +20 -0
- package/packs/instrument-shell/skills/hit-the-painted-control/SKILL.md +18 -0
- package/packs/js-ts/checks/async-callback-unguarded.json +26 -0
- package/packs/js-ts/checks/background-loop-needs-stop.json +28 -0
- package/packs/js-ts/checks/child-process-error-handler.json +28 -0
- package/packs/js-ts/checks/entry-registers-shutdown.json +31 -0
- package/packs/js-ts/checks/fetch-needs-timeout.json +30 -0
- package/packs/js-ts/checks/job-only-in-memory.json +28 -0
- package/packs/js-ts/checks/json-only-through-helper.json +29 -0
- package/packs/js-ts/checks/line-under-200-chars.json +34 -0
- package/packs/js-ts/checks/localhost-default-in-server.json +29 -0
- package/packs/js-ts/checks/no-any.json +27 -0
- package/packs/js-ts/checks/no-cast-escape-hatches.json +24 -0
- package/packs/js-ts/checks/no-console-in-app.json +31 -0
- package/packs/js-ts/checks/no-dynamic-import-node-builtin.json +25 -0
- package/packs/js-ts/checks/no-inline-binary.json +20 -0
- package/packs/js-ts/checks/no-inline-zod-outside-schemas.json +27 -0
- package/packs/js-ts/checks/no-local-sleep.json +25 -0
- package/packs/js-ts/checks/no-nested-ternary.json +20 -0
- package/packs/js-ts/checks/no-secret-in-log.json +24 -0
- package/packs/js-ts/checks/no-shell-string-interpolation.json +24 -0
- package/packs/js-ts/checks/no-swallowed-errors.json +25 -0
- package/packs/js-ts/checks/no-ts-enum.json +20 -0
- package/packs/js-ts/checks/process-env-only-in-config.json +31 -0
- package/packs/js-ts/checks/race-leaves-work-running.json +23 -0
- package/packs/js-ts/checks/reject-as-catch-all-exists.json +24 -0
- package/packs/js-ts/checks/secret-has-no-fallback.json +24 -0
- package/packs/js-ts/checks/secret-needs-crypto-random.json +24 -0
- package/packs/js-ts/checks/server-close-awaited.json +27 -0
- package/packs/js-ts/checks/session-user-typed-once.json +24 -0
- package/packs/js-ts/checks/switch-is-a-table.json +24 -0
- package/packs/js-ts/checks/test-imports-the-source.json +19 -0
- package/packs/js-ts/checks/test-name-says-behaviour.json +16 -0
- package/packs/js-ts/checks/tsconfig-flags.json +21 -0
- package/packs/js-ts/checks/void-needs-catch.json +24 -0
- package/packs/js-ts/checks/zod-string-needs-max.json +25 -0
- package/packs/js-ts/checks/zod-v4-formats.json +23 -0
- package/packs/js-ts/pack.json +84 -0
- package/packs/js-ts/rules/await-handled-at-a-boundary.md +66 -0
- package/packs/js-ts/rules/env-through-config.md +36 -0
- package/packs/js-ts/rules/errors-never-swallowed.md +33 -0
- package/packs/js-ts/rules/files-under-300-lines.md +18 -0
- package/packs/js-ts/rules/guard-clauses-over-nesting.md +34 -0
- package/packs/js-ts/rules/js-repeats-become-templates.md +26 -0
- package/packs/js-ts/rules/json-only-through-one-helper.md +62 -0
- package/packs/js-ts/rules/named-constants-not-magic-numbers.md +34 -0
- package/packs/js-ts/rules/no-any.md +34 -0
- package/packs/js-ts/rules/no-console.md +30 -0
- package/packs/js-ts/rules/no-floating-promises.md +31 -0
- package/packs/js-ts/rules/no-param-mutation.md +28 -0
- package/packs/js-ts/rules/no-unsafe-assertions.md +30 -0
- package/packs/js-ts/rules/one-logger.md +24 -0
- package/packs/js-ts/rules/outbound-calls-have-a-limit.md +20 -0
- package/packs/js-ts/rules/parallel-independent-awaits.md +29 -0
- package/packs/js-ts/rules/process-lifecycle.md +47 -0
- package/packs/js-ts/rules/schema-single-source-of-truth.md +36 -0
- package/packs/js-ts/rules/secrets-stay-secret.md +22 -0
- package/packs/js-ts/rules/small-functions.md +20 -0
- package/packs/js-ts/rules/test-names-describe-behavior.md +28 -0
- package/packs/js-ts/rules/tests-can-fail.md +19 -0
- package/packs/js-ts/rules/tsconfig-strict.md +32 -0
- package/packs/js-ts/rules/typed-exports.md +27 -0
- package/packs/js-ts/rules/types-once-at-the-edge.md +18 -0
- package/packs/js-ts/rules/unions-over-enums.md +29 -0
- package/packs/js-ts/rules/zod-at-route-boundaries.md +40 -0
- package/packs/midi/checks/active-sensing-no-pulse.json +24 -0
- package/packs/midi/checks/clock-not-at-sample-zero.json +23 -0
- package/packs/midi/checks/midi-realtime-first.json +27 -0
- package/packs/midi/checks/no-tempo-writeback.json +23 -0
- package/packs/midi/checks/position-not-integrated.json +29 -0
- package/packs/midi/checks/stub-playhead-advances.json +27 -0
- package/packs/midi/checks/sysex-length-literal.json +23 -0
- package/packs/midi/checks/sysex-not-on-audio.json +24 -0
- package/packs/midi/checks/sysex-survives-realtime.json +27 -0
- package/packs/midi/pack.json +22 -0
- package/packs/midi/rules/clock-is-a-pulse-stream.md +30 -0
- package/packs/midi/rules/imports-count-every-loss.md +25 -0
- package/packs/midi/rules/measure-the-clock-in-audio.md +30 -0
- package/packs/midi/rules/sync-is-a-mode.md +29 -0
- package/packs/midi/rules/sysex-is-a-record.md +29 -0
- package/packs/midi/skills/clock-probe/SKILL.md +23 -0
- package/packs/midi/skills/clock-probe/clock-law.md +417 -0
- package/packs/midi/skills/does-it-sync/SKILL.md +19 -0
- package/packs/mongo/checks/bulk-over-many.json +28 -0
- package/packs/mongo/checks/created-at-immutable.json +25 -0
- package/packs/mongo/checks/driver-outside-gateway.json +24 -0
- package/packs/mongo/checks/key-lookup-is-hashed.json +24 -0
- package/packs/mongo/checks/mongoclient-cached-and-named.json +34 -0
- package/packs/mongo/checks/mongoclient-outside-gateway.json +24 -0
- package/packs/mongo/checks/no-count-plus-one-ids.json +25 -0
- package/packs/mongo/checks/no-db-write-in-loop.json +25 -0
- package/packs/mongo/checks/no-drop-in-code.json +27 -0
- package/packs/mongo/checks/no-empty-deletemany.json +26 -0
- package/packs/mongo/checks/no-find-reads.json +26 -0
- package/packs/mongo/checks/no-input-spread-into-write.json +24 -0
- package/packs/mongo/checks/no-mongoose.json +23 -0
- package/packs/mongo/checks/no-negation-delete.json +26 -0
- package/packs/mongo/checks/no-non-null-after-findone.json +25 -0
- package/packs/mongo/checks/objectid-equals.json +26 -0
- package/packs/mongo/checks/update-then-reread.json +24 -0
- package/packs/mongo/checks/watch-not-poll.json +25 -0
- package/packs/mongo/pack.json +52 -0
- package/packs/mongo/rules/deletes-name-what-dies.md +21 -0
- package/packs/mongo/rules/driver-only-in-gateway.md +26 -0
- package/packs/mongo/rules/keys-hashed-input-picked.md +21 -0
- package/packs/mongo/rules/one-client-one-pool.md +32 -0
- package/packs/mongo/rules/reads-aggregate-writes-bulk.md +25 -0
- package/packs/mongo/rules/writes-are-atomic.md +27 -0
- package/packs/multi-tenant/checks/role-sees-all-tenants.json +26 -0
- package/packs/multi-tenant/checks/tenant-filter-from-url.json +25 -0
- package/packs/multi-tenant/pack.json +22 -0
- package/packs/multi-tenant/rules/no-role-crosses-a-tenant.md +21 -0
- package/packs/multi-tenant/skills/prove-tenant-isolation/SKILL.md +19 -0
- package/packs/nginx/checks/modsec-no-blanket-off.json +16 -0
- package/packs/nginx/checks/nginx-csp-no-unsafe.json +15 -0
- package/packs/nginx/checks/nginx-headers-always.json +15 -0
- package/packs/nginx/checks/nginx-keepalive-http11.json +20 -0
- package/packs/nginx/checks/nginx-logs-to-stdout.json +15 -0
- package/packs/nginx/checks/nginx-no-crlf.json +17 -0
- package/packs/nginx/checks/nginx-resolver-ttl.json +19 -0
- package/packs/nginx/pack.json +43 -0
- package/packs/nginx/rules/modsecurity-tuning.md +22 -0
- package/packs/nginx/rules/nginx-production.md +26 -0
- package/packs/nginx/skills/waf-rollout/SKILL.md +20 -0
- package/packs/postgres/checks/pg-bind-values.json +33 -0
- package/packs/postgres/checks/pg-concurrently-in-txn.json +18 -0
- package/packs/postgres/checks/pg-fk-not-valid.json +18 -0
- package/packs/postgres/checks/pg-index-concurrently.json +18 -0
- package/packs/postgres/checks/pg-no-float-money.json +19 -0
- package/packs/postgres/checks/pg-no-money.json +18 -0
- package/packs/postgres/checks/pg-no-required-column.json +18 -0
- package/packs/postgres/checks/pg-no-volatile-default.json +18 -0
- package/packs/postgres/checks/pg-not-exists.json +18 -0
- package/packs/postgres/checks/pg-timestamptz.json +18 -0
- package/packs/postgres/hooks/db-wipe-guard.mjs +95 -0
- package/packs/postgres/pack.json +48 -0
- package/packs/postgres/rules/postgres-migrations-never-stop-traffic.md +28 -0
- package/packs/postgres/rules/postgres-one-pool-per-process.md +21 -0
- package/packs/postgres/rules/postgres-queries-are-null-safe-and-bounded.md +26 -0
- package/packs/postgres/rules/postgres-types-say-what-they-hold.md +22 -0
- package/packs/postgres/rules/postgres-values-are-bound.md +130 -0
- package/packs/postgres/skills/postgres-safe-migration/SKILL.md +45 -0
- package/packs/python/checks/py-no-bare-except.json +18 -0
- package/packs/python/checks/py-no-eval.json +18 -0
- package/packs/python/checks/py-no-mutable-default.json +18 -0
- package/packs/python/checks/py-no-shell-true.json +18 -0
- package/packs/python/checks/py-no-star-import.json +18 -0
- package/packs/python/checks/py-no-swallowed-exception.json +18 -0
- package/packs/python/checks/py-none-by-is.json +18 -0
- package/packs/python/checks/py-open-with-with.json +18 -0
- package/packs/python/checks/py-requests-timeout.json +18 -0
- package/packs/python/checks/py-subprocess-output-checked.json +18 -0
- package/packs/python/checks/py-yaml-safe-load.json +18 -0
- package/packs/python/pack.json +26 -0
- package/packs/python/rules/python-errors-and-resources.md +26 -0
- package/packs/python/rules/python-repeats-become-templates.md +27 -0
- package/packs/python/skills/python-extract-template/SKILL.md +35 -0
- package/packs/react/checks/dialog-needs-role.json +28 -0
- package/packs/react/checks/effect-not-for-derived-state.json +24 -0
- package/packs/react/checks/icon-button-needs-name.json +24 -0
- package/packs/react/checks/label-needs-a-field.json +24 -0
- package/packs/react/checks/ui-failed-fetch-says-so.json +23 -0
- package/packs/react/checks/ui-ok-branch-has-an-else.json +23 -0
- package/packs/react/pack.json +20 -0
- package/packs/react/rules/react-accessible-controls.md +20 -0
- package/packs/react/rules/react-state-and-effects.md +23 -0
- package/packs/reverse-engineering/checks/ear-constant-tagged.json +23 -0
- package/packs/reverse-engineering/checks/no-default-on-distrust.json +24 -0
- package/packs/reverse-engineering/checks/no-rom-table-literal.json +29 -0
- package/packs/reverse-engineering/checks/prose-never-decides.json +22 -0
- package/packs/reverse-engineering/hooks/firmware-out-of-git.mjs +49 -0
- package/packs/reverse-engineering/pack.json +35 -0
- package/packs/reverse-engineering/rules/a-negative-names-what-was-scanned.md +19 -0
- package/packs/reverse-engineering/rules/account-every-term.md +20 -0
- package/packs/reverse-engineering/rules/addresses-name-their-space.md +22 -0
- package/packs/reverse-engineering/rules/every-law-has-a-source.md +18 -0
- package/packs/reverse-engineering/rules/findings-are-withdrawn-in-place.md +17 -0
- package/packs/reverse-engineering/rules/firmware-stays-out.md +18 -0
- package/packs/reverse-engineering/rules/names-before-code.md +19 -0
- package/packs/reverse-engineering/rules/reproduction-or-original.md +18 -0
- package/packs/reverse-engineering/rules/two-sources-before-naming.md +21 -0
- package/packs/reverse-engineering/skills/bank-census/SKILL.md +18 -0
- package/packs/reverse-engineering/skills/gather-sources/SKILL.md +22 -0
- package/packs/reverse-engineering/skills/menu-map/SKILL.md +28 -0
- package/packs/reverse-engineering/skills/names-first/SKILL.md +41 -0
- package/packs/reverse-engineering/skills/re-deliverables/SKILL.md +21 -0
- package/packs/reverse-engineering/skills/tripwire-the-law/SKILL.md +19 -0
- package/packs/reverse-engineering/tools/lib/unwrap.mjs +115 -0
- package/packs/reverse-engineering/tools/names-sweep.mjs +264 -0
- package/packs/rust/checks/rust-allow-needs-reason.json +16 -0
- package/packs/rust/checks/rust-blocking-in-async.json +32 -0
- package/packs/rust/checks/rust-if-chain-is-a-match.json +32 -0
- package/packs/rust/checks/rust-static-mut.json +32 -0
- package/packs/rust/checks/rust-string-as-error.json +34 -0
- package/packs/rust/checks/rust-stub-left-in.json +32 -0
- package/packs/rust/checks/rust-unsafe-needs-safety.json +31 -0
- package/packs/rust/checks/rust-unwrap-in-library.json +34 -0
- package/packs/rust/checks/rust-wildcard-dependency.json +16 -0
- package/packs/rust/clippy.toml +5 -0
- package/packs/rust/pack.json +27 -0
- package/packs/rust/rules/rust-async-never-blocks.md +20 -0
- package/packs/rust/rules/rust-borrow-before-you-clone.md +19 -0
- package/packs/rust/rules/rust-errors-are-returned.md +22 -0
- package/packs/rust/rules/rust-lints-are-the-gate.md +23 -0
- package/packs/rust/rules/rust-repeats-become-templates.md +28 -0
- package/packs/rust/rules/rust-unsafe-is-proved.md +21 -0
- package/packs/rust/skills/rust-extract-template/SKILL.md +50 -0
- package/packs/rust/skills/rust-port/SKILL.md +22 -0
- package/packs/rust/skills/rust-review/SKILL.md +24 -0
- package/packs/rust/tools/rust-lints.toml +19 -0
- package/packs/shell/checks/sh-mktemp.json +18 -0
- package/packs/shell/checks/sh-no-backticks.json +18 -0
- package/packs/shell/checks/sh-no-eval.json +18 -0
- package/packs/shell/checks/sh-no-parse-ls.json +18 -0
- package/packs/shell/checks/sh-no-pipe-to-shell.json +18 -0
- package/packs/shell/checks/sh-no-program-in-heredoc.json +18 -0
- package/packs/shell/checks/sh-quote-arguments.json +18 -0
- package/packs/shell/checks/sh-rm-guarded.json +18 -0
- package/packs/shell/checks/sh-strict-mode.json +20 -0
- package/packs/shell/pack.json +28 -0
- package/packs/shell/rules/shell-repeats-become-templates.md +23 -0
- package/packs/shell/rules/shell-strict-and-quoted.md +27 -0
- package/packs/shell/skills/shell-extract-template/SKILL.md +32 -0
- package/packs/shell-hooks/checks/gnu-only-in-shell.json +18 -0
- package/packs/shell-hooks/checks/hook-command-anchored.json +12 -0
- package/packs/shell-hooks/checks/hook-json-by-tool.json +18 -0
- package/packs/shell-hooks/checks/no-bash-c-with-variable.json +20 -0
- package/packs/shell-hooks/pack.json +36 -0
- package/packs/shell-hooks/rules/hooks-portable-anchored-quoted.md +26 -0
- package/packs/sound-design/checks/audio-seed-fixed.json +23 -0
- package/packs/sound-design/checks/mix-is-a-crossfade.json +30 -0
- package/packs/sound-design/checks/no-hash-in-the-signal.json +30 -0
- package/packs/sound-design/checks/no-literal-key-anchor.json +30 -0
- package/packs/sound-design/checks/test-compares-a-function-with-itself.json +22 -0
- package/packs/sound-design/pack.json +22 -0
- package/packs/sound-design/rules/algorithms-are-data.md +26 -0
- package/packs/sound-design/rules/meter-before-engine.md +27 -0
- package/packs/sound-design/rules/neutral-is-exact.md +26 -0
- package/packs/sound-design/rules/test-off-the-easy-point.md +28 -0
- package/packs/sound-design/rules/unreachable-is-said.md +25 -0
- package/packs/sound-design/rules/waveforms-and-octaves.md +24 -0
- package/packs/sound-design/skills/bounce-a-plugin/SKILL.md +40 -0
- package/packs/sound-design/skills/choose-observable/SKILL.md +18 -0
- package/packs/sound-design/skills/measure-a-law/SKILL.md +18 -0
- package/packs/sound-design/skills/measure-reverb/SKILL.md +19 -0
- package/packs/sound-design/skills/spread-probe/SKILL.md +18 -0
- package/packs/sound-design/tools/vst3host/build.sh +73 -0
- package/packs/sound-design/tools/vst3host/host_events.h +101 -0
- package/packs/sound-design/tools/vst3host/options.h +172 -0
- package/packs/sound-design/tools/vst3host/render.cpp +245 -0
- package/packs/sound-design/tools/vst3host/session.h +241 -0
- package/packs/stellix/checks/no-keyboard-focus.json +12 -0
- package/packs/stellix/checks/one-seeded-random.json +16 -0
- package/packs/stellix/checks/world-never-includes-painter.json +12 -0
- package/packs/stellix/checks/world-no-libm.json +15 -0
- package/packs/stellix/checks/world-no-unordered.json +10 -0
- package/packs/stellix/hooks/no-shipped-images.mjs +88 -0
- package/packs/stellix/pack.json +61 -0
- package/packs/stellix/rules/stellix-deterministic-world.md +29 -0
- package/packs/stellix/rules/stellix-reset-generated.md +24 -0
- package/packs/stellix/rules/stellix-world-snapshot.md +27 -0
- package/packs/stellix/rules/world-continuous-collision.md +26 -0
- package/packs/stellix/rules/world-fp-determinism.md +28 -0
- package/packs/stored-text/checks/no-raw-html-from-data.json +31 -0
- package/packs/stored-text/checks/stored-text-libs-only-in-renderer.json +31 -0
- package/packs/stored-text/checks/stored-text-renderer-complete.json +24 -0
- package/packs/stored-text/checks/stored-text-through-renderer.json +25 -0
- package/packs/stored-text/pack.json +41 -0
- package/packs/stored-text/rules/stored-text-renders-once.md +26 -0
- package/packs/stored-text/skills/render-stored-text/SKILL.md +24 -0
- package/packs/synth-creator/checks/timing-from-synthcore.json +24 -0
- package/packs/synth-creator/checks/ui-drawn-in-code.json +23 -0
- package/packs/synth-creator/hooks/build-guard.mjs +232 -0
- package/packs/synth-creator/hooks/build-sweep.mjs +166 -0
- package/packs/synth-creator/hooks/frozen-files.mjs +63 -0
- package/packs/synth-creator/hooks/idle-wake.mjs +90 -0
- package/packs/synth-creator/hooks/protect-vendor.mjs +175 -0
- package/packs/synth-creator/hooks/spec-lock.mjs +117 -0
- package/packs/synth-creator/hooks/stage-guard.mjs +50 -0
- package/packs/synth-creator/hooks/time-guard.mjs +292 -0
- package/packs/synth-creator/hooks/user-asks.mjs +165 -0
- package/packs/synth-creator/pack.json +136 -0
- package/packs/synth-creator/rules/copy-trees-read-only.md +25 -0
- package/packs/synth-creator/rules/debug-by-measurement.md +20 -0
- package/packs/synth-creator/rules/done-means-fresh-evidence.md +18 -0
- package/packs/synth-creator/rules/hooks-and-gates.md +21 -0
- package/packs/synth-creator/rules/long-work-in-the-background.md +16 -0
- package/packs/synth-creator/rules/timing-from-synthcore.md +16 -0
- package/packs/synth-creator/skills/build-step/SKILL.md +125 -0
- package/packs/synth-creator/skills/build-through-the-queue/SKILL.md +21 -0
- package/packs/synth-creator/tools/buildq.mjs +74 -0
- package/packs/synth-creator/tools/freeze.mjs +36 -0
- package/packs/tui/checks/tui-entry-restores-terminal.json +27 -0
- package/packs/tui/checks/tui-gates-on-tty.json +25 -0
- package/packs/tui/checks/tui-no-ris-reset.json +22 -0
- package/packs/tui/checks/tui-resize-listener-removed.json +26 -0
- package/packs/tui/checks/tui-width-is-state.json +33 -0
- package/packs/tui/pack.json +44 -0
- package/packs/tui/rules/tui-resize-and-screen.md +25 -0
- package/packs/tui/skills/build-tui/SKILL.md +21 -0
- package/packs/ui-craft/checks/ui-input-needs-autocomplete.json +23 -0
- package/packs/ui-craft/checks/ui-intl-for-dates.json +21 -0
- package/packs/ui-craft/checks/ui-no-ai-palette.json +22 -0
- package/packs/ui-craft/checks/ui-no-animate-layout.json +22 -0
- package/packs/ui-craft/checks/ui-no-assistant-palette.json +23 -0
- package/packs/ui-craft/checks/ui-no-bounce-easing.json +22 -0
- package/packs/ui-craft/checks/ui-no-custom-cursor.json +22 -0
- package/packs/ui-craft/checks/ui-no-emoji-as-ui.json +22 -0
- package/packs/ui-craft/checks/ui-no-empty-image.json +21 -0
- package/packs/ui-craft/checks/ui-no-eyebrow.json +21 -0
- package/packs/ui-craft/checks/ui-no-furniture-text.json +22 -0
- package/packs/ui-craft/checks/ui-no-gradient-text.json +22 -0
- package/packs/ui-craft/checks/ui-no-index-numbering.json +21 -0
- package/packs/ui-craft/checks/ui-no-lorem.json +22 -0
- package/packs/ui-craft/checks/ui-no-marketing-buzzword.json +22 -0
- package/packs/ui-craft/checks/ui-no-paste-block.json +21 -0
- package/packs/ui-craft/checks/ui-no-placeholder-names.json +21 -0
- package/packs/ui-craft/checks/ui-no-scroll-hijack.json +21 -0
- package/packs/ui-craft/checks/ui-no-side-tab.json +21 -0
- package/packs/ui-craft/checks/ui-no-stock-labels.json +22 -0
- package/packs/ui-craft/checks/ui-no-transition-all.json +22 -0
- package/packs/ui-craft/checks/ui-no-uppercase-table-header.json +21 -0
- package/packs/ui-craft/checks/ui-no-zebra-rows.json +22 -0
- package/packs/ui-craft/checks/ui-no-zoom-lock.json +21 -0
- package/packs/ui-craft/pack.json +43 -0
- package/packs/ui-craft/rules/apps-are-not-pages.md +26 -0
- package/packs/ui-craft/rules/data-tells-the-truth.md +26 -0
- package/packs/ui-craft/rules/dates-and-numbers.md +18 -0
- package/packs/ui-craft/rules/forms-never-fight.md +22 -0
- package/packs/ui-craft/rules/interface-copy.md +26 -0
- package/packs/ui-craft/rules/motion-is-rare.md +31 -0
- package/packs/ui-craft/rules/no-generated-look.md +37 -0
- package/packs/ui-craft/rules/page-holds-its-frame.md +28 -0
- package/packs/ui-craft/rules/page-proved-rendered.md +19 -0
- package/packs/ui-craft/rules/pictures-do-a-job.md +25 -0
- package/packs/ui-craft/rules/pointer-feedback.md +28 -0
- package/packs/ui-craft/rules/screen-answers-one-question.md +24 -0
- package/packs/ui-craft/rules/survives-real-data.md +23 -0
- package/packs/ui-craft/rules/touch-and-small-screens.md +19 -0
- package/packs/ui-craft/rules/type-space-colour.md +26 -0
- package/packs/ui-craft/rules/url-holds-the-state.md +19 -0
- package/packs/ui-craft/skills/app-screen/SKILL.md +33 -0
- package/packs/ui-craft/skills/build-from-reference/SKILL.md +28 -0
- package/packs/ui-craft/skills/chart-choice/SKILL.md +34 -0
- package/packs/ui-craft/skills/hover-state/SKILL.md +28 -0
- package/packs/ui-craft/skills/page-critique/SKILL.md +33 -0
- package/packs/ui-craft/skills/prove-page/SKILL.md +23 -0
- package/packs/ui-craft/skills/redesign-page/SKILL.md +19 -0
- package/packs/ui-craft/skills/ui-code-review/SKILL.md +22 -0
- package/packs/ui-craft/skills/write-the-page/SKILL.md +21 -0
- package/packs/ui-craft/tools/page-measure.mjs +41 -0
- package/packs/web/checks/a11y-img-needs-alt.json +26 -0
- package/packs/web/checks/a11y-no-bare-outline-none.json +21 -0
- package/packs/web/checks/a11y-no-clickable-div.json +26 -0
- package/packs/web/checks/a11y-no-positive-tabindex.json +26 -0
- package/packs/web/checks/client-no-api-key.json +29 -0
- package/packs/web/checks/client-no-browser-global-at-module-scope.json +28 -0
- package/packs/web/checks/client-no-server-import.json +31 -0
- package/packs/web/checks/client-no-window-location-nav.json +28 -0
- package/packs/web/checks/css-no-inline-style.json +30 -0
- package/packs/web/checks/ds-pages-compose-primitives.json +28 -0
- package/packs/web/checks/key-from-index.json +23 -0
- package/packs/web/checks/prodbuild-no-cdn-runtime-deps.json +21 -0
- package/packs/web/checks/prodbuild-no-dev-flags.json +21 -0
- package/packs/web/checks/prodbuild-no-remote-fonts.json +22 -0
- package/packs/web/checks/rcss-button-cursor.json +30 -0
- package/packs/web/checks/rcss-no-100vw.json +21 -0
- package/packs/web/checks/rcss-no-fixed-wide-width.json +21 -0
- package/packs/web/checks/rcss-viewport-meta.json +28 -0
- package/packs/web/checks/secret-not-in-web-storage.json +25 -0
- package/packs/web/checks/tw-no-raw-hex-in-markup.json +34 -0
- package/packs/web/checks/wp-hero-not-lazy.json +27 -0
- package/packs/web/checks/wp-img-needs-dimensions.json +26 -0
- package/packs/web/pack.json +73 -0
- package/packs/web/rules/accessibility.md +26 -0
- package/packs/web/rules/client-boundaries.md +23 -0
- package/packs/web/rules/production-build.md +22 -0
- package/packs/web/rules/secrets-not-in-the-browser.md +18 -0
- package/packs/web/rules/styles-live-in-stylesheets.md +23 -0
- package/packs/web/rules/tailwind-v4.md +23 -0
- package/packs/web/rules/ui-primitives-one-module.md +30 -0
- package/packs/web/rules/web-performance.md +21 -0
- package/packs/web/skills/design-direction/SKILL.md +30 -0
- package/packs/web/skills/design-review/SKILL.md +28 -0
- package/packs/web/skills/pick-rendering-mode/SKILL.md +21 -0
- package/packs/web/skills/preflight-build/SKILL.md +23 -0
- package/packs/web/skills/seo-audit/SKILL.md +22 -0
- package/packs/websocket/checks/no-token-in-query.json +26 -0
- package/packs/websocket/checks/stale-socket-deletes-new-entry.json +25 -0
- package/packs/websocket/checks/ws-identity-from-message.json +26 -0
- package/packs/websocket/pack.json +21 -0
- package/packs/websocket/rules/identity-comes-from-the-connection.md +24 -0
- package/packs/writing/checks/ascii-no-em-dash.json +17 -0
- package/packs/writing/checks/no-copula-dodging.json +18 -0
- package/packs/writing/checks/no-dramatic-colon.json +18 -0
- package/packs/writing/checks/no-not-x-but-y.json +18 -0
- package/packs/writing/checks/no-participial-opener.json +18 -0
- package/packs/writing/checks/no-pseudo-wisdom.json +18 -0
- package/packs/writing/checks/no-slop-words.json +18 -0
- package/packs/writing/checks/no-stock-connectors.json +18 -0
- package/packs/writing/checks/no-time-or-date.json +27 -0
- package/packs/writing/checks/no-trailing-ing.json +18 -0
- package/packs/writing/checks/no-vague-attribution.json +18 -0
- package/packs/writing/pack.json +43 -0
- package/packs/writing/rules/ascii-no-em-dash.md +21 -0
- package/packs/writing/rules/cut-the-padding.md +20 -0
- package/packs/writing/rules/direct-voice.md +22 -0
- package/packs/writing/rules/no-cargo-cult.md +16 -0
- package/packs/writing/rules/no-scaffolding.md +19 -0
- package/packs/writing/rules/no-stock-language.md +27 -0
- package/packs/writing/rules/no-time-or-date.md +18 -0
- package/packs/writing/rules/rhythm-like-talk.md +20 -0
- package/packs/writing/rules/write-from-your-own-corner.md +20 -0
- package/packs/writing/skills/argument-post/SKILL.md +28 -0
- package/packs/writing/skills/humanize/SKILL.md +28 -0
- package/packs/writing/skills/launch-post/SKILL.md +38 -0
- package/packs/writing/skills/pick-subreddit/SKILL.md +69 -0
- package/packs/writing/skills/post-voice/SKILL.md +22 -0
- package/packs/writing/skills/reddit-post/SKILL.md +63 -0
- package/packs/writing/skills/reddit-title/SKILL.md +23 -0
- package/packs/writing/skills/reply-moves/SKILL.md +40 -0
- package/packs/writing/skills/reply-stance/SKILL.md +23 -0
- package/packs/writing/skills/should-i-reply/SKILL.md +21 -0
- package/packs/zod/hooks/schemas-only.mjs +53 -0
- package/packs/zod/pack.json +44 -0
- package/packs/zod/rules/env-shapes-only.md +14 -0
- package/packs/zod/rules/zod-4-schemas.md +14 -0
- package/profiles/stellix.layout.json +315 -0
- package/profiles/sub37.layout.json +247 -0
- package/prompts/scan-review.md +40 -0
- package/prompts/survey.md +82 -0
- package/prompts/workorder/PROMPT.md +53 -0
- package/prompts/workorder/run.sh +36 -0
- package/prompts/workorder/workorder.md +59 -0
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "multi-tenant",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "One system, many customers: no role crosses a tenant, every query carries the tenant key, and isolation is proved with a second tenant.",
|
|
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/multi-tenant"
|
|
13
|
+
},
|
|
14
|
+
"keywords": [
|
|
15
|
+
"tenant",
|
|
16
|
+
"saas",
|
|
17
|
+
"security"
|
|
18
|
+
],
|
|
19
|
+
"engines": {
|
|
20
|
+
"claude-packs": ">=0.25.0"
|
|
21
|
+
}
|
|
22
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.ts"
|
|
4
|
+
- "**/*.js"
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# No role inside a tenant ever crosses one, and isolation is proved with a second tenant
|
|
8
|
+
|
|
9
|
+
<constraints>
|
|
10
|
+
Always do:
|
|
11
|
+
- Put the tenant key first in every query, taken from the session, never from the URL.
|
|
12
|
+
- Keep platform administration a separate identity, not the highest tenant role.
|
|
13
|
+
- Prove isolation with the `prove-tenant-isolation` skill.
|
|
14
|
+
|
|
15
|
+
Never do:
|
|
16
|
+
- Give a self-registered account a role that reads other tenants.
|
|
17
|
+
- Update or delete on a slug or an `_id` alone.
|
|
18
|
+
</constraints>
|
|
19
|
+
|
|
20
|
+
## Check
|
|
21
|
+
`tenant-filter-from-url`, `role-sees-all-tenants`.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: prove-tenant-isolation
|
|
3
|
+
description: Use when a route, a query or a role in a multi-tenant system is added or changed, or when asked whether one customer can reach another's data.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Prove tenant isolation (one job: tenant B's id gets nothing from tenant A's session)
|
|
7
|
+
|
|
8
|
+
<constraints>
|
|
9
|
+
Always do:
|
|
10
|
+
1. Make two tenants in the test, against a real data store, each with its own records.
|
|
11
|
+
2. List every route that takes an id, and every message type that names one.
|
|
12
|
+
3. For each, call it as tenant A with tenant B's id, and expect 404 or an empty list, for reads, updates and deletes.
|
|
13
|
+
4. Read tenant B's record afterwards: it must be unchanged.
|
|
14
|
+
5. Do the same with every role a sign-up can reach.
|
|
15
|
+
|
|
16
|
+
Never do:
|
|
17
|
+
- Mock the data layer here: the filter is what is under test.
|
|
18
|
+
- Accept 403 where 404 hides that the record exists.
|
|
19
|
+
</constraints>
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "modsec-no-blanket-off",
|
|
3
|
+
"why": "ctl:ruleEngine=Off or SecRuleEngine Off for a path turns the WAF off exactly where it is needed. Exclude one rule for one URI with ctl:ruleRemoveById.",
|
|
4
|
+
"rule": ".claude/rules/modsecurity-tuning.md",
|
|
5
|
+
"concepts": [
|
|
6
|
+
"modsec"
|
|
7
|
+
],
|
|
8
|
+
"exclude": [
|
|
9
|
+
"**/node_modules/**"
|
|
10
|
+
],
|
|
11
|
+
"code": false,
|
|
12
|
+
"pattern": "ctl:ruleEngine=Off|^\\s*SecRuleEngine\\s+Off\\b",
|
|
13
|
+
"flags": "m",
|
|
14
|
+
"bad": "SecRule REQUEST_URI \"@beginsWith /api\" \"id:1000,phase:1,pass,nolog,ctl:ruleEngine=Off\"",
|
|
15
|
+
"good": "SecRule REQUEST_URI \"@beginsWith /api/orders\" \"id:999100,phase:1,pass,nolog,ctl:ruleRemoveById=942100\""
|
|
16
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "nginx-csp-no-unsafe",
|
|
3
|
+
"why": "'unsafe-inline' / 'unsafe-eval' make the CSP decorative. Use a nonce or a hash for the one inline script that needs it.",
|
|
4
|
+
"rule": ".claude/rules/nginx-production.md",
|
|
5
|
+
"concepts": [
|
|
6
|
+
"nginx-conf"
|
|
7
|
+
],
|
|
8
|
+
"exclude": [
|
|
9
|
+
"**/node_modules/**"
|
|
10
|
+
],
|
|
11
|
+
"code": false,
|
|
12
|
+
"pattern": "'unsafe-(?:inline|eval)'",
|
|
13
|
+
"bad": "add_header Content-Security-Policy \"script-src 'self' 'unsafe-inline'\" always;",
|
|
14
|
+
"good": "add_header Content-Security-Policy \"script-src 'self' 'nonce-$request_id'; object-src 'none'; base-uri 'self'\" always;"
|
|
15
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "nginx-headers-always",
|
|
3
|
+
"why": "add_header without `always` is dropped on 4xx/5xx responses, so error pages ship without nosniff, frame protection or HSTS.",
|
|
4
|
+
"rule": ".claude/rules/nginx-production.md",
|
|
5
|
+
"concepts": [
|
|
6
|
+
"nginx-conf"
|
|
7
|
+
],
|
|
8
|
+
"exclude": [
|
|
9
|
+
"**/node_modules/**"
|
|
10
|
+
],
|
|
11
|
+
"code": false,
|
|
12
|
+
"pattern": "\\badd_header\\s+(?:X-Frame-Options|X-Content-Type-Options|Strict-Transport-Security|Content-Security-Policy(?:-Report-Only)?|Referrer-Policy)\\b(?![^;]*\\balways\\b)",
|
|
13
|
+
"bad": "add_header X-Content-Type-Options nosniff;",
|
|
14
|
+
"good": "add_header X-Content-Type-Options nosniff always;"
|
|
15
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "nginx-keepalive-http11",
|
|
3
|
+
"why": "upstream keepalive only works with HTTP/1.1 and a cleared Connection header; without them every proxied request opens a new connection.",
|
|
4
|
+
"rule": ".claude/rules/nginx-production.md",
|
|
5
|
+
"concepts": [
|
|
6
|
+
"nginx-conf"
|
|
7
|
+
],
|
|
8
|
+
"exclude": [
|
|
9
|
+
"**/node_modules/**"
|
|
10
|
+
],
|
|
11
|
+
"code": false,
|
|
12
|
+
"mode": "needs",
|
|
13
|
+
"pattern": "\\bkeepalive\\s+\\d+\\s*;",
|
|
14
|
+
"needs": [
|
|
15
|
+
"proxy_http_version\\s+1\\.1",
|
|
16
|
+
"proxy_set_header\\s+Connection\\s+\\\"\\\""
|
|
17
|
+
],
|
|
18
|
+
"bad": "upstream api { server api:3000; keepalive 32; }",
|
|
19
|
+
"good": "upstream api { server api:3000; keepalive 32; }\nlocation / { proxy_http_version 1.1; proxy_set_header Connection \"\"; proxy_pass http://api; }"
|
|
20
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "nginx-logs-to-stdout",
|
|
3
|
+
"why": "A log file inside the container is invisible to the Docker log driver and fills the writable layer. /dev/stdout and /dev/stderr.",
|
|
4
|
+
"rule": ".claude/rules/nginx-production.md",
|
|
5
|
+
"concepts": [
|
|
6
|
+
"nginx-conf"
|
|
7
|
+
],
|
|
8
|
+
"exclude": [
|
|
9
|
+
"**/node_modules/**"
|
|
10
|
+
],
|
|
11
|
+
"code": false,
|
|
12
|
+
"pattern": "\\b(?:access|error)_log\\s+/var/log/",
|
|
13
|
+
"bad": "access_log /var/log/nginx/access.log;",
|
|
14
|
+
"good": "access_log /dev/stdout json;\nerror_log /dev/stderr warn;"
|
|
15
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "nginx-no-crlf",
|
|
3
|
+
"why": "A CRLF nginx.conf fails nginx -t inside a Linux container with a nonsensical error. LF only.",
|
|
4
|
+
"rule": ".claude/rules/nginx-production.md",
|
|
5
|
+
"concepts": [
|
|
6
|
+
"nginx-conf",
|
|
7
|
+
"modsec"
|
|
8
|
+
],
|
|
9
|
+
"exclude": [
|
|
10
|
+
"**/node_modules/**"
|
|
11
|
+
],
|
|
12
|
+
"code": false,
|
|
13
|
+
"flags": "m",
|
|
14
|
+
"pattern": "\\r$",
|
|
15
|
+
"bad": "server {\r\n}\r\n",
|
|
16
|
+
"good": "server {\n}\n"
|
|
17
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "nginx-resolver-ttl",
|
|
3
|
+
"why": "Without a resolver with a TTL, NGINX resolves the upstream once at startup and keeps sending traffic to a replaced container's dead IP.",
|
|
4
|
+
"rule": ".claude/rules/nginx-production.md",
|
|
5
|
+
"concepts": [
|
|
6
|
+
"nginx-conf"
|
|
7
|
+
],
|
|
8
|
+
"exclude": [
|
|
9
|
+
"**/node_modules/**"
|
|
10
|
+
],
|
|
11
|
+
"code": false,
|
|
12
|
+
"mode": "needs",
|
|
13
|
+
"pattern": "\\bproxy_pass\\b",
|
|
14
|
+
"needs": [
|
|
15
|
+
"\\bresolver\\s+127\\.0\\.0\\.11\\b"
|
|
16
|
+
],
|
|
17
|
+
"bad": "location / { proxy_pass http://api:3000; }",
|
|
18
|
+
"good": "http { resolver 127.0.0.11 ipv6=off valid=10s; server { location / { set $api http://api:3000; proxy_pass $api; } } }"
|
|
19
|
+
}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "nginx",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "NGINX in front of containers: Docker DNS resolver, keepalive, stdout logs, headers with always, CSP, ModSecurity/CRS tuning.",
|
|
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/nginx"
|
|
13
|
+
},
|
|
14
|
+
"keywords": [
|
|
15
|
+
"nginx",
|
|
16
|
+
"waf"
|
|
17
|
+
],
|
|
18
|
+
"engines": {
|
|
19
|
+
"claude-packs": ">=0.19.0"
|
|
20
|
+
},
|
|
21
|
+
"folders": {},
|
|
22
|
+
"concepts": {
|
|
23
|
+
"nginx-conf": [
|
|
24
|
+
"**/nginx.conf",
|
|
25
|
+
"**/*.nginx.conf",
|
|
26
|
+
"**/nginx/**",
|
|
27
|
+
"**/conf.d/**/*.conf",
|
|
28
|
+
"**/sites-enabled/**"
|
|
29
|
+
],
|
|
30
|
+
"modsec": [
|
|
31
|
+
"**/modsecurity.conf",
|
|
32
|
+
"**/modsecurity.d/**",
|
|
33
|
+
"**/modsec*/**",
|
|
34
|
+
"**/crs-setup.conf",
|
|
35
|
+
"**/*.modsec.conf",
|
|
36
|
+
"**/owasp-crs/**",
|
|
37
|
+
"**/REQUEST-*.conf",
|
|
38
|
+
"**/RESPONSE-*.conf"
|
|
39
|
+
]
|
|
40
|
+
},
|
|
41
|
+
"skillsIn": null,
|
|
42
|
+
"hooks": {}
|
|
43
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
---
|
|
2
|
+
# concepts: modsec
|
|
3
|
+
paths:
|
|
4
|
+
- "placeholder"
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# ModSecurity + CRS: detect first, tune to the stack, exclude narrowly
|
|
8
|
+
|
|
9
|
+
<constraints>
|
|
10
|
+
Always do:
|
|
11
|
+
- `SecRuleEngine DetectionOnly` for the first 2 to 4 weeks; flip to `On` only after the audit log has been tuned. Shipping blocking mode on day one is how a team rips the WAF back out.
|
|
12
|
+
- Start at paranoia level 1; raise only after real exclusion work. Tuning is about the anomaly score, not one rule.
|
|
13
|
+
- Tune to the stack. Node + MongoDB: the real threat is NoSQL injection, which the SQLi rules miss: add rules that block MongoDB operators in parameters and JSON bodies (`$gt`, `$ne`, `$where`, `$regex`), prototype pollution (`__proto__`, `constructor.prototype`) and server-side JS; drop the PHP, Java and IIS rule files; keep SQLi only if SQL exists anywhere in the architecture.
|
|
14
|
+
- Exclusions are targeted: one rule, one URI or parameter, `ctl:ruleRemoveById=…` scoped with `SecRule REQUEST_URI "@beginsWith /api/orders"`. JSON APIs are the usual false-positive source; scope to the API paths.
|
|
15
|
+
- Skip static assets and health endpoints from inspection; cap scanned body sizes; keep response-body inspection on for data-leakage rules; update the CRS regularly; ship the audit log to the SIEM.
|
|
16
|
+
- Test every rule change two ways: known attack payloads must be detected, replayed real traffic must still pass.
|
|
17
|
+
|
|
18
|
+
Never do:
|
|
19
|
+
- `ctl:ruleEngine=Off` for a whole path, or a blanket allowlist (`modsec-no-blanket-off`): it turns the WAF off exactly where it is needed.
|
|
20
|
+
- Paranoia 3 or 4 as a default.
|
|
21
|
+
- Let the WAF stand in for input validation, safe query construction and CSP in the app; it is the layer on top.
|
|
22
|
+
</constraints>
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
---
|
|
2
|
+
# concepts: nginx-conf
|
|
3
|
+
paths:
|
|
4
|
+
- "placeholder"
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# NGINX in front of containers resolves by name with a TTL, logs to stdout, and sends headers always
|
|
8
|
+
|
|
9
|
+
<constraints>
|
|
10
|
+
Always do:
|
|
11
|
+
- `resolver 127.0.0.11 ipv6=off valid=10s;` in `http {}` and upstreams by **service name** in a variable (`set $api http://api:3000; proxy_pass $api;`): NGINX otherwise resolves once at startup and keeps sending traffic to a replaced container's dead IP (`nginx-resolver-ttl`).
|
|
12
|
+
- `keepalive` in the upstream with `proxy_http_version 1.1;` and `proxy_set_header Connection "";` (`nginx-keepalive-http11`).
|
|
13
|
+
- `access_log /dev/stdout json;` and `error_log /dev/stderr;` with a JSON log format; never a file inside the container (`nginx-logs-to-stdout`).
|
|
14
|
+
- `/health` and `stub_status` on an internal-only port with `access_log off` and `allow`/`deny`, never on the public port.
|
|
15
|
+
- A non-HTTP upstream (MongoDB) goes in a top-level `stream {}` block, outside `http {}`.
|
|
16
|
+
- TLS: modern protocols and ciphers, session cache, OCSP stapling, certs from Docker secrets at `/run/secrets/`.
|
|
17
|
+
- Security headers with `always` so error responses carry them too (`nginx-headers-always`): `X-Content-Type-Options nosniff`, `X-Frame-Options DENY` or `frame-ancestors`, HSTS when TLS terminates here.
|
|
18
|
+
- A real `Content-Security-Policy` with explicit directives, `object-src 'none'`, `base-uri 'self'`, `frame-ancestors`; rolled out as `Content-Security-Policy-Report-Only` first, then enforced.
|
|
19
|
+
- LF line endings (`nginx-no-crlf`): a CRLF config fails `nginx -t` with a nonsensical error.
|
|
20
|
+
- A WAF (ModSecurity + OWASP CRS) in front of anything public, DetectionOnly first (`waf-rollout` skill, `modsecurity-tuning` rule).
|
|
21
|
+
|
|
22
|
+
Never do:
|
|
23
|
+
- An IP address as an upstream (`compose-no-hardcoded-ip` applies here too).
|
|
24
|
+
- `'unsafe-inline'` or `'unsafe-eval'` in the CSP (`nginx-csp-no-unsafe`); use a nonce or a hash.
|
|
25
|
+
- Logs to `/var/log/nginx/*.log`.
|
|
26
|
+
</constraints>
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: waf-rollout
|
|
3
|
+
description: Use when a web app or API is about to be deployed or exposed publicly, or when asked whether to put a WAF in front of something. Decides and plans the ModSecurity + OWASP CRS rollout; the config detail is the modsecurity-tuning rule.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# waf-rollout
|
|
7
|
+
|
|
8
|
+
One thing: decide the WAF and plan its rollout, once, when something goes public.
|
|
9
|
+
|
|
10
|
+
<constraints>
|
|
11
|
+
Always do:
|
|
12
|
+
1. Raise it once, with the reason: a public endpoint with no WAF is the common failure, not a misconfiguration. Defense in depth: it sits on top of input validation (`schema-single-source-of-truth`), safe queries (`mongo` pack) and CSP, never instead of them.
|
|
13
|
+
2. Recommend ModSecurity + OWASP CRS at the nginx layer (a managed WAF if there is no proxy).
|
|
14
|
+
3. Plan: DetectionOnly for 2 to 4 weeks → review the audit log → targeted exclusions for false positives → flip to blocking. Tune the rule set to the stack (Node + MongoDB: NoSQL-injection rules in, PHP/Java/IIS files out).
|
|
15
|
+
4. Hand the config work to the `modsecurity-tuning` rule, which loads on the config files themselves.
|
|
16
|
+
|
|
17
|
+
Never do:
|
|
18
|
+
- Ship blocking mode on day one.
|
|
19
|
+
- Present the WAF as the security story.
|
|
20
|
+
</constraints>
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "pg-bind-values",
|
|
3
|
+
"why": "A value in the SQL text is an injection. Bind it as a parameter: $1, %s, or the driver's own tagged form.",
|
|
4
|
+
"rule": ".claude/rules/postgres-values-are-bound.md",
|
|
5
|
+
"globs": [
|
|
6
|
+
"**/*.ts",
|
|
7
|
+
"**/*.tsx",
|
|
8
|
+
"**/*.js",
|
|
9
|
+
"**/*.mjs",
|
|
10
|
+
"**/*.py",
|
|
11
|
+
"**/*.go",
|
|
12
|
+
"**/*.rs"
|
|
13
|
+
],
|
|
14
|
+
"exclude": [
|
|
15
|
+
"**/node_modules/**",
|
|
16
|
+
"**/vendor/**",
|
|
17
|
+
"**/target/**",
|
|
18
|
+
"**/dist/**",
|
|
19
|
+
"**/tests/**",
|
|
20
|
+
"**/test/**",
|
|
21
|
+
"**/__tests__/**",
|
|
22
|
+
"**/migrations/**",
|
|
23
|
+
"**/*.test.*",
|
|
24
|
+
"**/*.spec.*",
|
|
25
|
+
"**/*_test.go",
|
|
26
|
+
"**/*_test.py",
|
|
27
|
+
"**/test_*.py"
|
|
28
|
+
],
|
|
29
|
+
"pattern": "^(?![ \\t]*(?://|#))(?![^\\n]*pg: allow)[^\\n]*?(?:(?<!\\bsql|\\bSQL|\\$queryRaw|\\$executeRaw|\\braw|sql<[^`\\n]{0,60}>)`\\s*(?:SELECT|INSERT\\s+INTO|UPDATE|DELETE\\s+FROM)\\b[^`]*?(?:'%?\\$\\{|(?:=|<|>|LIKE|ILIKE)\\s*\\$\\{|\\bIN\\s*\\(\\s*\\$\\{(?!\\w*(?:placeholder|param)))|\\bf(?:\"\"\"|\\'\\'\\'|\"|\\')\\s*(?:SELECT|INSERT\\s+INTO|UPDATE|DELETE\\s+FROM)\\b[^\\n]*?(?:'%?\\{|(?:=|<|>|LIKE|ILIKE)\\s*\\{|\\bIN\\s*\\(\\s*\\{(?!\\w*(?:placeholder|param)))|Sprintf\\(\\s*[\"`]\\s*(?:SELECT|INSERT\\s+INTO|UPDATE|DELETE\\s+FROM)\\b[^\\n]*?(?:'%?%[sv]|(?:=|<|>|LIKE|ILIKE)\\s*%[sv])|format!\\(\\s*r?#*\"\\s*(?:SELECT|INSERT\\s+INTO|UPDATE|DELETE\\s+FROM)\\b[^\\n]*?(?:'%?\\{|(?:=|<|>|LIKE|ILIKE)\\s*\\{|\\bIN\\s*\\(\\s*\\{(?!\\w*(?:placeholder|param))))",
|
|
30
|
+
"flags": "im",
|
|
31
|
+
"bad": "await db.query(`SELECT * FROM users WHERE email = '${email}'`);",
|
|
32
|
+
"good": "await pool.query(\"SELECT * FROM users WHERE email = $1\", [email]);"
|
|
33
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "pg-concurrently-in-txn",
|
|
3
|
+
"why": "CREATE INDEX CONCURRENTLY cannot run in a transaction: the migration fails when it runs.",
|
|
4
|
+
"rule": ".claude/rules/postgres-migrations-never-stop-traffic.md",
|
|
5
|
+
"globs": [
|
|
6
|
+
"**/*.sql"
|
|
7
|
+
],
|
|
8
|
+
"exclude": [
|
|
9
|
+
"**/node_modules/**",
|
|
10
|
+
"**/vendor/**",
|
|
11
|
+
"**/target/**",
|
|
12
|
+
"**/dist/**"
|
|
13
|
+
],
|
|
14
|
+
"pattern": "^[ \\t]*(?:BEGIN|START\\s+TRANSACTION)\\b[^\\n]*;(?:(?!^[ \\t]*(?:COMMIT|END|ROLLBACK)\\b)[\\s\\S])*?\\bCONCURRENTLY\\b",
|
|
15
|
+
"flags": "im",
|
|
16
|
+
"bad": "BEGIN;\nCREATE INDEX CONCURRENTLY i ON t (a);\nCOMMIT;",
|
|
17
|
+
"good": "CREATE INDEX CONCURRENTLY i ON t (a);"
|
|
18
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "pg-fk-not-valid",
|
|
3
|
+
"why": "A foreign key locks both tables while it scans. Add it NOT VALID, then VALIDATE it in another transaction.",
|
|
4
|
+
"rule": ".claude/rules/postgres-migrations-never-stop-traffic.md",
|
|
5
|
+
"globs": [
|
|
6
|
+
"**/*.sql"
|
|
7
|
+
],
|
|
8
|
+
"exclude": [
|
|
9
|
+
"**/node_modules/**",
|
|
10
|
+
"**/vendor/**",
|
|
11
|
+
"**/target/**",
|
|
12
|
+
"**/dist/**"
|
|
13
|
+
],
|
|
14
|
+
"pattern": "^(?![ \\t]*--)(?![^\\n]*pg: allow)[ \\t]*ALTER\\s+TABLE\\s+(?:IF\\s+EXISTS\\s+)?(?:ONLY\\s+)?(?:\"?\\w+\"?\\.)?\"?(\\w+)\\b\"?(?<!CREATE\\s+(?:UNLOGGED\\s+)?TABLE\\s+(?:IF\\s+NOT\\s+EXISTS\\s+)?(?:\"?\\w+\"?\\.)?\"?\\1\"?[\\s(][\\s\\S]*)\\s+ADD\\s+(?:CONSTRAINT\\s+\\S+\\s+)?FOREIGN\\s+KEY\\b(?![^;]{0,400}\\bNOT\\s+VALID\\b)",
|
|
15
|
+
"flags": "im",
|
|
16
|
+
"bad": "ALTER TABLE t ADD FOREIGN KEY (a) REFERENCES u (id);",
|
|
17
|
+
"good": "ALTER TABLE t ADD FOREIGN KEY (a) REFERENCES u (id) NOT VALID;"
|
|
18
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "pg-index-concurrently",
|
|
3
|
+
"why": "A plain CREATE INDEX blocks every write to a live table until it finishes.",
|
|
4
|
+
"rule": ".claude/rules/postgres-migrations-never-stop-traffic.md",
|
|
5
|
+
"globs": [
|
|
6
|
+
"**/*.sql"
|
|
7
|
+
],
|
|
8
|
+
"exclude": [
|
|
9
|
+
"**/node_modules/**",
|
|
10
|
+
"**/vendor/**",
|
|
11
|
+
"**/target/**",
|
|
12
|
+
"**/dist/**"
|
|
13
|
+
],
|
|
14
|
+
"pattern": "^(?![ \\t]*--)(?![^\\n]*pg: allow)[ \\t]*CREATE\\s+(?:UNIQUE\\s+)?INDEX\\s+(?!CONCURRENTLY\\b)(?:IF\\s+NOT\\s+EXISTS\\s+)?(?:\"?\\w+\"?\\s+)?ON\\s+(?:ONLY\\s+)?(?:\"?\\w+\"?\\.)?\"?(\\w+)\\b\"?(?<!CREATE\\s+(?:UNLOGGED\\s+)?TABLE\\s+(?:IF\\s+NOT\\s+EXISTS\\s+)?(?:\"?\\w+\"?\\.)?\"?\\1\"?[\\s(][\\s\\S]*)",
|
|
15
|
+
"flags": "im",
|
|
16
|
+
"bad": "CREATE INDEX i ON t (a);",
|
|
17
|
+
"good": "CREATE TABLE t (a int);\nCREATE INDEX i ON t (a);"
|
|
18
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "pg-no-float-money",
|
|
3
|
+
"why": "A float cannot hold 0.10 exactly, so amounts drift.",
|
|
4
|
+
"rule": ".claude/rules/postgres-types-say-what-they-hold.md",
|
|
5
|
+
"globs": [
|
|
6
|
+
"**/*.sql",
|
|
7
|
+
"**/*.prisma"
|
|
8
|
+
],
|
|
9
|
+
"exclude": [
|
|
10
|
+
"**/node_modules/**",
|
|
11
|
+
"**/vendor/**",
|
|
12
|
+
"**/target/**",
|
|
13
|
+
"**/dist/**"
|
|
14
|
+
],
|
|
15
|
+
"pattern": "^(?![ \\t]*--)(?![^\\n]*pg: allow)(?:[^\\n]*[(,\\s])?\"?(?:\\w*_)?(?:price|prices|amount|amounts|cost|costs|balance|balances|fee|fees|tax|taxes|total|totals)(?:_\\w*)?\"?\\s+(?:REAL|FLOAT\\d?|DOUBLE\\s+PRECISION|Float)\\b",
|
|
16
|
+
"flags": "im",
|
|
17
|
+
"bad": "unit_price double precision NOT NULL",
|
|
18
|
+
"good": "unit_price numeric(12, 2) NOT NULL"
|
|
19
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "pg-no-money",
|
|
3
|
+
"why": "The money type rounds to one locale's fraction and holds no currency.",
|
|
4
|
+
"rule": ".claude/rules/postgres-types-say-what-they-hold.md",
|
|
5
|
+
"globs": [
|
|
6
|
+
"**/*.sql"
|
|
7
|
+
],
|
|
8
|
+
"exclude": [
|
|
9
|
+
"**/node_modules/**",
|
|
10
|
+
"**/vendor/**",
|
|
11
|
+
"**/target/**",
|
|
12
|
+
"**/dist/**"
|
|
13
|
+
],
|
|
14
|
+
"pattern": "^(?![ \\t]*--)(?![^\\n]*pg: allow)(?:[^\\n]*[(,\\s])?\"?\\w+\"?\\s+MONEY\\b",
|
|
15
|
+
"flags": "im",
|
|
16
|
+
"bad": "price money NOT NULL",
|
|
17
|
+
"good": "price_cents bigint NOT NULL"
|
|
18
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "pg-no-required-column",
|
|
3
|
+
"why": "A NOT NULL column with no default fails on any table that has rows. Add it nullable, backfill, then tighten.",
|
|
4
|
+
"rule": ".claude/rules/postgres-migrations-never-stop-traffic.md",
|
|
5
|
+
"globs": [
|
|
6
|
+
"**/*.sql"
|
|
7
|
+
],
|
|
8
|
+
"exclude": [
|
|
9
|
+
"**/node_modules/**",
|
|
10
|
+
"**/vendor/**",
|
|
11
|
+
"**/target/**",
|
|
12
|
+
"**/dist/**"
|
|
13
|
+
],
|
|
14
|
+
"pattern": "^(?![ \\t]*--)(?![^\\n]*pg: allow)[ \\t]*(?:ALTER\\s+TABLE\\s+(?:IF\\s+EXISTS\\s+)?(?:ONLY\\s+)?(?:\"?\\w+\"?\\.)?\"?(\\w+)\\b\"?(?<!CREATE\\s+(?:UNLOGGED\\s+)?TABLE\\s+(?:IF\\s+NOT\\s+EXISTS\\s+)?(?:\"?\\w+\"?\\.)?\"?\\1\"?[\\s(][\\s\\S]*)\\s+)ADD\\s+(?:COLUMN\\s+)?(?:IF\\s+NOT\\s+EXISTS\\s+)?(?!CONSTRAINT\\b|PRIMARY\\b|UNIQUE\\b|FOREIGN\\b|CHECK\\b|EXCLUDE\\b)\"?\\w+\"?\\s+(?![^,;]*\\b(?:DEFAULT|GENERATED)\\b)[^,;]*\\bNOT\\s+NULL\\b",
|
|
15
|
+
"flags": "im",
|
|
16
|
+
"bad": "ALTER TABLE t ADD COLUMN owner_id bigint NOT NULL;",
|
|
17
|
+
"good": "ALTER TABLE t ADD COLUMN owner_id bigint NOT NULL DEFAULT 0;"
|
|
18
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "pg-no-volatile-default",
|
|
3
|
+
"why": "A volatile default rewrites the whole table under an exclusive lock. `now()` is not volatile, and stays allowed.",
|
|
4
|
+
"rule": ".claude/rules/postgres-migrations-never-stop-traffic.md",
|
|
5
|
+
"globs": [
|
|
6
|
+
"**/*.sql"
|
|
7
|
+
],
|
|
8
|
+
"exclude": [
|
|
9
|
+
"**/node_modules/**",
|
|
10
|
+
"**/vendor/**",
|
|
11
|
+
"**/target/**",
|
|
12
|
+
"**/dist/**"
|
|
13
|
+
],
|
|
14
|
+
"pattern": "^(?![ \\t]*--)(?![^\\n]*pg: allow)[ \\t]*(?:ALTER\\s+TABLE\\s+\\S+\\s+)?ADD\\s+(?:COLUMN\\s+)?(?:IF\\s+NOT\\s+EXISTS\\s+)?\"?\\w+\"?\\s+[^,;]*?\\bDEFAULT\\b[^,;]*?\\b(?:gen_random_uuid|uuid_generate_v\\d\\w*|uuidv[47]|clock_timestamp|random|nextval|timeofday)\\s*\\(",
|
|
15
|
+
"flags": "im",
|
|
16
|
+
"bad": "ALTER TABLE t ADD COLUMN token uuid DEFAULT gen_random_uuid();",
|
|
17
|
+
"good": "ALTER TABLE t ADD COLUMN created_at timestamptz DEFAULT now();"
|
|
18
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "pg-not-exists",
|
|
3
|
+
"why": "NOT IN with a subquery returns no rows at all when the subquery holds one NULL, and plans badly.",
|
|
4
|
+
"rule": ".claude/rules/postgres-queries-are-null-safe-and-bounded.md",
|
|
5
|
+
"globs": [
|
|
6
|
+
"**/*.sql"
|
|
7
|
+
],
|
|
8
|
+
"exclude": [
|
|
9
|
+
"**/node_modules/**",
|
|
10
|
+
"**/vendor/**",
|
|
11
|
+
"**/target/**",
|
|
12
|
+
"**/dist/**"
|
|
13
|
+
],
|
|
14
|
+
"pattern": "^(?![ \\t]*--)(?![^\\n]*pg: allow)[^\\n]*\\bNOT\\s+IN\\s*\\(\\s*SELECT\\b",
|
|
15
|
+
"flags": "im",
|
|
16
|
+
"bad": "DELETE FROM a WHERE id NOT IN (SELECT a_id FROM b);",
|
|
17
|
+
"good": "DELETE FROM a WHERE NOT EXISTS (SELECT 1 FROM b WHERE b.a_id = a.id);"
|
|
18
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "pg-timestamptz",
|
|
3
|
+
"why": "timestamp keeps no time zone, so the same value means different moments on different servers.",
|
|
4
|
+
"rule": ".claude/rules/postgres-types-say-what-they-hold.md",
|
|
5
|
+
"globs": [
|
|
6
|
+
"**/*.sql"
|
|
7
|
+
],
|
|
8
|
+
"exclude": [
|
|
9
|
+
"**/node_modules/**",
|
|
10
|
+
"**/vendor/**",
|
|
11
|
+
"**/target/**",
|
|
12
|
+
"**/dist/**"
|
|
13
|
+
],
|
|
14
|
+
"pattern": "^(?![ \\t]*--)(?![^\\n]*pg: allow)(?:[^\\n]*[(,\\s])?\"?\\w+\"?\\s+TIMESTAMP\\b(?:\\s*\\(\\d\\))?(?!\\s+WITH\\s+TIME\\s+ZONE)",
|
|
15
|
+
"flags": "im",
|
|
16
|
+
"bad": "created_at timestamp NOT NULL",
|
|
17
|
+
"good": "created_at timestamptz NOT NULL"
|
|
18
|
+
}
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// db-wipe-guard (PreToolUse, Bash): a command that wipes a database runs only against a database this machine holds. Two public reports of an agent
|
|
3
|
+
// running a forced reset against a live database lost 60 and 87 tables; in the second, .env pointed at production. A reset is ordinary work on a local
|
|
4
|
+
// database, so the guard judges the target, in this order: the host named in the command, then DATABASE_URL or POSTGRES_URL in the checkout's .env
|
|
5
|
+
// files. A target it cannot find is refused, because a guard that cannot judge must not pass a wipe: name a local host in the command and it can.
|
|
6
|
+
// Only the host is read and shown, never a password. `--selftest` proves it.
|
|
7
|
+
import { existsSync, readFileSync } from 'node:fs';
|
|
8
|
+
import { join, resolve } from 'node:path';
|
|
9
|
+
import { fileURLToPath } from 'node:url';
|
|
10
|
+
import { checkoutRoot } from './lib/project.mjs';
|
|
11
|
+
import { bashOf, runHook, scratchProject, verdicts } from './lib/selftest.mjs';
|
|
12
|
+
import { judgeEvent } from './lib/writes.mjs';
|
|
13
|
+
import { asHook, isMain } from './lib/hook-log.mjs';
|
|
14
|
+
|
|
15
|
+
const WIPES = [
|
|
16
|
+
[/\bprisma\s+migrate\s+reset\b/, 'prisma migrate reset'],
|
|
17
|
+
[/\bprisma\s+db\s+push\b[^\n;&|]*--(?:force-reset|accept-data-loss)\b/, 'prisma db push with a forced reset'],
|
|
18
|
+
[/\bdrizzle-kit\s+push\b[^\n;&|]*--force\b/, 'drizzle-kit push --force'],
|
|
19
|
+
[/\b(?:rails|rake)\s+db:(?:drop|reset)\b/, 'db:drop or db:reset'],
|
|
20
|
+
[/\bmanage\.py\s+flush\b/, 'manage.py flush'],
|
|
21
|
+
[/(?:^|[\s;&|])dropdb\s/, 'dropdb'],
|
|
22
|
+
[/\bsqlx\s+database\s+(?:drop|reset)\b/, 'sqlx database drop or reset'],
|
|
23
|
+
[/\bdiesel\s+database\s+reset\b/, 'diesel database reset'],
|
|
24
|
+
];
|
|
25
|
+
const RAW_WIPE = /\bpsql\b[^\n|]*\bDROP\s+(?:DATABASE|SCHEMA)\b/i;
|
|
26
|
+
const LOCAL = new Set(['localhost', '127.0.0.1', '::1', '[::1]', 'host.docker.internal', 'db', 'postgres', 'database']);
|
|
27
|
+
const URL_HOST = /\b(?:postgres(?:ql)?|mysql|mariadb):\/\/(?:[^@\s/'"]*@)?(\[[^\]]+\]|[^:/?\s'"]+)/i;
|
|
28
|
+
const ENV_URL = /^\s*(?:export\s+)?(?:DATABASE_URL|POSTGRES_URL|POSTGRESQL_URL|DB_URL)\s*=\s*['"]?([^\s'"]+)/m;
|
|
29
|
+
const HOST_FLAG = /(?:\s-h\s*|\s--host[=\s])(\S+)/;
|
|
30
|
+
const ENV_FILES = ['.env.local', '.env.development', '.env'];
|
|
31
|
+
|
|
32
|
+
const hostIn = (text) => text.match(URL_HOST)?.[1] ?? null;
|
|
33
|
+
|
|
34
|
+
function hostOfEnv(root) {
|
|
35
|
+
for (const f of ENV_FILES) {
|
|
36
|
+
const file = join(root, f);
|
|
37
|
+
if (!existsSync(file)) continue;
|
|
38
|
+
const url = readFileSync(file, 'utf8').match(ENV_URL)?.[1];
|
|
39
|
+
if (url) return { host: hostIn(url), from: f };
|
|
40
|
+
}
|
|
41
|
+
return null;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
// The host a command names, then the host its checkout's .env names.
|
|
45
|
+
function targetOf(command, cwd) {
|
|
46
|
+
const named = hostIn(command) ?? command.match(HOST_FLAG)?.[1];
|
|
47
|
+
if (named) return { host: named, from: 'the command' };
|
|
48
|
+
return hostOfEnv(checkoutRoot(resolve(cwd, 'x'))) ?? { host: null, from: null };
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
export function refusal(command, cwd) {
|
|
52
|
+
const body = command.replace(/<<-?\s*['"]?(\w+)['"]?[\s\S]*?\n\1\b/g, '').replace(/'[^']*'|"(?:\\.|[^"\\])*"/g, "''");
|
|
53
|
+
const wipe = WIPES.find(([re]) => re.test(body))?.[1] ?? (RAW_WIPE.test(command) ? 'psql with DROP' : null);
|
|
54
|
+
if (!wipe) return null;
|
|
55
|
+
const { host, from } = targetOf(command, cwd);
|
|
56
|
+
if (host && LOCAL.has(host.toLowerCase())) return null;
|
|
57
|
+
const where = host ? `its target is ${host} (from ${from}), which is not this machine` : 'nothing says which database it would hit';
|
|
58
|
+
return `\`${wipe}\` wipes a database, and ${where}.\n` +
|
|
59
|
+
'A wipe runs only against a local database. If this one is local, name it in the command: `DATABASE_URL=postgres://localhost/<db> <command>`, or `-h localhost`.\n' +
|
|
60
|
+
'If it is not, this is the user\'s to run, not Claude\'s: stop and ask.\n';
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
const main = (text) => judgeEvent(text, { name: 'db-wipe-guard', command: refusal });
|
|
64
|
+
|
|
65
|
+
function selftest() {
|
|
66
|
+
const hook = fileURLToPath(import.meta.url);
|
|
67
|
+
const live = scratchProject({ '.env': 'DATABASE_URL=postgres://app@db.prod.example.com:5432/app\n' });
|
|
68
|
+
const local = scratchProject({ '.env': 'DATABASE_URL="postgresql://app@localhost:5432/app"\n' });
|
|
69
|
+
const compose = scratchProject({ '.env.local': 'export POSTGRES_URL=postgres://app@db/app\n' });
|
|
70
|
+
const unknown = scratchProject({});
|
|
71
|
+
const sh = (dir, cmd) => runHook(hook, dir, bashOf(cmd, dir));
|
|
72
|
+
return verdicts('db-wipe-guard', [
|
|
73
|
+
['a reset, with .env on a live host', sh(live, 'npx prisma migrate reset --force'), 2],
|
|
74
|
+
['a forced push there', sh(live, 'npx prisma db push --force-reset'), 2],
|
|
75
|
+
['data loss accepted there', sh(live, 'prisma db push --accept-data-loss'), 2],
|
|
76
|
+
['drizzle there', sh(live, 'npx drizzle-kit push --force'), 2],
|
|
77
|
+
['rails there', sh(live, 'bin/rails db:drop'), 2],
|
|
78
|
+
['django there', sh(live, 'python manage.py flush --no-input'), 2],
|
|
79
|
+
['psql dropping a database', sh(live, 'psql "$URL" -c "DROP DATABASE app"'), 2],
|
|
80
|
+
['after other steps', sh(live, 'git status && dropdb app'), 2],
|
|
81
|
+
['a live host named in the command beats a local .env', sh(local, 'DATABASE_URL=postgres://u@db.prod.example.com/app npx prisma migrate reset'), 2],
|
|
82
|
+
['a reset with .env on localhost', sh(local, 'npx prisma migrate reset --force'), 0],
|
|
83
|
+
['a compose service in .env.local', sh(compose, 'npx prisma migrate reset --force'), 0],
|
|
84
|
+
['no target anywhere', sh(unknown, 'dropdb app'), 2],
|
|
85
|
+
['a local host named in the command', sh(unknown, 'dropdb -h localhost app'), 0],
|
|
86
|
+
['a local url named in the command', sh(live, 'DATABASE_URL=postgres://localhost/app npx prisma migrate reset'), 0],
|
|
87
|
+
['a safe migrate', sh(live, 'npx prisma migrate deploy'), 0],
|
|
88
|
+
['a push with no force', sh(live, 'npx drizzle-kit push'), 0],
|
|
89
|
+
['words about a wipe', sh(live, "echo 'npx prisma migrate reset'"), 0],
|
|
90
|
+
['a heredoc body', sh(live, "cat <<'EOF'\nprisma migrate reset\nEOF"), 0],
|
|
91
|
+
]);
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
export const hook = main; // run-hooks.mjs calls it with the event's text (KWB-24)
|
|
95
|
+
if (isMain(import.meta.url)) process.exit(process.argv.includes('--selftest') ? selftest() : await asHook('db-wipe-guard', main));
|