@nitra/cursor 1.13.82 → 1.13.83
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 +19 -0
- package/README.md +5 -5
- package/bin/n-cursor.js +16 -21
- package/package.json +1 -1
- package/rules/abie/abie.mdc +8 -8
- package/rules/abie/fix.mjs +15 -0
- package/rules/abie/policy/base_deployment_preem/base_deployment_preem.rego +2 -2
- package/rules/abie/policy/health_check_policy/health_check_policy.rego +2 -2
- package/rules/abie/policy/http_route_base/http_route_base.rego +1 -1
- package/rules/abie/utils/k8s-tree.mjs +1 -1
- package/rules/adr/adr.mdc +1 -1
- package/rules/adr/fix.mjs +15 -0
- package/rules/bun/fix.mjs +15 -0
- package/rules/capacitor/fix.mjs +15 -0
- package/rules/changelog/changelog.mdc +1 -1
- package/rules/changelog/fix.mjs +15 -0
- package/rules/ci4/fix.mjs +15 -0
- package/rules/docker/docker.mdc +3 -3
- package/rules/docker/fix.mjs +15 -0
- package/rules/docker/lint/lint.mjs +2 -2
- package/rules/efes/fix.mjs +15 -0
- package/rules/feedback/fix.mjs +15 -0
- package/rules/ga/fix.mjs +15 -0
- package/rules/ga/lint/lint.mjs +1 -1
- package/rules/graphql/fix.mjs +15 -0
- package/rules/graphql/{fix → js}/tooling/graphql-gql-scan.mjs +1 -1
- package/rules/hasura/fix.mjs +15 -0
- package/rules/hasura/policy/svc_hl/svc_hl.rego +1 -1
- package/rules/image-avif/fix.mjs +15 -0
- package/rules/image-compress/fix.mjs +15 -0
- package/rules/js-bun-db/fix.mjs +15 -0
- package/rules/js-bun-redis/fix.mjs +15 -0
- package/rules/js-bun-redis/policy/package_json/package_json.rego +1 -1
- package/rules/js-lint/fix.mjs +15 -0
- package/rules/js-lint/{fix → js}/tooling/check.mjs +3 -3
- package/rules/js-lint/{fix → js}/tooling/rebuild-oxlint-canonical.mjs +1 -1
- package/rules/js-lint/js-lint.mdc +2 -2
- package/rules/js-mssql/fix.mjs +15 -0
- package/rules/js-run/fix.mjs +15 -0
- package/rules/k8s/fix.mjs +15 -0
- package/rules/k8s/k8s.mdc +1 -1
- package/rules/nginx-default-tpl/fix.mjs +15 -0
- package/rules/nginx-default-tpl/{fix → js}/template/check.mjs +1 -1
- package/rules/npm-module/fix.mjs +15 -0
- package/rules/npm-module/{fix → js}/package_structure/check.mjs +1 -1
- package/rules/php/fix.mjs +15 -0
- package/rules/rego/fix.mjs +15 -0
- package/rules/security/fix.mjs +15 -0
- package/rules/security/security.mdc +2 -2
- package/rules/style-lint/fix.mjs +15 -0
- package/rules/tauri/fix.mjs +15 -0
- package/rules/test/fix.mjs +15 -0
- package/rules/test/test.mdc +1 -1
- package/rules/text/fix.mjs +15 -0
- package/rules/vue/fix.mjs +15 -0
- package/rules/vue/vue.mdc +1 -1
- package/scripts/auto-rules.mjs +3 -3
- package/scripts/sync-claude-config.mjs +2 -2
- package/scripts/utils/ast-scan-utils.mjs +3 -3
- package/scripts/utils/discover-checkable-rules.mjs +30 -18
- package/scripts/utils/list-rule-ids.mjs +23 -0
- package/scripts/utils/run-rule.mjs +7 -7
- package/scripts/utils/run-standard-rule.mjs +34 -0
- package/scripts/utils/walk-cache.mjs +24 -0
- package/scripts/utils/workspaces.mjs +1 -1
- /package/rules/abie/{fix → js}/applies/check.mjs +0 -0
- /package/rules/abie/{fix → js}/env_dns/check.mjs +0 -0
- /package/rules/abie/{fix → js}/firebase_hosting/check.mjs +0 -0
- /package/rules/abie/{fix → js}/hc_pairing/check.mjs +0 -0
- /package/rules/abie/{fix → js}/ua_http_route/check.mjs +0 -0
- /package/rules/abie/{fix → js}/ua_node_selector/check.mjs +0 -0
- /package/rules/adr/{fix → js}/hooks/check.mjs +0 -0
- /package/rules/adr/{fix → js}/hooks/template/.gitignore.snippet +0 -0
- /package/rules/bun/{fix → js}/layout/check.mjs +0 -0
- /package/rules/capacitor/{fix → js}/platforms/check.mjs +0 -0
- /package/rules/changelog/{fix → js}/consistency/check.mjs +0 -0
- /package/rules/changelog/{fix → js}/consistency/package-manifest.mjs +0 -0
- /package/rules/docker/{fix → js}/lint/check.mjs +0 -0
- /package/rules/docker/{fix → js}/lint/docker-hadolint.mjs +0 -0
- /package/rules/docker/{fix → js}/lint/docker-mirror.mjs +0 -0
- /package/rules/ga/{fix → js}/workflows/check.mjs +0 -0
- /package/rules/graphql/{fix → js}/tooling/check.mjs +0 -0
- /package/rules/hasura/{fix → js}/internal_urls/check.mjs +0 -0
- /package/rules/image-avif/{fix → js}/avif_generation/check.mjs +0 -0
- /package/rules/image-compress/{fix → js}/package_setup/check.mjs +0 -0
- /package/rules/js-bun-db/{fix → js}/safety/bun-sql-scan.mjs +0 -0
- /package/rules/js-bun-db/{fix → js}/safety/check.mjs +0 -0
- /package/rules/js-bun-redis/{fix → js}/imports/check.mjs +0 -0
- /package/rules/js-lint/{fix → js}/tooling/knip-canonical.json +0 -0
- /package/rules/js-lint/{fix → js}/tooling/oxlint-canonical-skeleton.json +0 -0
- /package/rules/js-lint/{fix → js}/tooling/oxlint-canonical.json +0 -0
- /package/rules/js-lint/{fix → js}/tooling/oxlint-rules.tsv +0 -0
- /package/rules/js-mssql/{fix → js}/deps/check.mjs +0 -0
- /package/rules/js-mssql/{fix → js}/deps/mssql-pool-scan.mjs +0 -0
- /package/rules/js-run/{fix → js}/runtime/bunyan-imports.mjs +0 -0
- /package/rules/js-run/{fix → js}/runtime/check-env-scan.mjs +0 -0
- /package/rules/js-run/{fix → js}/runtime/check.mjs +0 -0
- /package/rules/js-run/{fix → js}/runtime/conn-file-rules.mjs +0 -0
- /package/rules/js-run/{fix → js}/runtime/conn-imports-scan.mjs +0 -0
- /package/rules/js-run/{fix → js}/runtime/promise-settimeout-scan.mjs +0 -0
- /package/rules/k8s/{fix → js}/kubescape_exceptions/template/.kubescape-exceptions.json.snippet.json +0 -0
- /package/rules/k8s/{fix → js}/manifests/check.mjs +0 -0
- /package/rules/php/{fix → js}/tooling/check.mjs +0 -0
- /package/rules/rego/{fix → js}/applies/check.mjs +0 -0
- /package/rules/security/{fix → js}/sample_secret/check.mjs +0 -0
- /package/rules/security/{fix → js}/trufflehog/check.mjs +0 -0
- /package/rules/security/{fix → js}/trufflehog/template/.trufflehog-exclude.snippet.txt +0 -0
- /package/rules/style-lint/{fix → js}/tooling/check.mjs +0 -0
- /package/rules/tauri/{fix → js}/tooling/check.mjs +0 -0
- /package/rules/test/{fix → js}/location/check.mjs +0 -0
- /package/rules/text/{fix → js}/formatting/check.mjs +0 -0
- /package/rules/vue/{fix → js}/packages/check.mjs +0 -0
- /package/rules/vue/{fix → js}/packages/vue-forbidden-imports.mjs +0 -0
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
|
|
5
|
+
* @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
|
|
6
|
+
* @returns {Promise<number>} 0 — OK, 1 — порушення
|
|
7
|
+
*/
|
|
8
|
+
export function run(ctx) {
|
|
9
|
+
return runStandardRule(import.meta.dirname, ctx)
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
if (import.meta.main) {
|
|
13
|
+
// eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
|
|
14
|
+
process.exit(await run())
|
|
15
|
+
}
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
# Канон надходить через --data: { "template": { "deny": ... } }
|
|
4
4
|
# Структура --data сформована з template/package.json.deny.json.
|
|
5
5
|
# AST-скан коду (`import`/`require`/dynamic `import()` тих самих пакетів)
|
|
6
|
-
# лишається у `js-bun-redis/
|
|
6
|
+
# лишається у `js-bun-redis/js/imports/check.mjs`.
|
|
7
7
|
package js_bun_redis.package_json
|
|
8
8
|
|
|
9
9
|
import rego.v1
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
|
|
5
|
+
* @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
|
|
6
|
+
* @returns {Promise<number>} 0 — OK, 1 — порушення
|
|
7
|
+
*/
|
|
8
|
+
export function run(ctx) {
|
|
9
|
+
return runStandardRule(import.meta.dirname, ctx)
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
if (import.meta.main) {
|
|
13
|
+
// eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
|
|
14
|
+
process.exit(await run())
|
|
15
|
+
}
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
* Перевіряє лінт JavaScript за правилом js-lint.mdc.
|
|
3
3
|
*
|
|
4
4
|
* Flat ESLint з getConfig і ignore для auto-imports,
|
|
5
|
-
* `.oxlintrc.json` має збігатися з каноном oxlint у пакеті (`npm/rules/js-lint/
|
|
5
|
+
* `.oxlintrc.json` має збігатися з каноном oxlint у пакеті (`npm/rules/js-lint/js/tooling/oxlint-canonical.json`):
|
|
6
6
|
* plugins, jsPlugins, categories, усі правила з канону (додаткові записи в `rules` дозволені), settings, env,
|
|
7
7
|
* globals, ignorePatterns. Також перевіряє workspace `package.json` на `type: "module"`
|
|
8
8
|
* і `engines`, workflow-дубль у `lint.yml`, `knip.json` autofill і застарілі `.eslintrc*`.
|
|
@@ -154,7 +154,7 @@ export function verifyOxlintRcAgainstCanonical(cfg, canonical) {
|
|
|
154
154
|
|
|
155
155
|
if (!deepEqualOxlintCanonical(actual, expected)) {
|
|
156
156
|
failures.push(
|
|
157
|
-
`.oxlintrc.json: поле "${key}" має збігатися з каноном пакета @nitra/cursor (npm/rules/js-lint/
|
|
157
|
+
`.oxlintrc.json: поле "${key}" має збігатися з каноном пакета @nitra/cursor (npm/rules/js-lint/js/tooling/oxlint-canonical.json)`
|
|
158
158
|
)
|
|
159
159
|
}
|
|
160
160
|
}
|
|
@@ -384,7 +384,7 @@ async function checkKnipConfig(passFn, failFn) {
|
|
|
384
384
|
return
|
|
385
385
|
}
|
|
386
386
|
await copyFile(KNIP_CANONICAL_JSON_PATH, 'knip.json')
|
|
387
|
-
passFn('knip.json створено з канонічного npm/rules/js-lint/
|
|
387
|
+
passFn('knip.json створено з канонічного npm/rules/js-lint/js/tooling/knip-canonical.json (js-lint.mdc)')
|
|
388
388
|
}
|
|
389
389
|
|
|
390
390
|
/**
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
* Збирає `oxlint-canonical.json` з `oxlint-canonical-skeleton.json` (без поля rules) та списку
|
|
3
3
|
* правил у `oxlint-rules.tsv` (колонки: ім’я правила, TAB, severity: deny | off | error).
|
|
4
4
|
*
|
|
5
|
-
* Після змін у TSV або скелеті запускай з каталогу пакета: `bun ./rules/js-lint/
|
|
5
|
+
* Після змін у TSV або скелеті запускай з каталогу пакета: `bun ./rules/js-lint/js/tooling/rebuild-oxlint-canonical.mjs`,
|
|
6
6
|
* потім скопіюй оновлений канон у корінь споживача як `.oxlintrc.json` за потреби.
|
|
7
7
|
*/
|
|
8
8
|
import { readFileSync, writeFileSync } from 'node:fs'
|
|
@@ -25,7 +25,7 @@ version: '1.23'
|
|
|
25
25
|
|
|
26
26
|
У `.vscode/extensions.json` `recommendations` мають містити `dbaeumer.vscode-eslint`, `github.vscode-github-actions`, `oxc.oxc-vscode`: [extensions.json.snippet.json](./policy/vscode_extensions/template/extensions.json.snippet.json)
|
|
27
27
|
|
|
28
|
-
У корені має бути **`.oxlintrc.json`**, який **збігається з каноном** oxlint з пакета **`@nitra/cursor`**: файл **`npm/rules/js-lint/
|
|
28
|
+
У корені має бути **`.oxlintrc.json`**, який **збігається з каноном** oxlint з пакета **`@nitra/cursor`**: файл **`npm/rules/js-lint/js/tooling/oxlint-canonical.json`** (plugins, jsPlugins з **`@e18e/eslint-plugin`**, categories, повний набір **rules** із канону — додаткові записи в **`rules`** дозволені; також **`settings`**, **`env`**, **`globals`**). Поле **`ignorePatterns`** працює як **`rules`**: канонічні патерни з **`oxlint-canonical.json`** (наразі **`**/schema.graphql`**, **`**/auto-imports.d.ts`**) мають бути присутні, додаткові локальні glob-и дозволені. Оновити канон можна з репозиторію пакета або скопіювавши файл після **`bun ./rules/js-lint/js/tooling/rebuild-oxlint-canonical.mjs`** (джерело правил — **`oxlint-rules.tsv`** + скелет **`oxlint-canonical-skeleton.json`**). Модуль **`@e18e/eslint-plugin`** не оголошуй окремо в **`package.json`** — він уже в залежностях **`@nitra/eslint-config`** (з **3.8.0**), oxlint підвантажує його з **`node_modules`**.
|
|
29
29
|
|
|
30
30
|
Мінімум для розуміння структури (реальний корінь конфігу має збігатися з каноном повністю):
|
|
31
31
|
|
|
@@ -62,7 +62,7 @@ version: '1.23'
|
|
|
62
62
|
|
|
63
63
|
Перевірку невикористаних залежностей і експортів виконує **knip** (заміна `depcheck`). Викликається у скрипті `lint-js` і в CI разом з oxlint/eslint/jscpd — окремий крок у CI не потрібен.
|
|
64
64
|
|
|
65
|
-
У корені проєкту має бути **`knip.json`**, який стартує з канонічного baseline з пакета `@nitra/cursor` — файл [`npm/rules/js-lint/
|
|
65
|
+
У корені проєкту має бути **`knip.json`**, який стартує з канонічного baseline з пакета `@nitra/cursor` — файл [`npm/rules/js-lint/js/tooling/knip-canonical.json`](./js/tooling/knip-canonical.json). Він покриває типові false-positives для наших правил: `entry` зі CLI-конфігами (eslint, stylelint, oxlint, jscpd, markdownlint-cli2, `commitlint`), `project` для `**/*.{js,mjs,cjs,jsx,ts,tsx,mts,cts}`, `ignore` для `**/__fixtures__/**`, `ignoreDependencies` для пакетів, посилання на які є лише в не-JS-конфігах (`@nitra/cspell-dict`, `/@cspell\/dict-.+/`), і `ignoreBinaries` для CLI, які канон вимагає викликати через `npx`/`bunx` і яких заборонено додавати в `devDependencies` (`actionlint`, `cspell`, `depcheck`, `eslint`, `git-ai`, `jscpd`, `markdownlint-cli2`, `oxfmt`, `oxlint`, `shellcheck`, `uvx`, `v8r`, `zizmor`).
|
|
66
66
|
|
|
67
67
|
Якщо `knip.json` відсутній — `npx @nitra/cursor check js-lint` копіює канон у корінь проєкту (side effect). Після створення модифікуй файл під свій проєкт як завгодно: перевіряємо лише наявність, зміст подальших змін не валідується.
|
|
68
68
|
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
|
|
5
|
+
* @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
|
|
6
|
+
* @returns {Promise<number>} 0 — OK, 1 — порушення
|
|
7
|
+
*/
|
|
8
|
+
export function run(ctx) {
|
|
9
|
+
return runStandardRule(import.meta.dirname, ctx)
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
if (import.meta.main) {
|
|
13
|
+
// eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
|
|
14
|
+
process.exit(await run())
|
|
15
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
|
|
5
|
+
* @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
|
|
6
|
+
* @returns {Promise<number>} 0 — OK, 1 — порушення
|
|
7
|
+
*/
|
|
8
|
+
export function run(ctx) {
|
|
9
|
+
return runStandardRule(import.meta.dirname, ctx)
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
if (import.meta.main) {
|
|
13
|
+
// eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
|
|
14
|
+
process.exit(await run())
|
|
15
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
|
|
5
|
+
* @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
|
|
6
|
+
* @returns {Promise<number>} 0 — OK, 1 — порушення
|
|
7
|
+
*/
|
|
8
|
+
export function run(ctx) {
|
|
9
|
+
return runStandardRule(import.meta.dirname, ctx)
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
if (import.meta.main) {
|
|
13
|
+
// eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
|
|
14
|
+
process.exit(await run())
|
|
15
|
+
}
|
package/rules/k8s/k8s.mdc
CHANGED
|
@@ -39,7 +39,7 @@ alwaysApply: false
|
|
|
39
39
|
|
|
40
40
|
Якщо в **корені проєкту** є файл **`.kubescape-exceptions.json`** — `lint-k8s` автоматично передає його в `kubescape scan` через **`--exceptions`** ([postureExceptionPolicy](https://github.com/kubescape/kubescape/blob/master/docs/exceptions.md)). Файл — JSON-масив об'єктів з полями `name`, `policyType: "postureExceptionPolicy"`, `actions` (`["alertOnly"]` — знижує fail до alert, не блокує lint), `resources` (resource designator) і `posturePolicies` (масив `controlID`).
|
|
41
41
|
|
|
42
|
-
Канонічний кейс — **C-0012** (`Applications credentials in configuration files`, High): control тригериться на **імʼя** env, що містить підрядок `secret`/`password`/`key`/`token`, а **не** на значення. Для `HASURA_GRAPHQL_JWT_SECRET` у ConfigMap значення — публічний JWT-конфіг (`jwk_url`, `issuer`), не credentials, але kubescape падає лише через імʼя. Точкове виключення для ConfigMap із цим env — канон: [.kubescape-exceptions.json.snippet.json](./
|
|
42
|
+
Канонічний кейс — **C-0012** (`Applications credentials in configuration files`, High): control тригериться на **імʼя** env, що містить підрядок `secret`/`password`/`key`/`token`, а **не** на значення. Для `HASURA_GRAPHQL_JWT_SECRET` у ConfigMap значення — публічний JWT-конфіг (`jwk_url`, `issuer`), не credentials, але kubescape падає лише через імʼя. Точкове виключення для ConfigMap із цим env — канон: [.kubescape-exceptions.json.snippet.json](./js/kubescape_exceptions/template/.kubescape-exceptions.json.snippet.json)
|
|
43
43
|
|
|
44
44
|
Підстав свою `attributes.name` (рядок або regex), якщо ConfigMap зветься інакше; виключай контрольно, а не глобально (не додавай винятки без `attributes.name`/`labels`, бо тоді C-0012 знімається для усіх ConfigMap-ів проєкту і реальні витоки credentials теж пройдуть).
|
|
45
45
|
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
|
|
5
|
+
* @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
|
|
6
|
+
* @returns {Promise<number>} 0 — OK, 1 — порушення
|
|
7
|
+
*/
|
|
8
|
+
export function run(ctx) {
|
|
9
|
+
return runStandardRule(import.meta.dirname, ctx)
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
if (import.meta.main) {
|
|
13
|
+
// eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
|
|
14
|
+
process.exit(await run())
|
|
15
|
+
}
|
|
@@ -17,7 +17,7 @@ import { existsSync } from 'node:fs'
|
|
|
17
17
|
import { readdir, readFile, rename, unlink, writeFile } from 'node:fs/promises'
|
|
18
18
|
import { basename, dirname, join, relative } from 'node:path'
|
|
19
19
|
|
|
20
|
-
import { findDockerfilePaths } from '../../../docker/
|
|
20
|
+
import { findDockerfilePaths } from '../../../docker/js/lint/check.mjs'
|
|
21
21
|
import { createCheckReporter } from '../../../../scripts/utils/check-reporter.mjs'
|
|
22
22
|
import { loadCursorIgnorePaths } from '../../../../scripts/utils/load-cursor-config.mjs'
|
|
23
23
|
import { runConftestBatch } from '../../../../scripts/utils/run-conftest-batch.mjs'
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
|
|
5
|
+
* @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
|
|
6
|
+
* @returns {Promise<number>} 0 — OK, 1 — порушення
|
|
7
|
+
*/
|
|
8
|
+
export function run(ctx) {
|
|
9
|
+
return runStandardRule(import.meta.dirname, ctx)
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
if (import.meta.main) {
|
|
13
|
+
// eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
|
|
14
|
+
process.exit(await run())
|
|
15
|
+
}
|
|
@@ -457,7 +457,7 @@ export function findTestFrameworkImport(content, virtualPath) {
|
|
|
457
457
|
* Carve-out: для шляху `rules/<rule-name>/...` сегмент `<rule-name>` (індекс 1)
|
|
458
458
|
* — це ім'я правила, а не каталог. Зокрема, правило з id `test` (або `tests`)
|
|
459
459
|
* описує конвенцію розміщення тестів і саме по собі не є test-fixture'ом.
|
|
460
|
-
* Подальші сегменти (наприклад, `rules/<r>/
|
|
460
|
+
* Подальші сегменти (наприклад, `rules/<r>/js/<c>/tests/`) продовжують перевірятись.
|
|
461
461
|
* @param {string} relPath posix-шлях відносно `npm/`
|
|
462
462
|
* @returns {Promise<string | null>} причина порушення або `null`
|
|
463
463
|
*/
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
|
|
5
|
+
* @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
|
|
6
|
+
* @returns {Promise<number>} 0 — OK, 1 — порушення
|
|
7
|
+
*/
|
|
8
|
+
export function run(ctx) {
|
|
9
|
+
return runStandardRule(import.meta.dirname, ctx)
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
if (import.meta.main) {
|
|
13
|
+
// eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
|
|
14
|
+
process.exit(await run())
|
|
15
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
|
|
5
|
+
* @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
|
|
6
|
+
* @returns {Promise<number>} 0 — OK, 1 — порушення
|
|
7
|
+
*/
|
|
8
|
+
export function run(ctx) {
|
|
9
|
+
return runStandardRule(import.meta.dirname, ctx)
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
if (import.meta.main) {
|
|
13
|
+
// eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
|
|
14
|
+
process.exit(await run())
|
|
15
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
|
|
5
|
+
* @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
|
|
6
|
+
* @returns {Promise<number>} 0 — OK, 1 — порушення
|
|
7
|
+
*/
|
|
8
|
+
export function run(ctx) {
|
|
9
|
+
return runStandardRule(import.meta.dirname, ctx)
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
if (import.meta.main) {
|
|
13
|
+
// eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
|
|
14
|
+
process.exit(await run())
|
|
15
|
+
}
|
|
@@ -24,7 +24,7 @@ version: '2.1'
|
|
|
24
24
|
|
|
25
25
|
## `.trufflehog-exclude` (рекомендована основа)
|
|
26
26
|
|
|
27
|
-
Канон (допускає розширення): [.trufflehog-exclude.snippet.txt](./
|
|
27
|
+
Канон (допускає розширення): [.trufflehog-exclude.snippet.txt](./js/trufflehog/template/.trufflehog-exclude.snippet.txt)
|
|
28
28
|
|
|
29
29
|
**Важливо:** один regex-pattern на рядок, без TOML-обгортки; коментарі починаються з `#`.
|
|
30
30
|
|
|
@@ -45,7 +45,7 @@ Workflow обовʼязковий — забезпечує незалежний
|
|
|
45
45
|
- Правильно: `DB_PASSWORD=sample-secret`, `password: "sample-secret"`
|
|
46
46
|
- Неправильно: `DB_PASSWORD=secret`, `password: "secret"`
|
|
47
47
|
|
|
48
|
-
Перевіряється лише `secret` у позиції значення (після `=`, `:`, `=>`); імена ключів на кшталт `client_secret` не чіпаються. Concern `security.sample_secret` — деталі скану в `
|
|
48
|
+
Перевіряється лише `secret` у позиції значення (після `=`, `:`, `=>`); імена ключів на кшталт `client_secret` не чіпаються. Concern `security.sample_secret` — деталі скану в `js/sample_secret/check.mjs`.
|
|
49
49
|
|
|
50
50
|
## Перевірка
|
|
51
51
|
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
|
|
5
|
+
* @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
|
|
6
|
+
* @returns {Promise<number>} 0 — OK, 1 — порушення
|
|
7
|
+
*/
|
|
8
|
+
export function run(ctx) {
|
|
9
|
+
return runStandardRule(import.meta.dirname, ctx)
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
if (import.meta.main) {
|
|
13
|
+
// eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
|
|
14
|
+
process.exit(await run())
|
|
15
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
|
|
5
|
+
* @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
|
|
6
|
+
* @returns {Promise<number>} 0 — OK, 1 — порушення
|
|
7
|
+
*/
|
|
8
|
+
export function run(ctx) {
|
|
9
|
+
return runStandardRule(import.meta.dirname, ctx)
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
if (import.meta.main) {
|
|
13
|
+
// eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
|
|
14
|
+
process.exit(await run())
|
|
15
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
|
|
5
|
+
* @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
|
|
6
|
+
* @returns {Promise<number>} 0 — OK, 1 — порушення
|
|
7
|
+
*/
|
|
8
|
+
export function run(ctx) {
|
|
9
|
+
return runStandardRule(import.meta.dirname, ctx)
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
if (import.meta.main) {
|
|
13
|
+
// eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
|
|
14
|
+
process.exit(await run())
|
|
15
|
+
}
|
package/rules/test/test.mdc
CHANGED
|
@@ -9,7 +9,7 @@ alwaysApply: true
|
|
|
9
9
|
JS-тести у пакеті лежать у **піддиректорії `tests/`** поряд із кодом, який тестується, а **не безпосередньо біля джерельного файлу**.
|
|
10
10
|
|
|
11
11
|
```
|
|
12
|
-
rules/foo/
|
|
12
|
+
rules/foo/js/bar/
|
|
13
13
|
├── check.mjs ← JS-джерело
|
|
14
14
|
└── tests/
|
|
15
15
|
└── check.test.mjs ← тест check.mjs
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
|
|
5
|
+
* @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
|
|
6
|
+
* @returns {Promise<number>} 0 — OK, 1 — порушення
|
|
7
|
+
*/
|
|
8
|
+
export function run(ctx) {
|
|
9
|
+
return runStandardRule(import.meta.dirname, ctx)
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
if (import.meta.main) {
|
|
13
|
+
// eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
|
|
14
|
+
process.exit(await run())
|
|
15
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { runStandardRule } from '../../scripts/utils/run-standard-rule.mjs'
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Запускає правило: applies → JS-concerns → policy → mdc-refs (через runStandardRule).
|
|
5
|
+
* @param {import('../../scripts/utils/run-standard-rule.mjs').RuleContext} [ctx] контекст прогону (walkCache тощо)
|
|
6
|
+
* @returns {Promise<number>} 0 — OK, 1 — порушення
|
|
7
|
+
*/
|
|
8
|
+
export function run(ctx) {
|
|
9
|
+
return runStandardRule(import.meta.dirname, ctx)
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
if (import.meta.main) {
|
|
13
|
+
// eslint-disable-next-line unicorn/no-process-exit -- standalone entry-point має повертати exit-code для CI/IDE
|
|
14
|
+
process.exit(await run())
|
|
15
|
+
}
|
package/rules/vue/vue.mdc
CHANGED
|
@@ -341,4 +341,4 @@ import path from 'node:path'
|
|
|
341
341
|
|
|
342
342
|
## Перевірка
|
|
343
343
|
|
|
344
|
-
`npx @nitra/cursor check vue` — перевіряє залежності, `vite.config`, наявність **`src/vite-env.d.ts`** з `/// <reference types="vite/client" />` та **`jsconfig.json`** у корені Vue-пакета; обходить джерела Vue-пакета (`.vue`, `.ts`, `.js` тощо) на заборонені value-імпорти з модуля `vue` (дозволені лише type-only та side-effect `import 'vue'`) і додатково сканує `.vue` SFC на імпорти Node-нативних модулів (`node:*` префікс або bare-ім’я вбудованого модуля Node — `fs`, `path`, `timers/promises` тощо). Імпорти аналізуються через **oxc-parser** (`module.staticImports`); для `.vue` вміст `<script>` витягується з SFC, далі той самий парсер (логіка в `npm/rules/vue/
|
|
344
|
+
`npx @nitra/cursor check vue` — перевіряє залежності, `vite.config`, наявність **`src/vite-env.d.ts`** з `/// <reference types="vite/client" />` та **`jsconfig.json`** у корені Vue-пакета; обходить джерела Vue-пакета (`.vue`, `.ts`, `.js` тощо) на заборонені value-імпорти з модуля `vue` (дозволені лише type-only та side-effect `import 'vue'`) і додатково сканує `.vue` SFC на імпорти Node-нативних модулів (`node:*` префікс або bare-ім’я вбудованого модуля Node — `fs`, `path`, `timers/promises` тощо). Імпорти аналізуються через **oxc-parser** (`module.staticImports`); для `.vue` вміст `<script>` витягується з SFC, далі той самий парсер (логіка в `npm/rules/vue/js/packages/vue-forbidden-imports.mjs`).
|
package/scripts/auto-rules.mjs
CHANGED
|
@@ -16,13 +16,13 @@ import { existsSync } from 'node:fs'
|
|
|
16
16
|
import { readdir, readFile } from 'node:fs/promises'
|
|
17
17
|
import { basename, join, relative } from 'node:path'
|
|
18
18
|
|
|
19
|
-
import { textHasBunSqlImport } from '../rules/js-bun-db/
|
|
19
|
+
import { textHasBunSqlImport } from '../rules/js-bun-db/js/safety/bun-sql-scan.mjs'
|
|
20
20
|
import {
|
|
21
21
|
isGqlScanSourceFile,
|
|
22
22
|
shouldSkipFileForGqlScan,
|
|
23
23
|
sourceFileHasGqlTaggedTemplate
|
|
24
|
-
} from '../rules/graphql/
|
|
25
|
-
import { contentForVueImportScan } from '../rules/vue/
|
|
24
|
+
} from '../rules/graphql/js/tooling/graphql-gql-scan.mjs'
|
|
25
|
+
import { contentForVueImportScan } from '../rules/vue/js/packages/vue-forbidden-imports.mjs'
|
|
26
26
|
|
|
27
27
|
/** Порядок автододавання правил відповідно до `rules/<rule>/auto.md`. */
|
|
28
28
|
export const AUTO_RULE_ORDER = Object.freeze([
|
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
* - `.cursor/hooks.json` — **merge**: користувацькі hooks зберігаються; ADR stop
|
|
20
20
|
* entries додаються, коли правило `adr` увімкнене, і видаляються, коли вимкнене.
|
|
21
21
|
* - `.gitignore` — **merge** (лише з `adr`): дописує відсутні рядки з канонічного
|
|
22
|
-
* фрагмента `rules/adr/
|
|
22
|
+
* фрагмента `rules/adr/js/hooks/template/.gitignore.snippet` (`node_modules/`, `dist/`,
|
|
23
23
|
* `*.secret`, логи capture/normalize, `.normalize-state`, `.normalize.lock`); існуючі
|
|
24
24
|
* рядки не перезаписуються.
|
|
25
25
|
*
|
|
@@ -56,7 +56,7 @@ const ADR_HOOK_SCRIPT_NAME = 'capture-decisions.sh'
|
|
|
56
56
|
const ADR_NORMALIZE_HOOK_SCRIPT_NAME = 'normalize-decisions.sh'
|
|
57
57
|
const TEMPLATE_DIR_NAME = '.claude-template'
|
|
58
58
|
/** Відносний шлях до канонічного фрагмента `.gitignore` для ADR Stop-hook'ів у tarball пакета. */
|
|
59
|
-
export const ADR_GITIGNORE_SNIPPET_REL = 'rules/adr/
|
|
59
|
+
export const ADR_GITIGNORE_SNIPPET_REL = 'rules/adr/js/hooks/template/.gitignore.snippet'
|
|
60
60
|
const GITIGNORE_FILE = '.gitignore'
|
|
61
61
|
const EOL_RE = /\r?\n/u
|
|
62
62
|
|
|
@@ -5,9 +5,9 @@
|
|
|
5
5
|
* розпізнавання типових вузлів (функцій, `*.join(...)`),
|
|
6
6
|
* робота з `TemplateLiteral` (текст quasis, контекст SQL-списку).
|
|
7
7
|
*
|
|
8
|
-
* Використовується сканерами у `rules/<rule>/
|
|
9
|
-
* `rules/js-bun-db/
|
|
10
|
-
* `rules/js-run/
|
|
8
|
+
* Використовується сканерами у `rules/<rule>/js/...` (наприклад,
|
|
9
|
+
* `rules/js-bun-db/js/safety/bun-sql-scan.mjs`, `rules/js-mssql/js/deps/mssql-pool-scan.mjs`,
|
|
10
|
+
* `rules/js-run/js/runtime/*-scan.mjs`) для уникнення дублювання boilerplate.
|
|
11
11
|
*/
|
|
12
12
|
import { parseSync } from 'oxc-parser'
|
|
13
13
|
|
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Discovery rules для CLI `check`. Шукає правила, для яких є щось «прогонне»:
|
|
3
|
-
* - JS concerns: `rules/<id>/
|
|
3
|
+
* - JS concerns: `rules/<id>/js/<concern>/<check.mjs | check-*.mjs>` — кожен concern окремий вузол.
|
|
4
4
|
* - Policy concerns: `rules/<id>/policy/<concern>/target.json` — пара з `<concern>.rego`.
|
|
5
5
|
*
|
|
6
|
-
* Каталог `
|
|
6
|
+
* Каталог `js/utils/` свідомо пропускається — це хелпери, не концерни.
|
|
7
7
|
* Файли `*.test.mjs` фільтруються regex (`^check(?:-.+)?\.mjs$`).
|
|
8
8
|
*
|
|
9
9
|
* Намеренно НЕ парсимо `target.json` тут (це робить runner). Discovery — швидкий скан структури:
|
|
10
10
|
* шляхи + назви, без I/O вмісту.
|
|
11
11
|
*
|
|
12
|
-
* Історичний контекст:
|
|
13
|
-
*
|
|
14
|
-
*
|
|
12
|
+
* Історичний контекст: convention пройшла еволюцію `js/` (до 1.11.12) → `fix/` (1.11.10–1.13.79)
|
|
13
|
+
* → знову `js/` (1.13.80+, після появи кореневого `fix.mjs` як entry-point правила, щоб не плутати
|
|
14
|
+
* з папкою `fix/`). Convention тепер за технологією: `js/` ↔ `policy/`.
|
|
15
15
|
*/
|
|
16
16
|
import { existsSync } from 'node:fs'
|
|
17
17
|
import { readdir } from 'node:fs/promises'
|
|
@@ -22,7 +22,7 @@ const TEST_SUFFIX = '.test.mjs'
|
|
|
22
22
|
|
|
23
23
|
/**
|
|
24
24
|
* @typedef {object} JsConcern
|
|
25
|
-
* @property {string} name імʼя концерну (`<name>` у `
|
|
25
|
+
* @property {string} name імʼя концерну (`<name>` у `js/<name>/`)
|
|
26
26
|
* @property {string[]} files імена `check*.mjs` у концерні (відсортовані алфавітно)
|
|
27
27
|
*/
|
|
28
28
|
|
|
@@ -39,21 +39,21 @@ const TEST_SUFFIX = '.test.mjs'
|
|
|
39
39
|
*/
|
|
40
40
|
|
|
41
41
|
/**
|
|
42
|
-
* Перелічує JS-концерни одного правила: підкаталоги `
|
|
42
|
+
* Перелічує JS-концерни одного правила: підкаталоги `js/<name>/` з принаймні одним `check*.mjs`.
|
|
43
43
|
*
|
|
44
|
-
* `
|
|
45
|
-
* @param {string}
|
|
44
|
+
* `js/utils/` свідомо пропускається — це хелпери, а не концерни.
|
|
45
|
+
* @param {string} jsDir абсолютний шлях `rules/<id>/js/`
|
|
46
46
|
* @returns {Promise<JsConcern[]>} концерни в алфавітному порядку
|
|
47
47
|
*/
|
|
48
|
-
async function listJsConcerns(
|
|
49
|
-
if (!existsSync(
|
|
50
|
-
const topLevel = await readdir(
|
|
48
|
+
async function listJsConcerns(jsDir) {
|
|
49
|
+
if (!existsSync(jsDir)) return []
|
|
50
|
+
const topLevel = await readdir(jsDir, { withFileTypes: true })
|
|
51
51
|
|
|
52
52
|
/** @type {JsConcern[]} */
|
|
53
53
|
const concerns = []
|
|
54
54
|
for (const entry of topLevel) {
|
|
55
55
|
if (!entry.isDirectory() || entry.name === 'utils' || entry.name.startsWith('.')) continue
|
|
56
|
-
const concernDir = join(
|
|
56
|
+
const concernDir = join(jsDir, entry.name)
|
|
57
57
|
const dirContents = await readdir(concernDir)
|
|
58
58
|
const files = dirContents
|
|
59
59
|
.filter(n => CHECK_FILENAME_RE.test(n) && !n.endsWith(TEST_SUFFIX))
|
|
@@ -86,7 +86,20 @@ async function listPolicyConcerns(policyDir) {
|
|
|
86
86
|
}
|
|
87
87
|
|
|
88
88
|
/**
|
|
89
|
-
*
|
|
89
|
+
* Будує `CheckableRule` для одного каталогу правила (без enumeration по `rules/`).
|
|
90
|
+
* Використовується `runStandardRule` для per-rule entry-point flow.
|
|
91
|
+
* @param {string} ruleDir абсолютний шлях `rules/<id>/`
|
|
92
|
+
* @param {string} ruleId id правила (= basename(ruleDir))
|
|
93
|
+
* @returns {Promise<CheckableRule>} опис правила (jsConcerns + policyConcerns)
|
|
94
|
+
*/
|
|
95
|
+
export async function discoverOneRule(ruleDir, ruleId) {
|
|
96
|
+
const jsConcerns = await listJsConcerns(join(ruleDir, 'js'))
|
|
97
|
+
const policyConcerns = await listPolicyConcerns(join(ruleDir, 'policy'))
|
|
98
|
+
return { id: ruleId, jsConcerns, policyConcerns }
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/**
|
|
102
|
+
* Сканує `rules/` і повертає правила, для яких є JS-концерни (у `js/`) або policy-концерни
|
|
90
103
|
* (у `policy/`). Правила без жодної прогонної частини (тільки `.mdc` + `auto.md`) фільтруються.
|
|
91
104
|
* @param {string} bundledRulesDir абсолютний шлях до `npm/rules/`
|
|
92
105
|
* @returns {Promise<CheckableRule[]>} відсортовані за id
|
|
@@ -99,10 +112,9 @@ export async function discoverCheckableRules(bundledRulesDir) {
|
|
|
99
112
|
for (const entry of entries) {
|
|
100
113
|
if (!entry.isDirectory() || entry.name.startsWith('.')) continue
|
|
101
114
|
const ruleDir = join(bundledRulesDir, entry.name)
|
|
102
|
-
const
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
out.push({ id: entry.name, jsConcerns, policyConcerns })
|
|
115
|
+
const rule = await discoverOneRule(ruleDir, entry.name)
|
|
116
|
+
if (rule.jsConcerns.length > 0 || rule.policyConcerns.length > 0) {
|
|
117
|
+
out.push(rule)
|
|
106
118
|
}
|
|
107
119
|
}
|
|
108
120
|
return out.toSorted((a, b) => a.id.localeCompare(b.id))
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Перебір `rules/<id>/` директорій з фільтром на наявність `fix.mjs`.
|
|
3
|
+
* Після атомарної міграції `fix.mjs` обов'язковий у кожному правилі — каталог без нього
|
|
4
|
+
* пропускається (це not-a-rule або заглушка).
|
|
5
|
+
*/
|
|
6
|
+
import { existsSync } from 'node:fs'
|
|
7
|
+
import { readdir } from 'node:fs/promises'
|
|
8
|
+
import { join } from 'node:path'
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* @param {string} bundledRulesDir абсолютний шлях до `npm/rules/`
|
|
12
|
+
* @param {string} [filter] id одного правила (через `--rule abie`)
|
|
13
|
+
* @returns {Promise<string[]>} відсортовані алфавітно id
|
|
14
|
+
*/
|
|
15
|
+
export async function listRuleIds(bundledRulesDir, filter) {
|
|
16
|
+
const entries = await readdir(bundledRulesDir, { withFileTypes: true })
|
|
17
|
+
const ids = entries
|
|
18
|
+
.filter(e => e.isDirectory() && !e.name.startsWith('.'))
|
|
19
|
+
.map(e => e.name)
|
|
20
|
+
.filter(id => existsSync(join(bundledRulesDir, id, 'fix.mjs')))
|
|
21
|
+
.filter(id => filter === undefined || id === filter)
|
|
22
|
+
return ids.toSorted((a, b) => a.localeCompare(b))
|
|
23
|
+
}
|
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
* Оркестратор одного правила під CLI `check`.
|
|
3
3
|
*
|
|
4
4
|
* Послідовність (concerns у межах правила — алфавітно):
|
|
5
|
-
* 1. **applies-гейт** з `
|
|
5
|
+
* 1. **applies-гейт** з `js/applies/check.mjs`. Якщо модуль експортує `applies()` і вона повертає
|
|
6
6
|
* false — друкуємо `✅ правило не застосовне` і завершуємо без подальших викликів.
|
|
7
|
-
* 2. **JS-концерни** — кожен `check*.mjs` у `
|
|
7
|
+
* 2. **JS-концерни** — кожен `check*.mjs` у `js/<concern>/`. Concern `applies` теж може мати
|
|
8
8
|
* `check()` для друку контексту (його `applies()` уже відпрацював на кроці 1, він не повторюється).
|
|
9
9
|
* 3. **Policy-концерни** — кожен `policy/<concern>/target.json` через `runConftestBatch`.
|
|
10
10
|
* Резолвер `resolveTargetFiles` ділить cache (`walkCache`) між концернами.
|
|
@@ -24,9 +24,9 @@ import { resolveConcernTemplateData } from './template.mjs'
|
|
|
24
24
|
const APPLIES_CONCERN_NAME = 'applies'
|
|
25
25
|
|
|
26
26
|
/**
|
|
27
|
-
* Обчислює абсолютний шлях до файла-check у JS-концерні: `rules/<id>/
|
|
28
|
-
*
|
|
29
|
-
*
|
|
27
|
+
* Обчислює абсолютний шлях до файла-check у JS-концерні: `rules/<id>/js/<concern>/<file>`.
|
|
28
|
+
* Convention `js/` (за технологією) повернулась у 1.13.80 після короткої епохи `fix/`
|
|
29
|
+
* (1.11.10–1.13.79) — щоб не плутати з кореневим `fix.mjs` entry-point'ом.
|
|
30
30
|
* @param {string} bundledRulesDir абсолютний `rules/`
|
|
31
31
|
* @param {string} ruleId id правила
|
|
32
32
|
* @param {import('./discover-checkable-rules.mjs').JsConcern} concern опис концерну
|
|
@@ -34,11 +34,11 @@ const APPLIES_CONCERN_NAME = 'applies'
|
|
|
34
34
|
* @returns {string} абсолютний шлях
|
|
35
35
|
*/
|
|
36
36
|
function resolveJsCheckPath(bundledRulesDir, ruleId, concern, fileName) {
|
|
37
|
-
return join(bundledRulesDir, ruleId, '
|
|
37
|
+
return join(bundledRulesDir, ruleId, 'js', concern.name, fileName)
|
|
38
38
|
}
|
|
39
39
|
|
|
40
40
|
/**
|
|
41
|
-
* Спробувати викликати applies() гейт з `
|
|
41
|
+
* Спробувати викликати applies() гейт з `js/applies/check.mjs` правила.
|
|
42
42
|
* Гейт активний лише за наявності концерну з імʼям `applies` і експортом-функцією `applies` у його
|
|
43
43
|
* першому check-файлі (алфавіт).
|
|
44
44
|
* @param {string} bundledRulesDir абсолютний `rules/`
|