@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,178 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// The generated gate shape_symmetry (the shape law, 0.9.0). For every MANY concept in design/shape.json:
|
|
3
|
+
// members: every instance has the same set of members (the concept's `symmetry.members` command, run once per instance,
|
|
4
|
+
// prints that instance's members one per line; {i} is replaced by the instance);
|
|
5
|
+
// swap: every unordered pair, all N·(N-1)/2 of them, swaps the same (`symmetry.swap`, {i} and {j} replaced, exit 0).
|
|
6
|
+
// The project only declares the commands in shape.json; this file never holds a project's test. It was the instances-by-index
|
|
7
|
+
// swap check, which a folder list scoped to the engine and which let a world-side difference through.
|
|
8
|
+
//
|
|
9
|
+
// node .claude/tools/shape-symmetry.mjs run <concept> [--dir <root>] the gate for one concept (what the generated test calls)
|
|
10
|
+
// node .claude/tools/shape-symmetry.mjs gen --cmake <out.cmake> [--dir <root>] add_test lines, one per many concept
|
|
11
|
+
// node .claude/tools/shape-symmetry.mjs gen --list [--dir <root>] "<name>\t<command>" lines, for any other build system
|
|
12
|
+
// node .claude/tools/shape-symmetry.mjs --selftest
|
|
13
|
+
// The kit's CLI runs the same: `npx --no-install @thedecipherist/claude-packs symmetry run|gen ...`.
|
|
14
|
+
import { spawnSync } from 'node:child_process';
|
|
15
|
+
import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from 'node:fs';
|
|
16
|
+
import { dirname, join, resolve } from 'node:path';
|
|
17
|
+
import { fileURLToPath } from 'node:url';
|
|
18
|
+
|
|
19
|
+
const SELF = fileURLToPath(import.meta.url);
|
|
20
|
+
const TIMEOUT_S = 600;
|
|
21
|
+
|
|
22
|
+
export function readManifest(root) {
|
|
23
|
+
const file = join(root, 'design', 'shape.json');
|
|
24
|
+
if (!existsSync(file)) throw new Error(`no design/shape.json in ${root} (every project declares its concepts there: one or many)`);
|
|
25
|
+
return JSON.parse(readFileSync(file, 'utf8'));
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
export const manyConcepts = (shape) => Object.entries(shape.concepts ?? {}).filter(([, c]) => c.shape === 'many').map(([name]) => name);
|
|
29
|
+
export const testName = (concept) => `shape_symmetry.${concept}`;
|
|
30
|
+
|
|
31
|
+
const sh = (cmd, root, vars) => {
|
|
32
|
+
const line = cmd.replace(/\{([ij])\}/g, (_, k) => String(vars[k]));
|
|
33
|
+
const r = spawnSync(line, { shell: true, cwd: root, encoding: 'utf8', timeout: TIMEOUT_S * 1000, maxBuffer: 64 << 20 });
|
|
34
|
+
return { line, code: r.status ?? (r.error ? 127 : 1), out: r.stdout ?? '', err: `${r.stderr ?? ''}${r.error ? r.error.message : ''}` };
|
|
35
|
+
};
|
|
36
|
+
const tail = (text, n = 4) => text.trim().split('\n').filter(Boolean).slice(-n).map((l) => `\n ${l}`).join('');
|
|
37
|
+
|
|
38
|
+
// The instances, in order: count from the concept (many(N)), or the symmetry block's `instances` command (many, no fixed N).
|
|
39
|
+
function instancesOf(name, concept, root) {
|
|
40
|
+
const sym = concept.symmetry;
|
|
41
|
+
let n = concept.count;
|
|
42
|
+
if (n === undefined && sym.instances) {
|
|
43
|
+
const r = sh(sym.instances, root, {});
|
|
44
|
+
n = r.code === 0 ? Number(r.out.trim()) : NaN;
|
|
45
|
+
if (!Number.isInteger(n)) throw new Error(`${name}: the instances command "${sym.instances}" printed no count (exit ${r.code})`);
|
|
46
|
+
}
|
|
47
|
+
if (!Number.isInteger(n) || n < 1) throw new Error(`${name} is many with no count: give it "count": N, or "symmetry": { "instances": "<command printing N>" }`);
|
|
48
|
+
const first = sym.first ?? 0;
|
|
49
|
+
return Array.from({ length: n }, (_, k) => first + k);
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
// Runs the gate for one concept; prints every reading; returns 0 (same) or 1 (red).
|
|
53
|
+
export function runConcept(root, name, log = console.log) {
|
|
54
|
+
const shape = readManifest(root);
|
|
55
|
+
const concept = shape.concepts?.[name];
|
|
56
|
+
const head = `shape_symmetry ${name}`;
|
|
57
|
+
if (!concept) { log(`${head}: RED: no concept "${name}" in design/shape.json`); return 1; }
|
|
58
|
+
if (concept.shape !== 'many') { log(`${head}: RED: "${name}" is ${concept.shape}, not many; only a many concept has symmetry`); return 1; }
|
|
59
|
+
const sym = concept.symmetry;
|
|
60
|
+
if (!sym?.members || !sym?.swap) {
|
|
61
|
+
log(`${head}: RED: "${name}" is many but design/shape.json gives it no symmetry block. Add "symmetry": { "members": "<command printing instance {i}'s members, one per line>", "swap": "<command: exit 0 when instances {i} and {j} swap the same>" }`);
|
|
62
|
+
return 1;
|
|
63
|
+
}
|
|
64
|
+
let ids;
|
|
65
|
+
try { ids = instancesOf(name, concept, root); } catch (e) { log(`${head}: RED: ${e.message}`); return 1; }
|
|
66
|
+
log(`${head}: ${ids.length} instances (${ids.join(', ')}); owns: ${(concept.owns ?? []).join(', ') || '(not listed)'}`);
|
|
67
|
+
let red = 0;
|
|
68
|
+
|
|
69
|
+
// (a) members
|
|
70
|
+
const sets = new Map();
|
|
71
|
+
for (const i of ids) {
|
|
72
|
+
const r = sh(sym.members, root, { i });
|
|
73
|
+
const members = new Set(r.out.split('\n').map((l) => l.trim()).filter(Boolean));
|
|
74
|
+
if (r.code !== 0) { red += 1; log(` members ${i}: RED: "${r.line}" exited ${r.code}${tail(r.err || r.out)}`); continue; }
|
|
75
|
+
if (members.size === 0) { red += 1; log(` members ${i}: RED: "${r.line}" printed no members`); continue; }
|
|
76
|
+
sets.set(i, members);
|
|
77
|
+
log(` members ${i}: ${members.size}`);
|
|
78
|
+
}
|
|
79
|
+
let diffs = 0;
|
|
80
|
+
const first = sets.keys().next().value;
|
|
81
|
+
// Identical to the first means identical to each other, so many instances cost one pass, not N squared (0.22.0).
|
|
82
|
+
for (const i of sets.keys()) for (const j of ids.length > ALL_PAIRS_UP_TO ? [first] : sets.keys()) {
|
|
83
|
+
if (i === j) continue;
|
|
84
|
+
const lacks = [...sets.get(i)].filter((m) => !sets.get(j).has(m)).sort();
|
|
85
|
+
if (lacks.length) { diffs += 1; log(` members DIFFER: instance ${i} has ${lacks.join(', ')} that instance ${j} lacks`); }
|
|
86
|
+
}
|
|
87
|
+
if (diffs) red += 1;
|
|
88
|
+
else if (sets.size === ids.length) log(` members: every instance has the same ${sets.values().next().value.size} members`);
|
|
89
|
+
|
|
90
|
+
// (b) swap: every unordered pair of a few instances; of many, the first against an even spread (testing thousands of the same control
|
|
91
|
+
// is a complete waste of time; `members` above already read every one)
|
|
92
|
+
let pairs = 0, differ = 0;
|
|
93
|
+
const chosen = swapPairs(ids);
|
|
94
|
+
for (const [i, j] of chosen) {
|
|
95
|
+
const r = sh(sym.swap, root, { i, j });
|
|
96
|
+
pairs += 1;
|
|
97
|
+
if (r.code === 0) log(` swap ${i}<->${j}: same`);
|
|
98
|
+
else { differ += 1; log(` swap ${i}<->${j}: DIFFERS: "${r.line}" exited ${r.code}${tail(r.out + r.err)}`); }
|
|
99
|
+
}
|
|
100
|
+
const want = chosen.length;
|
|
101
|
+
log(ids.length > ALL_PAIRS_UP_TO ? ` swap: ${pairs} pairs checked (a spread of N = ${ids.length}), ${differ} differ` : ` swap: ${pairs} pairs checked (N·(N-1)/2 = ${want} for N = ${ids.length}), ${differ} differ`);
|
|
102
|
+
if (differ || pairs !== want) red += 1;
|
|
103
|
+
log(`${head}: ${red ? 'RED' : 'GREEN'}`);
|
|
104
|
+
return red ? 1 : 0;
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
const ALL_PAIRS_UP_TO = 8;
|
|
108
|
+
const SPREAD = 8;
|
|
109
|
+
function swapPairs(ids) {
|
|
110
|
+
if (ids.length <= ALL_PAIRS_UP_TO) return ids.flatMap((a, x) => ids.slice(x + 1).map((b) => [a, b]));
|
|
111
|
+
const step = (ids.length - 1) / SPREAD;
|
|
112
|
+
return [...new Set(Array.from({ length: SPREAD }, (_, k) => Math.round((k + 1) * step)))].map((x) => [ids[0], ids[x]]);
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
// One test per many concept. A many concept with no symmetry block still gets its test, which is red until it has one.
|
|
116
|
+
export function generate(root, { cmake, list } = {}, log = console.log) {
|
|
117
|
+
const shape = readManifest(root);
|
|
118
|
+
const names = manyConcepts(shape);
|
|
119
|
+
const abs = resolve(root);
|
|
120
|
+
const argv = (n) => [process.execPath, SELF, 'run', n, '--dir', abs];
|
|
121
|
+
if (list) for (const n of names) log(`${testName(n)}\t${argv(n).map((a) => (/\s/.test(a) ? `"${a}"` : a)).join(' ')}`);
|
|
122
|
+
if (cmake) {
|
|
123
|
+
const q = (s) => `"${s.replace(/\\/g, '/').replace(/"/g, '\\"')}"`;
|
|
124
|
+
const lines = [
|
|
125
|
+
'# Generated by claude-packs (shape-symmetry.mjs gen) from design/shape.json at configure time. Never edit, never commit:',
|
|
126
|
+
'# a change to the manifest re-runs the configure step, which writes this file again.',
|
|
127
|
+
`set_property(DIRECTORY APPEND PROPERTY CMAKE_CONFIGURE_DEPENDS ${q(join(abs, 'design', 'shape.json'))})`,
|
|
128
|
+
...names.flatMap((n) => [
|
|
129
|
+
`add_test(NAME ${testName(n)} COMMAND ${argv(n).map(q).join(' ')})`,
|
|
130
|
+
`set_tests_properties(${testName(n)} PROPERTIES LABELS shape_symmetry TIMEOUT 3600)`,
|
|
131
|
+
]),
|
|
132
|
+
'',
|
|
133
|
+
];
|
|
134
|
+
mkdirSync(dirname(resolve(cmake)), { recursive: true });
|
|
135
|
+
writeFileSync(resolve(cmake), lines.join('\n'));
|
|
136
|
+
const none = names.filter((n) => !shape.concepts[n].symmetry);
|
|
137
|
+
log(`shape_symmetry: ${names.length} test(s) in ${cmake}: ${names.map(testName).join(', ') || '(no many concept)'}${none.length ? `; red until they have a symmetry block: ${none.join(', ')}` : ''}`);
|
|
138
|
+
}
|
|
139
|
+
return 0;
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
function args(argv) {
|
|
143
|
+
const o = { rest: [], dir: process.env.CLAUDE_PROJECT_DIR ?? process.cwd() };
|
|
144
|
+
for (let k = 0; k < argv.length; k += 1) {
|
|
145
|
+
if (argv[k] === '--dir') o.dir = argv[++k];
|
|
146
|
+
else if (argv[k] === '--cmake') o.cmake = argv[++k];
|
|
147
|
+
else if (argv[k] === '--list') o.list = true;
|
|
148
|
+
else o.rest.push(argv[k]);
|
|
149
|
+
}
|
|
150
|
+
o.dir = resolve(o.dir);
|
|
151
|
+
return o;
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
export const USAGE = `usage: shape-symmetry run <concept> [--dir <root>]
|
|
155
|
+
shape-symmetry gen --cmake <out.cmake> | --list [--dir <root>]
|
|
156
|
+
In CMakeLists.txt (configure time):
|
|
157
|
+
execute_process(COMMAND node \${CMAKE_SOURCE_DIR}/.claude/tools/shape-symmetry.mjs gen --dir \${CMAKE_SOURCE_DIR}
|
|
158
|
+
--cmake \${CMAKE_BINARY_DIR}/shape_symmetry.cmake COMMAND_ERROR_IS_FATAL ANY)
|
|
159
|
+
include(\${CMAKE_BINARY_DIR}/shape_symmetry.cmake)`;
|
|
160
|
+
|
|
161
|
+
export async function main(argv) {
|
|
162
|
+
if (argv[0] === '--selftest') return (await import('./shape-symmetry-selftest.mjs')).selftest(SELF);
|
|
163
|
+
const o = args(argv);
|
|
164
|
+
const [cmd, concept] = o.rest;
|
|
165
|
+
try {
|
|
166
|
+
if (cmd === 'run' && concept) return runConcept(o.dir, concept);
|
|
167
|
+
if (cmd === 'gen' && (o.cmake || o.list)) return generate(o.dir, o);
|
|
168
|
+
} catch (e) {
|
|
169
|
+
console.error(`shape_symmetry: ${e.message}`);
|
|
170
|
+
return 2;
|
|
171
|
+
}
|
|
172
|
+
console.error(USAGE);
|
|
173
|
+
return 2;
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
// realpath: the module's own URL is the real path, the command line may go through a symlink (/var is /private/var on macOS),
|
|
177
|
+
// and a tool that silently does nothing reads as green.
|
|
178
|
+
if (process.argv[1] && realpathSync(process.argv[1]) === realpathSync(SELF)) main(process.argv.slice(2)).then((c) => process.exit(c));
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// Run the test command and hand back only the verdict, so a 5,000-line CTest log never enters
|
|
3
|
+
// the conversation. The full output goes to a log file whose path is in the JSON.
|
|
4
|
+
// node .claude/tools/test-verdict.mjs [-R <regex>] project test command (layout.commands.test)
|
|
5
|
+
// node .claude/tools/test-verdict.mjs --red <name,name> [-R <regex>] Red Gate: these tests MUST fail
|
|
6
|
+
// node .claude/tools/test-verdict.mjs -- <any command> your own command
|
|
7
|
+
// Exit 0: verdict as required (green, or the --red tests all failing). Exit 1: real failures
|
|
8
|
+
// (or a --red test passing). Exit 2: the runner itself broke (no tests ran, command missing):
|
|
9
|
+
// never a verdict about the code; fix the runner first.
|
|
10
|
+
import { spawnSync } from 'node:child_process';
|
|
11
|
+
import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
|
|
12
|
+
import { join } from 'node:path';
|
|
13
|
+
|
|
14
|
+
const ROOT = process.env.CLAUDE_PROJECT_DIR ?? process.cwd();
|
|
15
|
+
|
|
16
|
+
export function parseCtest(out) {
|
|
17
|
+
const total = out.match(/(\d+)% tests passed, (\d+) tests? failed out of (\d+)/);
|
|
18
|
+
const failed = [];
|
|
19
|
+
const block = out.split(/The following tests FAILED:/)[1] ?? '';
|
|
20
|
+
for (const m of block.matchAll(/^\s*\d+\s+-\s+(\S+)\s+\(([^)]+)\)/gm)) failed.push({ name: m[1], why: m[2] });
|
|
21
|
+
if (!total) return null;
|
|
22
|
+
return { total: Number(total[3]), failed };
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
function detail(out, name) {
|
|
26
|
+
const at = out.indexOf(`Test: ${name}`) >= 0 ? out.indexOf(`Test: ${name}`) : out.indexOf(name);
|
|
27
|
+
return at < 0 ? '' : out.slice(at, at + 1200).split('\n').slice(0, 15).join('\n');
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
function command(args) {
|
|
31
|
+
const dash = args.indexOf('--');
|
|
32
|
+
if (dash >= 0) return args.slice(dash + 1).join(' ');
|
|
33
|
+
let base;
|
|
34
|
+
try {
|
|
35
|
+
base = JSON.parse(readFileSync(join(ROOT, '.claude', 'layout.json'), 'utf8')).commands?.test;
|
|
36
|
+
} catch { /* no layout */ }
|
|
37
|
+
base ??= 'ctest --test-dir build --output-on-failure';
|
|
38
|
+
const r = args.indexOf('-R');
|
|
39
|
+
return r >= 0 ? `${base} -R '${args[r + 1]}'` : base;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
function main(args) {
|
|
43
|
+
const red = args.includes('--red') ? args[args.indexOf('--red') + 1].split(',').filter(Boolean) : null;
|
|
44
|
+
const cmd = command(args);
|
|
45
|
+
const run = spawnSync('bash', ['-c', cmd], { cwd: ROOT, encoding: 'utf8', maxBuffer: 256 * 1024 * 1024 });
|
|
46
|
+
const out = `${run.stdout ?? ''}${run.stderr ?? ''}`;
|
|
47
|
+
mkdirSync(join(ROOT, '.claude', 'state'), { recursive: true });
|
|
48
|
+
const log = join('.claude', 'state', 'last-test.log');
|
|
49
|
+
writeFileSync(join(ROOT, log), out);
|
|
50
|
+
const parsed = parseCtest(out);
|
|
51
|
+
if (!parsed || parsed.total === 0) {
|
|
52
|
+
console.log(JSON.stringify({ verdict: 'RUNNER_BROKEN', command: cmd, exit: run.status, log, tail: out.split('\n').slice(-15).join('\n') }, null, 1));
|
|
53
|
+
return 2;
|
|
54
|
+
}
|
|
55
|
+
const failures = parsed.failed.map((f) => ({ ...f, detail: detail(out, f.name) }));
|
|
56
|
+
if (red) {
|
|
57
|
+
const failedNames = new Set(parsed.failed.map((f) => f.name));
|
|
58
|
+
const passing = red.filter((n) => !failedNames.has(n));
|
|
59
|
+
const verdict = passing.length ? 'RED_GATE_FAILED' : 'RED_CONFIRMED';
|
|
60
|
+
console.log(JSON.stringify({ verdict, mustFail: red, passingUnexpectedly: passing, total: parsed.total, log }, null, 1));
|
|
61
|
+
return passing.length ? 1 : 0;
|
|
62
|
+
}
|
|
63
|
+
const verdict = failures.length ? 'FAILED' : 'GREEN';
|
|
64
|
+
console.log(JSON.stringify({ verdict, total: parsed.total, failed: failures, log }, null, 1));
|
|
65
|
+
return failures.length ? 1 : 0;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
if (process.argv.includes('--selftest')) {
|
|
69
|
+
const sample = '50% tests passed, 1 tests failed out of 2\n\nThe following tests FAILED:\n\t 2 - svf_stable_under_fm (Failed)\nErrors while running CTest\n';
|
|
70
|
+
const p = parseCtest(sample);
|
|
71
|
+
const ok = p?.total === 2 && p.failed[0]?.name === 'svf_stable_under_fm' && parseCtest('100% tests passed, 0 tests failed out of 9')?.failed.length === 0 && parseCtest('No tests were found!!!') === null;
|
|
72
|
+
console.log(ok ? 'test-verdict selftest: OK (3 cases)' : 'test-verdict selftest FAILED');
|
|
73
|
+
process.exit(ok ? 0 : 1);
|
|
74
|
+
}
|
|
75
|
+
process.exit(main(process.argv.slice(2)));
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "ci-permissions-stated",
|
|
3
|
+
"why": "With no permissions block a workflow gets the repository default, which can write.",
|
|
4
|
+
"rule": ".claude/rules/ci-covers-what-ships.md",
|
|
5
|
+
"globs": [
|
|
6
|
+
".github/workflows/*.yml",
|
|
7
|
+
".github/workflows/*.yaml"
|
|
8
|
+
],
|
|
9
|
+
"exclude": [],
|
|
10
|
+
"pattern": "^on:",
|
|
11
|
+
"flags": "m",
|
|
12
|
+
"mode": "needs",
|
|
13
|
+
"needs": [
|
|
14
|
+
"^permissions:|^\\s+permissions:"
|
|
15
|
+
],
|
|
16
|
+
"bad": "on: push\njobs:\n test:\n runs-on: ubuntu-latest\n",
|
|
17
|
+
"good": "on: push\npermissions:\n contents: read\njobs:\n test:\n runs-on: ubuntu-latest\n"
|
|
18
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "ci-tools-pinned",
|
|
3
|
+
"why": "A floating tool version changes the build under you, and the Dockerfile that pins it no longer matches.",
|
|
4
|
+
"rule": ".claude/rules/ci-covers-what-ships.md",
|
|
5
|
+
"globs": [
|
|
6
|
+
".github/workflows/*.yml",
|
|
7
|
+
".github/workflows/*.yaml"
|
|
8
|
+
],
|
|
9
|
+
"exclude": [],
|
|
10
|
+
"pattern": "^\\s*(?:version|node-version|python-version|go-version):\\s*['\\\"]?latest\\b",
|
|
11
|
+
"flags": "m",
|
|
12
|
+
"bad": " - uses: pnpm/action-setup@v4\n with:\n version: latest\n",
|
|
13
|
+
"good": " - uses: pnpm/action-setup@v4\n with:\n version: 9.15.0\n"
|
|
14
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "ci",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "CI: every language in the repo is built and tested, actions and tools are pinned, and permissions are stated.",
|
|
5
|
+
"type": "stock",
|
|
6
|
+
"author": "claude-packs",
|
|
7
|
+
"license": "MIT",
|
|
8
|
+
"homepage": "https://github.com/TheDecipherist/claude-packs",
|
|
9
|
+
"repository": {
|
|
10
|
+
"type": "git",
|
|
11
|
+
"url": "https://github.com/TheDecipherist/claude-packs.git",
|
|
12
|
+
"directory": "packs/ci"
|
|
13
|
+
},
|
|
14
|
+
"keywords": [
|
|
15
|
+
"ci",
|
|
16
|
+
"github-actions"
|
|
17
|
+
],
|
|
18
|
+
"engines": {
|
|
19
|
+
"claude-packs": ">=0.25.0"
|
|
20
|
+
}
|
|
21
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- ".github/workflows/**"
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# CI builds and tests every language the repo ships, with pinned tools and stated permissions
|
|
7
|
+
|
|
8
|
+
<constraints>
|
|
9
|
+
Always do:
|
|
10
|
+
- Run a build and the tests for every language in the repo, and build the images.
|
|
11
|
+
- Pin actions and tools to a version.
|
|
12
|
+
- State `permissions:` at the top of each workflow, as narrow as it needs.
|
|
13
|
+
|
|
14
|
+
Never do:
|
|
15
|
+
- Use `version: latest` for a tool.
|
|
16
|
+
- Treat a language CI never runs as tested.
|
|
17
|
+
</constraints>
|
|
18
|
+
|
|
19
|
+
## Check
|
|
20
|
+
`ci-tools-pinned`, `ci-permissions-stated`.
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- ".github/workflows/**"
|
|
4
|
+
- "**/CMakeLists.txt"
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Regenerating a generated file gives no diff
|
|
8
|
+
|
|
9
|
+
<constraints>
|
|
10
|
+
Always do:
|
|
11
|
+
- Regenerate generated headers and tables in CI, and fail on `git diff --exit-code`.
|
|
12
|
+
|
|
13
|
+
Never do:
|
|
14
|
+
- Trust a generated file nobody regenerates: modes once stayed clamped for weeks, with everything green.
|
|
15
|
+
</constraints>
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "captcha-is-not-constant",
|
|
3
|
+
"why": "A constant captcha answer is passed by any script that has seen it once.",
|
|
4
|
+
"rule": ".claude/rules/public-forms-are-defended.md",
|
|
5
|
+
"globs": [
|
|
6
|
+
"**/*.ts",
|
|
7
|
+
"**/*.tsx",
|
|
8
|
+
"**/*.js",
|
|
9
|
+
"**/*.mjs",
|
|
10
|
+
"**/*.cjs"
|
|
11
|
+
],
|
|
12
|
+
"exclude": [
|
|
13
|
+
"**/tests/**",
|
|
14
|
+
"**/test/**",
|
|
15
|
+
"**/*.test.*",
|
|
16
|
+
"**/*.spec.*",
|
|
17
|
+
"**/e2e/**",
|
|
18
|
+
"**/node_modules/**",
|
|
19
|
+
"**/dist/**",
|
|
20
|
+
"**/build/**",
|
|
21
|
+
"**/.next/**"
|
|
22
|
+
],
|
|
23
|
+
"pattern": "\\b\\w*CAPTCHA\\w*ANSWER\\w*\\s*=\\s*['\\\"`]|\\b(?:captcha|challenge)\\w*[Aa]nswer\\s*=\\s*['\\\"`]",
|
|
24
|
+
"bad": "const CAPTCHA_ANSWER = 'K';",
|
|
25
|
+
"good": "const answer = await newChallenge(session);",
|
|
26
|
+
"kind": "security"
|
|
27
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "img-has-size",
|
|
3
|
+
"why": "An image with no size makes the page jump as it loads.",
|
|
4
|
+
"rule": ".claude/rules/media-is-sized.md",
|
|
5
|
+
"globs": [
|
|
6
|
+
"**/*.html"
|
|
7
|
+
],
|
|
8
|
+
"exclude": [
|
|
9
|
+
"**/node_modules/**",
|
|
10
|
+
"**/dist/**",
|
|
11
|
+
"**/build/**",
|
|
12
|
+
"**/admin*/**",
|
|
13
|
+
"**/*template*",
|
|
14
|
+
"**/partials/**",
|
|
15
|
+
"**/_*/**"
|
|
16
|
+
],
|
|
17
|
+
"pattern": "<img\\b(?![^>]*\\bwidth=)[^>]*>",
|
|
18
|
+
"bad": "<img src=\"/a.webp\" alt=\"A\">",
|
|
19
|
+
"good": "<img src=\"/a.webp\" alt=\"A\" width=\"800\" height=\"600\">"
|
|
20
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "page-head-complete",
|
|
3
|
+
"why": "A page with no canonical, description or social image is found less, and shared badly.",
|
|
4
|
+
"rule": ".claude/rules/page-head-is-complete.md",
|
|
5
|
+
"globs": [
|
|
6
|
+
"**/*.html"
|
|
7
|
+
],
|
|
8
|
+
"exclude": [
|
|
9
|
+
"**/node_modules/**",
|
|
10
|
+
"**/dist/**",
|
|
11
|
+
"**/build/**",
|
|
12
|
+
"**/admin*/**",
|
|
13
|
+
"**/*template*",
|
|
14
|
+
"**/partials/**",
|
|
15
|
+
"**/_*/**"
|
|
16
|
+
],
|
|
17
|
+
"pattern": "<html\\b",
|
|
18
|
+
"bad": "<html lang=\"en\"><head><title>A</title></head></html>",
|
|
19
|
+
"good": "<html lang=\"en\"><head><title>A</title><meta name=\"description\" content=\"x\"><link rel=\"canonical\" href=\"/a\"><meta property=\"og:image\" content=\"/a.png\"></head></html>",
|
|
20
|
+
"mode": "needs",
|
|
21
|
+
"needs": [
|
|
22
|
+
"rel=[\"']canonical",
|
|
23
|
+
"name=[\"']description",
|
|
24
|
+
"property=[\"']og:image"
|
|
25
|
+
]
|
|
26
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "content-site",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "Sites that publish: blogs, docs and marketing pages. Every page has a complete head, a page has one source, public forms are defended, comments are moderated, and media is sized.",
|
|
5
|
+
"type": "stock",
|
|
6
|
+
"author": "claude-packs",
|
|
7
|
+
"license": "MIT",
|
|
8
|
+
"homepage": "https://github.com/TheDecipherist/claude-packs",
|
|
9
|
+
"repository": {
|
|
10
|
+
"type": "git",
|
|
11
|
+
"url": "https://github.com/TheDecipherist/claude-packs.git",
|
|
12
|
+
"directory": "packs/content-site"
|
|
13
|
+
},
|
|
14
|
+
"keywords": [
|
|
15
|
+
"seo",
|
|
16
|
+
"blog",
|
|
17
|
+
"content"
|
|
18
|
+
],
|
|
19
|
+
"engines": {
|
|
20
|
+
"claude-packs": ">=0.27.0"
|
|
21
|
+
}
|
|
22
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.html"
|
|
4
|
+
- "**/*.md"
|
|
5
|
+
- "**/*.mdx"
|
|
6
|
+
- "**/*.tsx"
|
|
7
|
+
- "**/*.ts"
|
|
8
|
+
- "**/*.js"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# A page has one source, and what is built from it is never edited
|
|
12
|
+
|
|
13
|
+
<constraints>
|
|
14
|
+
Always do:
|
|
15
|
+
- Keep one source for each page, and generate the rest: HTML, the index, the sitemap, the feed.
|
|
16
|
+
- Regenerate the sitemap in the build, so a new page cannot be left out.
|
|
17
|
+
- Keep URLs stable. A renamed page gets a redirect, in the same change.
|
|
18
|
+
- Keep tutorial files and sample code in a folder scans can tell from the project's own.
|
|
19
|
+
|
|
20
|
+
Never do:
|
|
21
|
+
- Edit generated HTML by hand, or keep two folders with the same article under different slugs.
|
|
22
|
+
- Change a published URL without a redirect.
|
|
23
|
+
</constraints>
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.html"
|
|
4
|
+
- "**/*.md"
|
|
5
|
+
- "**/*.mdx"
|
|
6
|
+
- "**/*.tsx"
|
|
7
|
+
- "**/*.ts"
|
|
8
|
+
- "**/*.js"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Images are sized and light, and big files stay out of git
|
|
12
|
+
|
|
13
|
+
<constraints>
|
|
14
|
+
Always do:
|
|
15
|
+
- Give every image `width` and `height`, so the page does not jump.
|
|
16
|
+
- Lazy load what is below the fold, and serve modern formats.
|
|
17
|
+
- Keep large media in object storage or a release, out of the repo.
|
|
18
|
+
|
|
19
|
+
Never do:
|
|
20
|
+
- Commit a working screenshot or a debug dump (`repo-litter` refuses them).
|
|
21
|
+
</constraints>
|
|
22
|
+
|
|
23
|
+
## Check
|
|
24
|
+
`img-has-size`.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.html"
|
|
4
|
+
- "**/*.md"
|
|
5
|
+
- "**/*.mdx"
|
|
6
|
+
- "**/*.tsx"
|
|
7
|
+
- "**/*.ts"
|
|
8
|
+
- "**/*.js"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Every public page has a complete head
|
|
12
|
+
|
|
13
|
+
<constraints>
|
|
14
|
+
Always do:
|
|
15
|
+
- Give every public page a unique `<title>`, a `description`, a `canonical` link, Open Graph tags with an image, and `lang` on `<html>`.
|
|
16
|
+
- Add structured data (`application/ld+json`) for articles.
|
|
17
|
+
- Build the head from one template, fed by the page's own data.
|
|
18
|
+
- Keep admin and preview pages out of search with `noindex`.
|
|
19
|
+
|
|
20
|
+
Never do:
|
|
21
|
+
- Copy a head from page to page by hand.
|
|
22
|
+
- Ship a page with no canonical link: duplicates then compete with each other.
|
|
23
|
+
</constraints>
|
|
24
|
+
|
|
25
|
+
## Check
|
|
26
|
+
`page-head-complete`.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/*.html"
|
|
4
|
+
- "**/*.md"
|
|
5
|
+
- "**/*.mdx"
|
|
6
|
+
- "**/*.tsx"
|
|
7
|
+
- "**/*.ts"
|
|
8
|
+
- "**/*.js"
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# A public form expects abuse: rate limits, a real challenge, moderation
|
|
12
|
+
|
|
13
|
+
<constraints>
|
|
14
|
+
Always do:
|
|
15
|
+
- Rate limit every public form, per IP and per account.
|
|
16
|
+
- Use a challenge that cannot be replayed or read from the page, or a honeypot and a time check.
|
|
17
|
+
- Hold comments for moderation by default, with a status field.
|
|
18
|
+
- Render user text through one sanitiser, on the server, and store the source as well as the output.
|
|
19
|
+
- Escape every value that goes into `innerHTML`, or use `textContent`.
|
|
20
|
+
|
|
21
|
+
Never do:
|
|
22
|
+
- Use a constant captcha answer: a script passes it.
|
|
23
|
+
- Trust the client's copy of a score, a rating or a counter.
|
|
24
|
+
</constraints>
|
|
25
|
+
|
|
26
|
+
## Check
|
|
27
|
+
`captcha-is-not-constant`.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: publish-a-page
|
|
3
|
+
description: Use when adding or renaming an article, a blog post or a public page.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Publish a page (one job: it is found, it loads fast, and old links still work)
|
|
7
|
+
|
|
8
|
+
<constraints>
|
|
9
|
+
Always do:
|
|
10
|
+
1. Write the source, and build the page from it. Never edit the built HTML.
|
|
11
|
+
2. Check the head: title, description, canonical, Open Graph image, structured data.
|
|
12
|
+
3. Size and compress every image.
|
|
13
|
+
4. Run the build, so the index, the sitemap and the feed include it.
|
|
14
|
+
5. For a rename, add the redirect in the same change.
|
|
15
|
+
6. Open the page at phone width, and read it once as a stranger.
|
|
16
|
+
7. Run the `humanize` skill on the text.
|
|
17
|
+
|
|
18
|
+
Never do:
|
|
19
|
+
- Publish with a placeholder image or description.
|
|
20
|
+
- Reuse a slug for different content.
|
|
21
|
+
</constraints>
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "cpp-clamp-before-cast",
|
|
3
|
+
"why": "Casting a NaN or an out-of-range float to an integer is undefined, so a clamp after the cast comes too late. Clamp the float, then cast, and check a computed value is finite first.",
|
|
4
|
+
"rule": ".claude/rules/cpp-numbers-and-casts.md",
|
|
5
|
+
"concepts": [
|
|
6
|
+
"cpp"
|
|
7
|
+
],
|
|
8
|
+
"globs": [],
|
|
9
|
+
"exclude": [
|
|
10
|
+
"**/build/**"
|
|
11
|
+
],
|
|
12
|
+
"code": true,
|
|
13
|
+
"pattern": "std::(?:clamp|min|max)(?:<\\w+>)?\\s*\\(\\s*(?:-?[\\w.]+\\s*,\\s*)?(?:(?:int|long|int\\d+_t|size_t)\\s*\\(|static_cast<\\s*(?:int|long|std::int\\d+_t|int\\d+_t|std::size_t|size_t)\\s*>\\s*\\()(?!\\s*std::l+r(?:ound|int)\\b)(?=[^;\\n]*(?:\\d\\.\\d|std::(?:floor|ceil|round|trunc|log|log2|log10|sqrt|pow|exp)\\b|float\\s*\\(|double\\s*\\(|/))",
|
|
14
|
+
"bad": "const int steps = std::clamp (int (dist / 0.25f), 8, 240);",
|
|
15
|
+
"good": "const int steps = int (std::clamp (dist / 0.25f, 8.0f, 240.0f));\nstd::clamp (int (std::lround (x)), 0, 4);\nstd::max (0, int (list.size()) - 1);"
|
|
16
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "cpp-find-with-the-library",
|
|
3
|
+
"why": "A search loop over a list, compared on one member, is short enough to be copied everywhere, and every copy treats a miss its own way. std::ranges::find with a projection says it in one call; a search used twice is one named function.",
|
|
4
|
+
"rule": ".claude/rules/cpp-find-with-the-library.md",
|
|
5
|
+
"concepts": ["cpp"],
|
|
6
|
+
"globs": [],
|
|
7
|
+
"exclude": ["**/build/**"],
|
|
8
|
+
"code": true,
|
|
9
|
+
"pattern": "for\\s*\\(\\s*(?:const\\s+)?auto\\s*&&?\\s*(\\w+)\\s*:\\s*[^;{}\\n]+\\)\\s*\\{?\\s*if\\s*\\(\\s*\\1\\s*(?:\\.|->)\\s*\\w+\\s*==[^\\n]*\\)\\s*(?:\\{[^{}]{0,200}?)?\\b(?:return|break)\\b",
|
|
10
|
+
"bad": "for (const auto& c : shown().controls) if (c.id == id) return &c;",
|
|
11
|
+
"good": "const auto it = std::ranges::find (controls, id, &Control::id);\nfor (const auto& c : controls) total += c.width;\nfor (const auto& c : controls) if (c.width > limit) wide.push_back (c);\nfor (const auto& target : targets) if (target.kind == none) continue;"
|
|
12
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "cpp-hardened-test-build",
|
|
3
|
+
"why": "Standard library hardening turns an out-of-range index into a stop instead of silent memory access. A test build should have it.",
|
|
4
|
+
"rule": ".claude/rules/cpp-absent-and-failed-are-types.md",
|
|
5
|
+
"concepts": [],
|
|
6
|
+
"globs": [
|
|
7
|
+
"**/CMakePresets.json"
|
|
8
|
+
],
|
|
9
|
+
"exclude": [],
|
|
10
|
+
"code": false,
|
|
11
|
+
"pattern": "\"CMAKE_CXX_FLAGS\"\\s*:",
|
|
12
|
+
"bad": "{\"CMAKE_CXX_FLAGS\": \"-O2\"}",
|
|
13
|
+
"good": "{\"CMAKE_CXX_FLAGS\": \"-D_LIBCPP_HARDENING_MODE=_LIBCPP_HARDENING_MODE_FAST\"}",
|
|
14
|
+
"mode": "needs",
|
|
15
|
+
"needs": [
|
|
16
|
+
"_LIBCPP_HARDENING_MODE|_GLIBCXX_ASSERTIONS"
|
|
17
|
+
]
|
|
18
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "cpp-m-pi-not-standard",
|
|
3
|
+
"why": "M_PI is not standard C++: MSVC hides it, and the missing name cascades into strange errors. std::numbers has it.",
|
|
4
|
+
"rule": ".claude/rules/cpp-builds-everywhere.md",
|
|
5
|
+
"globs": [
|
|
6
|
+
"**/*.cpp",
|
|
7
|
+
"**/*.cc",
|
|
8
|
+
"**/*.h",
|
|
9
|
+
"**/*.hpp",
|
|
10
|
+
"**/*.mm"
|
|
11
|
+
],
|
|
12
|
+
"exclude": [
|
|
13
|
+
"**/build/**",
|
|
14
|
+
"**/out/**",
|
|
15
|
+
"**/_deps/**",
|
|
16
|
+
"**/JUCE/**",
|
|
17
|
+
"**/node_modules/**"
|
|
18
|
+
],
|
|
19
|
+
"pattern": "\\bM_(?:PI|PI_2|PI_4|E|SQRT2|LN2)\\b",
|
|
20
|
+
"bad": "const double w = 2.0 * M_PI * f;",
|
|
21
|
+
"good": "const double w = 2.0 * std::numbers::pi * f;",
|
|
22
|
+
"code": true
|
|
23
|
+
}
|