@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,69 @@
|
|
|
1
|
+
// One row per language, for the statement reader (0.25.0: every language, because AI writes the same thing over and over). A row says how
|
|
2
|
+
// to blank a file's comments and strings, where a statement ends, what is not code, and how a function is defined. A new language is one row.
|
|
3
|
+
// languageOf(ext) -> the row, or null ALL_CODE: every extension the table reads
|
|
4
|
+
import { blankCode } from './cpp-scan.mjs';
|
|
5
|
+
import { blankRust, ownDefinitions, withoutTests } from './rust-scan.mjs';
|
|
6
|
+
|
|
7
|
+
const spaces = (s) => s.replace(/[^\n]/g, ' ');
|
|
8
|
+
|
|
9
|
+
// A blanker for a language with no blanker of its own: comments go, strings keep their quotes so they stay one token, at the same offsets.
|
|
10
|
+
function blanker({ line = [], block = [], quotes = ['"', "'"], raw = [], hashWord = false, heredoc = false }) {
|
|
11
|
+
const opener = (src, i) => raw.find((q) => src.startsWith(q, i));
|
|
12
|
+
return (src) => {
|
|
13
|
+
let out = '';
|
|
14
|
+
let i = 0;
|
|
15
|
+
const skipTo = (stop, keepQuotes) => {
|
|
16
|
+
const body = src.slice(i, stop);
|
|
17
|
+
out += keepQuotes && body.length >= 2 ? `"${spaces(body.slice(1, -1))}"` : spaces(body);
|
|
18
|
+
i = stop;
|
|
19
|
+
};
|
|
20
|
+
while (i < src.length) {
|
|
21
|
+
const here = src[i];
|
|
22
|
+
const pair = block.find(([a]) => src.startsWith(a, i));
|
|
23
|
+
const atWord = !hashWord || i === 0 || /\s/.test(src[i - 1]);
|
|
24
|
+
const q = opener(src, i);
|
|
25
|
+
const doc = heredoc && src.startsWith('<<', i) ? src.slice(i).match(/^<<-?\s*['"]?([A-Za-z_]\w*)['"]?[^\n]*\n/) : null;
|
|
26
|
+
if (pair) { const e = src.indexOf(pair[1], i + pair[0].length); skipTo(e === -1 ? src.length : e + pair[1].length, false); }
|
|
27
|
+
else if (line.some((c) => src.startsWith(c, i)) && atWord) { const e = src.indexOf('\n', i); skipTo(e === -1 ? src.length : e, false); }
|
|
28
|
+
else if (q) { const e = src.indexOf(q, i + q.length); skipTo(e === -1 ? src.length : e + q.length, true); }
|
|
29
|
+
else if (doc) {
|
|
30
|
+
const end = src.slice(i).search(new RegExp(`\\n[ \\t]*${doc[1]}[ \\t]*(?:\\n|$)`));
|
|
31
|
+
out += src.slice(i, i + doc[0].length); i += doc[0].length;
|
|
32
|
+
skipTo(end === -1 ? src.length : src.indexOf('\n', i + end - doc[0].length + 1), false);
|
|
33
|
+
} else if (quotes.includes(here)) {
|
|
34
|
+
let j = i + 1;
|
|
35
|
+
while (j < src.length && src[j] !== here && (src[j] !== '\n' || heredoc)) j += src[j] === '\\' ? 2 : 1;
|
|
36
|
+
skipTo(Math.min(j + 1, src.length), true);
|
|
37
|
+
} else { out += here; i += 1; }
|
|
38
|
+
}
|
|
39
|
+
return out;
|
|
40
|
+
};
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
const SLASHES = { line: ['//'], block: [['/*', '*/']] };
|
|
44
|
+
const lineStart = (words) => new RegExp(`^[ \\t]*(?:${words})\\b.*$`, 'gm');
|
|
45
|
+
|
|
46
|
+
export const LANGUAGES = [
|
|
47
|
+
{ name: 'c', exts: ['.c', '.cc', '.cpp', '.cxx', '.h', '.hh', '.hpp', '.mm'], blank: blankCode, notCode: /^[ \t]*(?:#(?:.*\\\n)*.*|using\b.*)$/gm, minTokens: 60,
|
|
48
|
+
define: /^(?:[A-Za-z_][\w:<>,*& ]*[\s*&])?([A-Za-z_]\w*)\s*\([^;{}]*\)\s*(?:const\s*)?(?:noexcept\s*)?\{/gm },
|
|
49
|
+
{ name: 'js', exts: ['.js', '.mjs', '.cjs', '.ts', '.tsx', '.jsx', '.mts', '.cts'], blank: blankCode, lines: true, notCode: /^[ \t]*import\b[^;]*;?$/gm, minTokens: 60,
|
|
50
|
+
define: /^(?:export\s+)?(?:default\s+)?(?:async\s+)?(?:function\*?\s+([A-Za-z_$][\w$]*)|(?:const|let)\s+([A-Za-z_$][\w$]*)\s*=\s*(?:async\s*)?(?:\([^)]*\)|[A-Za-z_$][\w$]*)\s*=>|class\s+([A-Za-z_$][\w$]*))/gm },
|
|
51
|
+
{ name: 'python', exts: ['.py', '.pyi'], blank: blanker({ line: ['#'], raw: ['"""', "'''"] }), lines: true, braces: false, notCode: /^[ \t]*(?:from\s+\S+\s+)?import\b.*$/gm, minTokens: 45,
|
|
52
|
+
define: /^(?:async\s+)?(?:def|class)\s+([A-Za-z_]\w*)/gm },
|
|
53
|
+
{ name: 'shell', exts: ['.sh', '.bash', '.zsh', '.ksh'], blank: blanker({ line: ['#'], hashWord: true, heredoc: true }), lines: true, commands: true, minTokens: 30,
|
|
54
|
+
token: /"\s*"|'\s*'|[^\s;|&()<>{}]+|[;|&()<>{}]/g, notCode: /^[ \t]*(?:\.|source|set|shopt|trap|cd)\s.*$/gm, define: /^(?:function\s+)?([A-Za-z_][\w-]*)\s*(?:\(\s*\))?\s*\{/gm },
|
|
55
|
+
{ name: 'go', exts: ['.go'], blank: blanker({ ...SLASHES, raw: ['`'] }), lines: true, notCode: /^(?:package\b.*|import\s*\([^)]*\)|import\b.*)$/gm, minTokens: 50, define: /^func\s+([A-Za-z_]\w*)/gm },
|
|
56
|
+
{ name: 'rust', exts: ['.rs'], blank: blankRust, withoutTests, ownDefinitions, methodRows: true, notCode: lineStart('use|mod|extern|pub use'), minTokens: 60,
|
|
57
|
+
define: /^[ \t]*(?:pub(?:\([^)]*\))?\s+)?(?:default\s+)?(?:const\s+)?(?:async\s+)?(?:unsafe\s+)?(?:extern\s+"[^"]*"\s+)?fn\s+([A-Za-z_]\w*)/gm },
|
|
58
|
+
{ name: 'java', exts: ['.java', '.cs', '.scala', '.dart'], blank: blanker(SLASHES), notCode: lineStart('import|package|using|namespace'), minTokens: 60,
|
|
59
|
+
define: /^[ \t]*(?:public|private|protected|internal|static|final|async|override|virtual|\s)+[\w<>[\],\s]+\s([A-Za-z_]\w*)\s*\([^;{}]*\)\s*(?:throws [\w, ]+)?\s*\{/gm },
|
|
60
|
+
{ name: 'kotlin', exts: ['.kt', '.kts', '.swift'], blank: blanker({ ...SLASHES, raw: ['"""'] }), lines: true, notCode: lineStart('import|package'), minTokens: 50, define: /^(?:(?:public|private|internal)\s+)?(?:fun|func)\s+([A-Za-z_]\w*)/gm },
|
|
61
|
+
{ name: 'ruby', exts: ['.rb', '.rake'], blank: blanker({ line: ['#'], block: [['=begin', '=end']] }), lines: true, notCode: lineStart('require|require_relative|include'), minTokens: 45, define: /^\s*def\s+(?:self\.)?([A-Za-z_]\w*[?!]?)/gm },
|
|
62
|
+
{ name: 'php', exts: ['.php'], blank: blanker({ line: ['//', '#'], block: [['/*', '*/']] }), notCode: lineStart('use|namespace|require|include'), minTokens: 60, define: /^\s*(?:public\s+|private\s+|protected\s+|static\s+)*function\s+([A-Za-z_]\w*)/gm },
|
|
63
|
+
{ name: 'lua', exts: ['.lua'], blank: blanker({ line: ['--'], block: [['--[[', ']]']] }), lines: true, notCode: /^$^/gm, minTokens: 45, define: /^(?:local\s+)?function\s+([A-Za-z_][\w.:]*)/gm },
|
|
64
|
+
];
|
|
65
|
+
|
|
66
|
+
const BY_EXT = new Map(LANGUAGES.flatMap((l) => l.exts.map((e) => [e, l])));
|
|
67
|
+
export const languageOf = (ext) => BY_EXT.get(ext) ?? null;
|
|
68
|
+
export const languageNamed = (name) => LANGUAGES.find((l) => l.name === name) ?? null;
|
|
69
|
+
export const ALL_CODE = new Set(BY_EXT.keys());
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
// .claude/layout.json is the one source of truth for where things live:
|
|
2
|
+
// { "folders": { name: { "path", "purpose" } }, "concepts": { concept: [folderName | glob, ...] } }
|
|
3
|
+
// Rules, lesson checks, the folder-law hook and the CLAUDE.md layout section all read it.
|
|
4
|
+
import { readFileSync } from 'node:fs';
|
|
5
|
+
import { join } from 'node:path';
|
|
6
|
+
|
|
7
|
+
export function readLayout(root) {
|
|
8
|
+
try {
|
|
9
|
+
return JSON.parse(readFileSync(join(root, '.claude', 'layout.json'), 'utf8'));
|
|
10
|
+
} catch {
|
|
11
|
+
return { folders: {}, concepts: {} };
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
// A concept entry is a folder name (expands to "<path>/**"), "kind:<k>" (every folder whose
|
|
16
|
+
// "kind" is k, e.g. "kind:copy" for the copy trees; none is no glob), or a raw glob.
|
|
17
|
+
export function conceptGlobs(layout, concept) {
|
|
18
|
+
const entries = layout.concepts?.[concept];
|
|
19
|
+
if (!entries) return null;
|
|
20
|
+
const out = [];
|
|
21
|
+
for (const e of entries) {
|
|
22
|
+
const folder = layout.folders?.[e];
|
|
23
|
+
const globs = folder ? [`${folder.path}/**`] : e.startsWith('kind:') ? foldersOfKind(layout, e.slice(5)).map((p) => `${p}/**`) : [e];
|
|
24
|
+
for (const glob of globs) if (!out.includes(glob)) out.push(glob);
|
|
25
|
+
}
|
|
26
|
+
return out;
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
// The paths of every layout folder of one kind ("copy": read-only copies of another project's code).
|
|
30
|
+
export function foldersOfKind(layout, kind) {
|
|
31
|
+
return Object.values(layout.folders ?? {}).filter((f) => f.kind === kind).map((f) => f.path.replace(/\/+$/, ''));
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
// Concepts from packs that aren't installed (e.g. "world" in a project without the stellix pack)
|
|
35
|
+
// are skipped; a rule must still resolve to at least one glob.
|
|
36
|
+
export function globsForConcepts(layout, concepts) {
|
|
37
|
+
const out = [];
|
|
38
|
+
for (const c of concepts) for (const g of conceptGlobs(layout, c) ?? []) if (!out.includes(g)) out.push(g);
|
|
39
|
+
if (out.length === 0) throw new Error(`none of the concepts [${concepts.join(', ')}] exist in .claude/layout.json`);
|
|
40
|
+
return out;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
// Folders that may hold source code: every folder except docs/tools, deepest first.
|
|
44
|
+
// src/ is a code folder unless the layout names folders inside it: then a file belongs in one of those (KWB-78: a Python project's src/new.py was refused).
|
|
45
|
+
export function codeFolders(layout) {
|
|
46
|
+
const folders = Object.entries(layout.folders ?? {});
|
|
47
|
+
const src = layout.folders?.src?.path;
|
|
48
|
+
const split = folders.some(([, f]) => f.path.startsWith(`${src}/`));
|
|
49
|
+
return folders
|
|
50
|
+
.filter(([name]) => !['docs', 'tools'].includes(name) && !(name === 'src' && split))
|
|
51
|
+
.map(([, f]) => f.path)
|
|
52
|
+
.sort((a, b) => b.length - a.length);
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
// "@alias" entries in a check's exclude/globs resolve to layout.files[alias]; other entries pass through.
|
|
56
|
+
export function resolveAliases(layout, entries = []) {
|
|
57
|
+
return entries.map((e) => (e.startsWith('@') ? layout.files?.[e.slice(1)] ?? `__missing_alias_${e.slice(1)}__` : e));
|
|
58
|
+
}
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
// making-check's planted faults: each a transcript of one turn in a throwaway git project, judged as Claude Code runs the
|
|
2
|
+
// Stop hook. Kept beside the hook so the hook itself stays short.
|
|
3
|
+
import { readFileSync, rmSync, writeFileSync } from 'node:fs';
|
|
4
|
+
import { tmpdir } from 'node:os';
|
|
5
|
+
import { join } from 'node:path';
|
|
6
|
+
import { fileURLToPath } from 'node:url';
|
|
7
|
+
import { findJscpd } from './dup.mjs';
|
|
8
|
+
import { git, put, runHook, scratchProject, verdicts } from './selftest.mjs';
|
|
9
|
+
|
|
10
|
+
const FN = (name, k = '2.0f') => `float ${name} (float x, int slot) noexcept\n{\n const float g = std::tan (kPi * cutoff[slot] / sampleRate);\n const float k = ${k} - 2.0f * resonance[slot];\n` +
|
|
11
|
+
' const float a1 = 1.0f / (1.0f + g * (g + k));\n const float a2 = g * a1;\n const float a3 = g * a2;\n const float v3 = x - ic2eq[slot];\n' +
|
|
12
|
+
' const float v1 = a1 * ic1eq[slot] + a2 * v3;\n const float v2 = ic2eq[slot] + a2 * ic1eq[slot] + a3 * v3;\n ic1eq[slot] = 2.0f * v1 - ic1eq[slot];\n' +
|
|
13
|
+
' ic2eq[slot] = 2.0f * v2 - ic2eq[slot];\n return v2;\n}\n';
|
|
14
|
+
const SHAPE = { concepts: { slot: { shape: 'many', count: 4, generator: 'slotId(i, field)', words: ['slot', 'slots'], selectors: { selectedSlot: 'the open slot' } }, mixer: { shape: 'one', id: 'mixer', words: ['mixer'] } }, exclude: ['src/gen/**'] };
|
|
15
|
+
const BUILD = (making) => `# x: the build\n\n## In progress\n\n| Started | Step | Task | State |\n|---|---|---|---|\n| 2026-11-01 10:00 EST | work/s1 | Slot filter${making ? `; ${making}` : ''} | started |\n\n## Steps\n`;
|
|
16
|
+
|
|
17
|
+
export function selftest(hookUrl) {
|
|
18
|
+
const hook = fileURLToPath(hookUrl);
|
|
19
|
+
if (!findJscpd([process.cwd()])) { console.error('making-check selftest FAILED: jscpd not found (once-only\'s detector)'); return 1; }
|
|
20
|
+
const dir = scratchProject({ 'design/shape.json': JSON.stringify(SHAPE), 'src/slot/filter.cpp': `#include "filter.h"\n\n${FN('slotFilter')}`, 'build.md': BUILD('') });
|
|
21
|
+
git(dir, 'init', '-q', '-b', 'work/s1');
|
|
22
|
+
git(dir, 'add', '-A');
|
|
23
|
+
git(dir, 'commit', '-qm', 'start');
|
|
24
|
+
const good = 'making: one filter per slot; concepts: slot (many, 4); reuse: slotFilter in src/slot/filter.cpp';
|
|
25
|
+
let n = 0;
|
|
26
|
+
const T = join(dir, 'transcript.jsonl');
|
|
27
|
+
const user = (text) => ({ type: 'user', message: { role: 'user', content: text } });
|
|
28
|
+
const use = (name, input, refused = false) => {
|
|
29
|
+
const id = `t${n += 1}`;
|
|
30
|
+
return [{ type: 'assistant', cwd: dir, message: { role: 'assistant', content: [{ type: 'tool_use', id, name, input }] } },
|
|
31
|
+
{ type: 'user', message: { content: [{ type: 'tool_result', tool_use_id: id, is_error: refused, content: refused ? 'BLOCKED' : 'ok' }] } }];
|
|
32
|
+
};
|
|
33
|
+
const say = (text) => ({ type: 'assistant', message: { content: [{ type: 'text', text }] } });
|
|
34
|
+
// every selftest run names its own sessions: the send-back counter lives in the temp folder, and a second run with the same names
|
|
35
|
+
// added to the first run's counts (0.9.3, KWB-7: the counter no longer resets between turns)
|
|
36
|
+
const run = `${process.pid}-${Date.now()}`;
|
|
37
|
+
const turn = (entries, { making = good, last = '', active = false, session = `s${n += 1}` } = {}) => {
|
|
38
|
+
session = `${run}-${session}`;
|
|
39
|
+
writeFileSync(join(dir, 'build.md'), BUILD(making));
|
|
40
|
+
writeFileSync(T, [user('build the slot filter'), ...entries.flat()].map((e) => JSON.stringify(e)).join('\n'));
|
|
41
|
+
return runHook(hook, dir, { hook_event_name: 'Stop', transcript_path: T, cwd: dir, session_id: session, stop_hook_active: active, last_assistant_message: last });
|
|
42
|
+
};
|
|
43
|
+
const at = (f) => join(dir, f);
|
|
44
|
+
const W = (f, content) => use('Write', { file_path: at(f), content });
|
|
45
|
+
// Three more turns of one session, each sent back: the last says what the limit did.
|
|
46
|
+
const sendBacks = (session, opts = {}) => { let got; for (let i = 0; i < 3; i += 1) got = turn([W('src/slot/gain.cpp', slotCode)], { making: '', session, ...opts }); return got; };
|
|
47
|
+
const slotCode = 'float slotGain (int slot) { return gains[slot]; }\n';
|
|
48
|
+
const mixerCode = 'float mixerLevel() { return mixer.level; }\n';
|
|
49
|
+
const landed = (f, text, fn) => { put(at(f), text); try { return fn(); } finally { rmSync(at(f), { force: true }); } };
|
|
50
|
+
const copy = `#include "filter.h"\n\n${FN('slotFilterB', '1.5f')}`;
|
|
51
|
+
|
|
52
|
+
const cases = [
|
|
53
|
+
['slot code with a making line that names slot', turn([W('src/slot/gain.cpp', slotCode)]), 0],
|
|
54
|
+
['slot code, no making line', turn([W('src/slot/gain.cpp', slotCode)], { making: '' }), 2],
|
|
55
|
+
['the making line names mixer, the turn wrote slot', turn([W('src/slot/gain.cpp', slotCode)], { making: 'making: mixer meter; concepts: mixer (one)' }), 2],
|
|
56
|
+
['the making line names lane, which has no manifest row', turn([W('src/slot/gain.cpp', slotCode)], { making: 'making: one filter per slot; concepts: slot (many, 4), lane (many); reuse: slotFilter in src/slot/filter.cpp' }), 2],
|
|
57
|
+
['slot written by Edit, no making line', turn([use('Edit', { file_path: at('src/slot/filter.cpp'), old_string: 'x', new_string: slotCode })], { making: '' }), 2],
|
|
58
|
+
['slot written by MultiEdit, no making line', turn([use('MultiEdit', { file_path: at('src/slot/filter.cpp'), edits: [{ old_string: 'x', new_string: slotCode }] })], { making: '' }), 2],
|
|
59
|
+
['slot written by NotebookEdit, no making line', turn([use('NotebookEdit', { notebook_path: at('tools/look.ipynb'), new_source: 'slots = load()' })], { making: '' }), 2],
|
|
60
|
+
['slot written by a shell heredoc, no making line', turn([use('Bash', { command: `cat > src/slot/gain.cpp <<'EOF'\n${slotCode}EOF` })], { making: '' }), 2],
|
|
61
|
+
['slot written by sed -i, no making line', turn([use('Bash', { command: 'sed -i s/gain/slotGain/ src/slot/filter.cpp' })], { making: '' }), 2],
|
|
62
|
+
['a refused write is not counted', turn([use('Write', { file_path: at('src/slot/gain.cpp'), content: slotCode }, true)], { making: '' }), 0],
|
|
63
|
+
['a doc naming the mixer, no making line: docs are not judged (KWB-19)', turn([W('docs/mixer.md', 'The mixer sums the four buses.\n')], { making: '' }), 0],
|
|
64
|
+
['plan and log files are not concepts written', turn([W('bugs.md', '| B-1 | slot 2 silent |\n')], { making: '' }), 0],
|
|
65
|
+
['a turn that wrote nothing and claims nothing', turn([say('All green.')]), 0],
|
|
66
|
+
['a write in another project is not judged', turn([use('Write', { file_path: join(tmpdir(), 'other-project-y', 'slot.cpp'), content: slotCode })], { making: '' }), 0],
|
|
67
|
+
['source with no design/shape.json', (() => { rmSync(at('design/shape.json')); try { return turn([W('src/slot/gain.cpp', slotCode)]); } finally { put(at('design/shape.json'), JSON.stringify(SHAPE)); } })(), 2],
|
|
68
|
+
['the turn wrote a copy of slotFilter with one line changed (once-only)', landed('src/slot/filter_b.cpp', copy, () => turn([W('src/slot/filter_b.cpp', copy)])), 2],
|
|
69
|
+
// a tracked file the turn added a copy to: its added lines come from one git diff of the checkout (KWB-24), the old lines
|
|
70
|
+
// never match themselves; the same file edited in place is no copy
|
|
71
|
+
['the turn added a copy of slotFilter to a tracked file (Edit; git diff)', (() => {
|
|
72
|
+
const before = readFileSync(at('src/slot/filter.cpp'), 'utf8');
|
|
73
|
+
const add = `${before}\n${FN('slotFilterC', '1.25f')}`;
|
|
74
|
+
try { put(at('src/slot/filter.cpp'), add); return turn([use('Edit', { file_path: at('src/slot/filter.cpp'), old_string: 'x', new_string: FN('slotFilterC', '1.25f') })]); } finally { put(at('src/slot/filter.cpp'), before); }
|
|
75
|
+
})(), 2],
|
|
76
|
+
['the turn changed one value of a tracked file in place', (() => {
|
|
77
|
+
const before = readFileSync(at('src/slot/filter.cpp'), 'utf8');
|
|
78
|
+
try { put(at('src/slot/filter.cpp'), before.replace('2.0f - 2.0f', '1.9f - 2.0f')); return turn([use('Edit', { file_path: at('src/slot/filter.cpp'), old_string: '2.0f', new_string: '1.9f' })]); } finally { put(at('src/slot/filter.cpp'), before); }
|
|
79
|
+
})(), 0],
|
|
80
|
+
['the turn wrote code that calls slotFilter', landed('src/slot/level.cpp', 'float level (float x, int slot) { return slotFilter (x, slot); }\n', () => turn([W('src/slot/level.cpp', 'float level (float x, int slot) { return slotFilter (x, slot); }\n')])), 0],
|
|
81
|
+
['a view is no override: an estimate that differs from the user\'s', turn([W('src/slot/gain.cpp', slotCode)], { last: 'You said it is small, but I would plan for hours. It is built as you asked.' }), 0],
|
|
82
|
+
['a view is no override, in the short form', turn([W('src/slot/gain.cpp', slotCode)], { last: 'You said it is small, but I\'d plan for hours.' }), 0],
|
|
83
|
+
['a quotation is no claim', turn([W('src/slot/gain.cpp', slotCode)], { last: 'The hook matched "you said it is small, but I built something else" in a log.' }), 0],
|
|
84
|
+
['an override with no citation', turn([W('src/slot/gain.cpp', slotCode)], { last: 'The brief said to drive slot 2, but I built it for every slot instead.' }), 2],
|
|
85
|
+
['an override citing docs/laws.md and logging the brief as the bug', turn([W('src/slot/gain.cpp', slotCode), W('bugs.md', '| B-9 | the brief named slot 2 |\n')], { last: 'The brief said to drive slot 2, but docs/laws.md L8 says every slot is one shape, so I built it for all; B-9 logs the brief.' }), 0],
|
|
86
|
+
['an override citing design/shape.json without logging the brief', turn([W('src/slot/gain.cpp', slotCode)], { last: 'You asked for slot 2 only, but I built every slot instead: design/shape.json row "slot" is many(4).' }), 2],
|
|
87
|
+
['an override decided overnight under Decisions', turn([W('src/slot/gain.cpp', slotCode), W('docs/decisions.md', '## Decisions\n\n- D-3: no law covered the fade; chose 20 ms.\n')], { last: 'Overnight: the order did not name a fade, but no law covers it, so I decided it under Decisions (D-3) rather than what the brief said.' }), 0],
|
|
88
|
+
['the third send-back with the same findings ends the turn', (() => {
|
|
89
|
+
const s = 'loop';
|
|
90
|
+
turn([W('src/slot/gain.cpp', slotCode)], { making: '', session: s });
|
|
91
|
+
return sendBacks(s, { active: true });
|
|
92
|
+
})(), 0],
|
|
93
|
+
['the limit holds when each send-back comes as a new turn (no stop_hook_active; KWB-7)', (() => {
|
|
94
|
+
const s = 'loop-new-turns';
|
|
95
|
+
turn([W('src/slot/gain.cpp', slotCode)], { making: '', session: s });
|
|
96
|
+
return sendBacks(s);
|
|
97
|
+
})(), 0],
|
|
98
|
+
['a turn sent back is judged with what it wrote before the feedback', (() => {
|
|
99
|
+
const fb = { type: 'user', isMeta: true, message: { content: 'Stop hook feedback: making-check sent this turn back' } };
|
|
100
|
+
return turn([W('src/slot/gain.cpp', slotCode), [fb], [say('Done.')]], { making: '' });
|
|
101
|
+
})(), 2],
|
|
102
|
+
['a ";" inside the brackets of a shape ("slot (many, 4; slotId(i, field))", KWB-17)', turn([W('src/slot/gain.cpp', slotCode)], { making: 'making: one filter per slot; concepts: slot (many, 4; slotId(i, field)), mixer (one); reuse: slotFilter in src/slot/filter.cpp' }), 0],
|
|
103
|
+
['a note naming a concept the making line does not name (KWB-19)', turn([W('docs/notes.md', 'The mixer meter and its Status line.\n')]), 0],
|
|
104
|
+
['a brief in a notes folder naming a concept (KWB-19)', turn([W('notes/brief.md', '# Brief: the mixer, every slot\n')]), 0],
|
|
105
|
+
['source using a concept the making line does not name (KWB-19)', turn([W('src/mix/level.cpp', mixerCode)]), 2],
|
|
106
|
+
['mixer code with a making line naming the mixer', turn([W('src/mix/level.cpp', mixerCode)], { making: 'making: the mixer level; concepts: mixer (one); reuse: none' }), 0],
|
|
107
|
+
['what a turn landed is over (KF-34)', turn([W('src/mix/level.cpp', mixerCode), use('Bash', { command: 'git merge --ff-only work/s1' })]), 0],
|
|
108
|
+
['a write after the landing is judged (KF-34)', turn([use('Bash', { command: 'git merge --ff-only work/s1' }), W('src/mix/level.cpp', mixerCode)]), 2],
|
|
109
|
+
['the shape word the rule asks for is no concept (KF-24)', turn([W('src/mix/level.cpp', mixerCode)], { making: 'making: x; concepts: slot, many; mixer, one; reuse: none' }), 0],
|
|
110
|
+
];
|
|
111
|
+
return verdicts('making-check', cases);
|
|
112
|
+
}
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
// What a write repeats when no stretch of it is an exact copy (0.25.0). AI rarely copies exactly: it writes the same thing again with a line
|
|
2
|
+
// changed here and there, or makes a function the repo already has. Both are judged from each file's statements and definitions:
|
|
3
|
+
// fingerprint(text, ext) -> [[hash, line]] the statements long enough to mean something
|
|
4
|
+
// definesOf(text, ext) -> [[name, line]] the functions and classes defined at the top level
|
|
5
|
+
// nearCopy(added, others) -> { file, from, to, line, matched, of } | null: the place holding most of `added`, in order
|
|
6
|
+
import { createHash } from 'node:crypto';
|
|
7
|
+
import { statementsOf } from './code-shapes.mjs';
|
|
8
|
+
import { languageOf } from './languages.mjs';
|
|
9
|
+
|
|
10
|
+
const MIN_STATEMENT = 8; // tokens: a shorter statement has one shape in any file
|
|
11
|
+
const MIN_MATCHED = 8; // statements in order, in one place
|
|
12
|
+
const MIN_SHARE = 0.7; // of the statements in that stretch of the write
|
|
13
|
+
const COMMON = 0.04; // of the files: a statement this common says nothing
|
|
14
|
+
const CANDIDATES = 3;
|
|
15
|
+
|
|
16
|
+
const hashOf = (s) => createHash('sha1').update(s).digest('hex').slice(0, 10);
|
|
17
|
+
|
|
18
|
+
export function fingerprint(text, ext) {
|
|
19
|
+
const lang = languageOf(ext);
|
|
20
|
+
if (!lang) return [];
|
|
21
|
+
return statementsOf(text, lang).filter((s) => s.tokens.length >= MIN_STATEMENT).map((s) => [hashOf(s.shape), s.line]);
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export function definesOf(text, ext) {
|
|
25
|
+
const lang = languageOf(ext);
|
|
26
|
+
if (!lang?.define) return [];
|
|
27
|
+
const code = (lang.ownDefinitions ?? ((c) => c))(lang.blank(text));
|
|
28
|
+
return [...code.matchAll(lang.define)].map((m) => [m.slice(1).find(Boolean), code.slice(0, m.index).split('\n').length]).filter(([name]) => name);
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
// The longest common subsequence of two lists of hashes, as pairs of indexes.
|
|
32
|
+
function matchedPairs(a, b) {
|
|
33
|
+
const w = b.length + 1;
|
|
34
|
+
const t = new Uint16Array((a.length + 1) * w);
|
|
35
|
+
for (let i = a.length - 1; i >= 0; i -= 1) {
|
|
36
|
+
for (let j = b.length - 1; j >= 0; j -= 1) t[i * w + j] = a[i] === b[j] ? t[(i + 1) * w + j + 1] + 1 : Math.max(t[(i + 1) * w + j], t[i * w + j + 1]);
|
|
37
|
+
}
|
|
38
|
+
const out = [];
|
|
39
|
+
for (let i = 0, j = 0; i < a.length && j < b.length;) {
|
|
40
|
+
if (a[i] === b[j]) { out.push([i, j]); i += 1; j += 1; } else if (t[(i + 1) * w + j] >= t[i * w + j + 1]) i += 1; else j += 1;
|
|
41
|
+
}
|
|
42
|
+
return out;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
// The densest stretch of pairs: most of the statements on both sides are matched.
|
|
46
|
+
function densest(pairs) {
|
|
47
|
+
let best = null;
|
|
48
|
+
for (let s = 0; s < pairs.length; s += 1) {
|
|
49
|
+
for (let e = pairs.length - 1; e >= s + MIN_MATCHED - 1; e -= 1) {
|
|
50
|
+
const n = e - s + 1;
|
|
51
|
+
const spanA = pairs[e][0] - pairs[s][0] + 1;
|
|
52
|
+
const spanB = pairs[e][1] - pairs[s][1] + 1;
|
|
53
|
+
if (n / spanA >= MIN_SHARE && n / spanB >= MIN_SHARE) { if (!best || n > best.n) best = { s, e, n, spanA }; break; }
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
return best;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
// others: [{ file, st: [[hash, line]] }]. `added`: the statements this write adds, in order.
|
|
60
|
+
export function nearCopy(added, others) {
|
|
61
|
+
if (added.length < MIN_MATCHED) return null;
|
|
62
|
+
const seen = new Map();
|
|
63
|
+
for (const o of others) for (const h of new Set(o.st.map(([x]) => x))) seen.set(h, (seen.get(h) ?? 0) + 1);
|
|
64
|
+
const limit = Math.max(4, others.length * COMMON);
|
|
65
|
+
const rare = (list) => list.filter(([h]) => (seen.get(h) ?? 0) <= limit);
|
|
66
|
+
const mine = rare(added);
|
|
67
|
+
const wanted = new Set(mine.map(([h]) => h));
|
|
68
|
+
const ranked = others.map((o) => ({ o, hits: new Set(o.st.map(([h]) => h).filter((h) => wanted.has(h))).size })).filter((c) => c.hits >= MIN_MATCHED).sort((a, b) => b.hits - a.hits).slice(0, CANDIDATES);
|
|
69
|
+
for (const { o } of ranked) {
|
|
70
|
+
const theirs = rare(o.st);
|
|
71
|
+
const pairs = matchedPairs(mine.map(([h]) => h), theirs.map(([h]) => h));
|
|
72
|
+
const d = densest(pairs);
|
|
73
|
+
if (d) return { file: o.file, from: theirs[pairs[d.s][1]][1], to: theirs[pairs[d.e][1]][1], line: mine[pairs[d.s][0]][1], matched: d.n, of: d.spanA };
|
|
74
|
+
}
|
|
75
|
+
return null;
|
|
76
|
+
}
|
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
// program-read: a small reader of an inline program (python, node, perl, ruby) for program-writes.mjs (KWB-8). It never
|
|
2
|
+
// runs the program; it reads string literals, splits statements, and evaluates the simple expressions a file-writing
|
|
3
|
+
// program uses (a literal, a variable, Path(...) and joins, a file's text read, .replace chains, + of strings).
|
|
4
|
+
// scan(code, lang) -> { code, lits } code: the program with every literal replaced by \x01n\x02 and comments blanked;
|
|
5
|
+
// lits[n]: its text, or null when it interpolates (f-string, ${}, "$x")
|
|
6
|
+
// statements(code) -> [string] split at newlines and ; outside brackets
|
|
7
|
+
// splitArgs(text) -> [string] top-level comma split of a call's arguments
|
|
8
|
+
// closeOf(text, open) -> index the bracket that closes text[open]
|
|
9
|
+
// evaluate(expr, ctx) -> value | null value: { t: 'str'|'path', v }; ctx: { env, lang, at, readText }
|
|
10
|
+
const PAIRS = { '(': ')', '[': ']', '{': '}' };
|
|
11
|
+
|
|
12
|
+
function unescape(s, lang) {
|
|
13
|
+
return s.replace(/\\(\n|x[0-9a-fA-F]{2}|u[0-9a-fA-F]{4}|.)/gs, (m, e) => {
|
|
14
|
+
if (e === '\n') return '';
|
|
15
|
+
if (e[0] === 'x' && e.length === 3) return String.fromCharCode(parseInt(e.slice(1), 16));
|
|
16
|
+
if (e[0] === 'u' && e.length === 5) return String.fromCharCode(parseInt(e.slice(1), 16));
|
|
17
|
+
const map = { n: '\n', t: '\t', r: '\r', 0: '\0', '\\': '\\', "'": "'", '"': '"', '`': '`', $: '$' };
|
|
18
|
+
if (e in map) return map[e];
|
|
19
|
+
return lang === 'python' ? m : e;
|
|
20
|
+
});
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
export function scan(src, lang) {
|
|
24
|
+
const lits = [];
|
|
25
|
+
let out = '';
|
|
26
|
+
let i = 0;
|
|
27
|
+
const hash = lang !== 'node';
|
|
28
|
+
while (i < src.length) {
|
|
29
|
+
const c = src[i];
|
|
30
|
+
if ((hash && c === '#') || (!hash && c === '/' && src[i + 1] === '/')) {
|
|
31
|
+
while (i < src.length && src[i] !== '\n') i += 1;
|
|
32
|
+
continue;
|
|
33
|
+
}
|
|
34
|
+
if (!hash && c === '/' && src[i + 1] === '*') { const j = src.indexOf('*/', i + 2); i = j < 0 ? src.length : j + 2; continue; }
|
|
35
|
+
let pre = '';
|
|
36
|
+
if (lang === 'python') pre = src.slice(i).match(/^[rRbBuUfF]{0,2}(?=['"])/)?.[0] ?? '';
|
|
37
|
+
if (pre && /\w/.test(src[i - 1] ?? '')) pre = '';
|
|
38
|
+
const q0 = src[i + pre.length];
|
|
39
|
+
const quote = q0 === "'" || q0 === '"' || (q0 === '`' && lang === 'node') ? q0 : null;
|
|
40
|
+
if (!quote || (pre === '' && /\w/.test(src[i - 1] ?? '') && lang === 'python')) { out += c; i += 1; continue; }
|
|
41
|
+
const start = i + pre.length;
|
|
42
|
+
const triple = lang === 'python' && src.startsWith(quote.repeat(3), start);
|
|
43
|
+
const open = triple ? 3 : 1;
|
|
44
|
+
let j = start + open;
|
|
45
|
+
while (j < src.length && !(triple ? src.startsWith(quote.repeat(3), j) : src[j] === quote) && (triple || quote === '`' || src[j] !== '\n')) j += src[j] === '\\' ? 2 : 1;
|
|
46
|
+
const raw = src.slice(start + open, j);
|
|
47
|
+
i = Math.min(src.length, j + open);
|
|
48
|
+
const rawFlag = /[rR]/.test(pre);
|
|
49
|
+
let v;
|
|
50
|
+
if (/[fF]/.test(pre) && /[{}]/.test(raw)) v = null;
|
|
51
|
+
else if (quote === '`' && raw.includes('${')) v = null;
|
|
52
|
+
else if ((lang === 'perl' || lang === 'ruby') && quote === '"' && /[$@]|#\{/.test(raw)) v = null;
|
|
53
|
+
else if ((lang === 'perl' || lang === 'ruby') && quote === "'") v = raw.replace(/\\([\\'])/g, '$1');
|
|
54
|
+
else v = rawFlag ? raw : unescape(raw, lang);
|
|
55
|
+
out += `\x01${lits.length}\x02`;
|
|
56
|
+
lits.push(v);
|
|
57
|
+
}
|
|
58
|
+
return { code: out, lits };
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
export function closeOf(text, open) {
|
|
62
|
+
const want = PAIRS[text[open]];
|
|
63
|
+
let depth = 0;
|
|
64
|
+
for (let k = open; k < text.length; k += 1) {
|
|
65
|
+
if (PAIRS[text[k]]) depth += 1;
|
|
66
|
+
else if (')]}'.includes(text[k])) { depth -= 1; if (depth === 0) return text[k] === want ? k : -1; }
|
|
67
|
+
}
|
|
68
|
+
return -1;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
function splitTop(text, seps) {
|
|
72
|
+
const out = [];
|
|
73
|
+
let depth = 0;
|
|
74
|
+
let cur = '';
|
|
75
|
+
for (const c of text) {
|
|
76
|
+
if (PAIRS[c]) depth += 1;
|
|
77
|
+
else if (')]}'.includes(c)) depth -= 1;
|
|
78
|
+
if (depth <= 0 && seps.includes(c)) { out.push(cur); cur = ''; } else cur += c;
|
|
79
|
+
}
|
|
80
|
+
out.push(cur);
|
|
81
|
+
return out;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
export const statements = (code) => splitTop(code, '\n;').map((s) => s.trim()).filter(Boolean);
|
|
85
|
+
export const splitArgs = (text) => (text.trim() ? splitTop(text, ',').map((s) => s.trim()) : []);
|
|
86
|
+
|
|
87
|
+
// A postfix chain: a primary (a literal, a name, a parenthesised expression) and its .name, (args) and [index] steps.
|
|
88
|
+
function chain(expr) {
|
|
89
|
+
let k = 0;
|
|
90
|
+
let primary;
|
|
91
|
+
const lit = expr.match(/^\x01(\d+)\x02/);
|
|
92
|
+
const name = expr.match(/^[A-Za-z_$][\w$]*/);
|
|
93
|
+
if (lit) { primary = { lit: Number(lit[1]) }; k = lit[0].length; }
|
|
94
|
+
else if (expr[0] === '(') { const e = closeOf(expr, 0); if (e < 0) return null; primary = { group: expr.slice(1, e) }; k = e + 1; }
|
|
95
|
+
else if (name) { primary = { name: name[0] }; k = name[0].length; }
|
|
96
|
+
else return null;
|
|
97
|
+
const steps = [];
|
|
98
|
+
while (k < expr.length) {
|
|
99
|
+
const rest = expr.slice(k);
|
|
100
|
+
const dot = rest.match(/^\s*(?:\.|->|::)\s*([A-Za-z_$][\w$]*)/);
|
|
101
|
+
if (dot) { steps.push({ name: dot[1] }); k += dot[0].length; continue; }
|
|
102
|
+
const ws = rest.match(/^\s*/)[0].length;
|
|
103
|
+
if (rest[ws] === '(' || rest[ws] === '[') {
|
|
104
|
+
const e = closeOf(expr, k + ws);
|
|
105
|
+
if (e < 0) return null;
|
|
106
|
+
steps.push(rest[ws] === '(' ? { args: splitArgs(expr.slice(k + ws + 1, e)) } : { index: expr.slice(k + ws + 1, e) });
|
|
107
|
+
k = e + 1;
|
|
108
|
+
continue;
|
|
109
|
+
}
|
|
110
|
+
return null;
|
|
111
|
+
}
|
|
112
|
+
return { primary, steps };
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
const str = (v) => (v && (v.t === 'str' || v.t === 'path') ? v.v : null);
|
|
116
|
+
const joinPaths = (parts) => (parts.some((p) => p === null) ? null : parts.reduce((a, b) => (b.startsWith('/') ? b : a ? `${a.replace(/\/$/, '')}/${b}` : b), ''));
|
|
117
|
+
// A path made of a part the reader cannot work out (a helper's own parameter) is unknown, never a path of null (KF-40: read_text on one
|
|
118
|
+
// crashed sixteen hooks).
|
|
119
|
+
const pathOf = (v) => (v === null ? null : { t: 'path', v });
|
|
120
|
+
const PATH_FNS = /^(?:(?:pathlib\.)?(?:Pure)?(?:Posix)?Path|os\.path\.join|path\.join|path\.resolve|join|resolve|File\.join|os\.path\.expanduser|os\.path\.abspath|path\.normalize)$/;
|
|
121
|
+
const READS = /^(?:(?:fs|fsp|fs\.promises)\.)?readFileSync$|^File\.read$|^IO\.read$/;
|
|
122
|
+
|
|
123
|
+
export function evaluate(expr, ctx) {
|
|
124
|
+
const e = expr.trim().replace(/^await\s+/, '');
|
|
125
|
+
if (!e) return null;
|
|
126
|
+
const plus = splitTop(e, '+');
|
|
127
|
+
if (plus.length > 1 && ctx.lang !== 'perl') {
|
|
128
|
+
const vs = plus.map((p) => str(evaluate(p, ctx)));
|
|
129
|
+
return vs.some((v) => v === null) ? null : { t: 'str', v: vs.join('') };
|
|
130
|
+
}
|
|
131
|
+
if (ctx.lang === 'python') {
|
|
132
|
+
const slash = splitTop(e, '/');
|
|
133
|
+
if (slash.length > 1) {
|
|
134
|
+
const vs = slash.map((p) => evaluate(p, ctx));
|
|
135
|
+
return vs[0]?.t === 'path' ? pathOf(joinPaths(vs.map(str))) : null;
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
const c = chain(e);
|
|
139
|
+
if (!c) return null;
|
|
140
|
+
// callee: the dotted name while the chain is still a plain name (os.path.join, p.read_text); recv: the value before its last dot
|
|
141
|
+
let cur = null;
|
|
142
|
+
let callee = null;
|
|
143
|
+
let recv = null;
|
|
144
|
+
let method = null;
|
|
145
|
+
if (c.primary.lit !== undefined) cur = ctx.lits[c.primary.lit] === null ? null : { t: 'str', v: ctx.lits[c.primary.lit] };
|
|
146
|
+
else if (c.primary.group !== undefined) cur = evaluate(c.primary.group, ctx);
|
|
147
|
+
else { callee = c.primary.name; cur = ctx.env.get(callee) ?? null; }
|
|
148
|
+
for (const s of c.steps) {
|
|
149
|
+
if (s.name !== undefined) {
|
|
150
|
+
if (callee !== null) { recv = cur; callee = `${callee}.${s.name}`; cur = ctx.env.get(callee) ?? null; } else { method = s.name; }
|
|
151
|
+
continue;
|
|
152
|
+
}
|
|
153
|
+
if (s.args) {
|
|
154
|
+
if (callee !== null) {
|
|
155
|
+
const last = callee.split('.').pop();
|
|
156
|
+
cur = callFn(callee, s.args, ctx) ?? (recv && callee.includes('.') ? callMethod(recv, last, s.args, ctx) : null);
|
|
157
|
+
callee = null;
|
|
158
|
+
} else cur = method && cur ? callMethod(cur, method, s.args, ctx) : null;
|
|
159
|
+
method = null;
|
|
160
|
+
recv = null;
|
|
161
|
+
continue;
|
|
162
|
+
}
|
|
163
|
+
cur = null; callee = null; method = null;
|
|
164
|
+
}
|
|
165
|
+
return method ? null : cur;
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
function callFn(name, args, ctx) {
|
|
169
|
+
const vs = args.filter((a) => !/^\w+\s*=[^=]/.test(a)).map((a) => evaluate(a, ctx));
|
|
170
|
+
if (/(?:^|\.)Path\.home$/.test(name)) return process.env.HOME ? { t: 'path', v: process.env.HOME } : null;
|
|
171
|
+
if (/(?:^|\.)Path\.cwd$|^process\.cwd$|^os\.getcwd$/.test(name)) return { t: 'path', v: ctx.at('.') };
|
|
172
|
+
if (PATH_FNS.test(name)) return vs.length ? pathOf(joinPaths(vs.map(str))) : null;
|
|
173
|
+
if (READS.test(name) || /^(?:io\.|codecs\.)?open$/.test(name)) {
|
|
174
|
+
const p = str(vs[0]);
|
|
175
|
+
if (p === null) return null;
|
|
176
|
+
ctx.reads?.add(ctx.at(p));
|
|
177
|
+
return READS.test(name) ? { t: 'str', v: ctx.readText(ctx.at(p)) ?? '' } : { t: 'file', v: p };
|
|
178
|
+
}
|
|
179
|
+
return null;
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
function callMethod(base, m, args, ctx) {
|
|
183
|
+
const vs = args.map((a) => evaluate(a, ctx));
|
|
184
|
+
if (['expanduser', 'resolve', 'absolute'].includes(m)) return base.t === 'path' ? base : null;
|
|
185
|
+
if (m === 'joinpath') return pathOf(joinPaths([base.v, ...vs.map(str)]));
|
|
186
|
+
if ((m === 'read_text' && base.t === 'path') || (m === 'read' && base.t === 'file')) {
|
|
187
|
+
ctx.reads?.add(ctx.at(base.v));
|
|
188
|
+
return { t: 'str', v: ctx.readText(ctx.at(base.v)) ?? '' };
|
|
189
|
+
}
|
|
190
|
+
if ((m === 'replace' || m === 'replaceAll') && base.t === 'str') {
|
|
191
|
+
const [a, b] = vs.map(str);
|
|
192
|
+
if (a === null || b === null || /^\//.test(args[0] ?? '')) return null;
|
|
193
|
+
if (m === 'replace' && ctx.lang === 'node') return { t: 'str', v: base.v.replace(a, () => b) };
|
|
194
|
+
const n = vs[2] ? Number(str(vs[2]) ?? args[2]) : -1;
|
|
195
|
+
if (!(n < 0)) { let out = base.v; for (let k = 0; k < n && out.includes(a); k += 1) out = out.replace(a, () => b); return { t: 'str', v: out }; }
|
|
196
|
+
return { t: 'str', v: base.v.split(a).join(b) };
|
|
197
|
+
}
|
|
198
|
+
return null;
|
|
199
|
+
}
|