github-settings-as-code 4.0.5 → 4.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "github-settings-as-code",
-  "version": "4.0.5",
+  "version": "4.0.7",
   "private": false,
   "keywords": [
     "github",
@@ -29,23 +29,23 @@
     "dedent": "^1.7.2",
     "dotenv": "^18.0.8",
     "octokit-safe-types": "^1.2.28",
-    "ts-data-forge": "^14.10.0",
-    "ts-fortress": "^12.4.0",
-    "ts-repo-utils": "^10.7.1",
+    "ts-data-forge": "^14.11.0",
+    "ts-fortress": "^12.4.4",
+    "ts-repo-utils": "^10.7.3",
     "ts-type-forge": "^9.2.2"
   },
   "devDependencies": {
     "@types/node": "26.6.5",
-    "@vitest/coverage-v8": "5.0.5",
+    "@vitest/coverage-istanbul": "5.0.5",
     "@vitest/ui": "5.0.5",
     "cspell": "10.4.0",
     "eslint": "10.13.0",
-    "eslint-config-typed": "5.19.2",
-    "eslint-plugin-ts-data-forge": "0.10.3",
-    "eslint-plugin-ts-fortress": "1.3.8",
-    "eslint-plugin-ts-type-forge": "0.8.13",
+    "eslint-config-typed": "7.5.0",
+    "eslint-plugin-ts-data-forge": "0.10.10",
+    "eslint-plugin-ts-fortress": "1.3.14",
+    "eslint-plugin-ts-type-forge": "0.8.19",
     "jiti": "2.7.0",
-    "npm-run-all2": "9.0.3",
+    "npm-run-all2": "9.0.4",
     "prettier": "3.9.10",
     "prettier-plugin-organize-imports": "4.3.0",
     "prettier-plugin-packagejson": "3.0.2",
@@ -55,11 +55,11 @@
     "vitest": "5.0.5"
   },
   "engines": {
-    "node": ">=22.22.2",
+    "node": ">=22.23.4",
     "pnpm": ">=9.0.0"
   },
   "volta": {
-    "node": "26.12.1"
+    "node": "26.13.0"
   },
   "publishConfig": {
     "access": "public",
@@ -83,9 +83,10 @@
     "fix:fmt:full": "prettier --write .",
     "fix:lint": "node ../../tools/scripts/cmd/assert-deps-built.mts && oxlint . --fix && eslint . --fix",
     "fmt": "pnpm run fix:fmt",
-    "gen": "run-s gen:index",
+    "gen": "run-s gen:index gen:readme",
     "gen:index": "run-s gen:index:src fix:fmt",
     "gen:index:src": "tsx --tsconfig ../../tools/configs/tsconfig.tsx.json ../../libs/ts-repo-utils/src/cmd/gen-index-ts.mts ./src/github --index-ext .mts --export-ext .mjs --target-ext .mts --exclude cmd --exclude octokit.mts",
+    "gen:readme": "tsx --tsconfig ../../tools/configs/tsconfig.tsx.json ./scripts/cmd/embed-examples.mts",
     "test": "pnpm run check:test",
     "test:cov:ui": "vite preview --outDir ./coverage",
     "test:ui": "pnpm run z:vitest:node --ui",

package/src/github/clear-json-files.mts

@@ -1,5 +1,5 @@
 import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
+import { listJsonFilesIn } from './list-json-files.mjs';
 
 /**
  * `dir` の直下の `*.json` を消す。ディレクトリが無ければ作る。
@@ -20,12 +20,7 @@ export const clearJsonFilesIn = async (dir: string): Promise<void> => {
   // eslint-disable-next-line security/detect-non-literal-fs-filename
   await fs.mkdir(dir, { recursive: true });
 
-  // eslint-disable-next-line security/detect-non-literal-fs-filename
-  const entries = await fs.readdir(dir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (entry.isFile() && entry.name.endsWith('.json')) {
-      await fs.rm(path.resolve(dir, entry.name));
-    }
+  for (const file of await listJsonFilesIn(dir)) {
+    await fs.rm(file);
   }
 };

package/src/github/environments/api/get-environments.mts

@@ -51,15 +51,6 @@ export const getAllEnvironments = async (): Promise<
   return settings.toSorted((a, b) => a.name.localeCompare(b.name));
 };
 
-/** 宣言ファイルに載る形。 `id` は GitHub 側の都合なので落とす。 */
-const getDeploymentBranchPolicyNames = async (
-  environmentName: string,
-): Promise<readonly Readonly<{ name: string; type: 'branch' | 'tag' }>[]> => {
-  const policies = await getDeploymentBranchPolicies(environmentName);
-
-  return policies.map(({ name, type }) => ({ name, type }));
-};
-
 /** 「 Selected branches and tags 」に登録されている pattern を列挙する。 */
 export const getDeploymentBranchPolicies = async (
   environmentName: string,
@@ -83,6 +74,15 @@ export const getDeploymentBranchPolicies = async (
   }));
 };
 
+/** 宣言ファイルに載る形。 `id` は GitHub 側の都合なので落とす。 */
+const getDeploymentBranchPolicyNames = async (
+  environmentName: string,
+): Promise<readonly Readonly<{ name: string; type: 'branch' | 'tag' }>[]> => {
+  const policies = await getDeploymentBranchPolicies(environmentName);
+
+  return policies.map(({ name, type }) => ({ name, type }));
+};
+
 export type DeploymentBranchPolicy = Readonly<{
   id: number;
   name: string;

package/src/github/environments/apply.mts

@@ -8,6 +8,7 @@ import { settingsFilePath } from '../settings-file-path.mjs';
 import { getAllEnvironments, setEnvironment } from './api/index.mjs';
 import type { EnvironmentSettings } from './constants.mjs';
 import { readEnvironmentFiles } from './read-environment-contents.mjs';
+import { selectDeclaredEnvironments } from './select-declared-environments.mjs';
 
 /**
  * `repo-settings/environments/*.json` を Settings > Environments に反映する。
@@ -27,9 +28,14 @@ export const applyEnvironments = async (): Promise<void> => {
     await setEnvironment(environment);
   }
 
-  // 反映後の実際の値でローカルのファイルを更新する
+  // 反映後の実際の値で、宣言したファイルだけを更新する。 GitHub が値を
+  // 正規化したり受け付けなかったりしたものが diff に出る。宣言に無い環境まで
+  // 書くと、 drift 検査が報せるはずのものが宣言として取り込まれてしまう。
   {
-    const applied = await getAllEnvironments();
+    const applied = selectDeclaredEnvironments(
+      await getAllEnvironments(),
+      environments,
+    );
 
     for (const environment of applied) {
       const str = JSON.stringify(environment, undefined, 2);

package/src/github/environments/index.mts

@@ -3,3 +3,4 @@ export * from './apply.mjs';
 export * from './backup.mjs';
 export * from './constants.mjs';
 export * from './read-environment-contents.mjs';
+export * from './select-declared-environments.mjs';

package/src/github/environments/read-environment-contents.mts

@@ -1,30 +1,28 @@
-import type { Dirent } from 'node:fs';
 import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
 import * as t from 'ts-fortress';
 import { isDirectlyExecuted, Result } from 'ts-repo-utils';
 import { environmentsDir } from '../constants.mjs';
+import { listJsonFilesIn } from '../list-json-files.mjs';
 import { EnvironmentSettings } from './constants.mjs';
 
 export const readEnvironmentFiles = async (): Promise<
   readonly EnvironmentSettings[]
-> => readFilesIn(environmentsDir);
+> => readEnvironmentFilesIn(environmentsDir);
 
-const readFilesIn = async (
+/**
+ * `dir` の直下の宣言（`*.json`）を読んで検証する。テストが一時ディレクトリを
+ * 渡せるように、ディレクトリを引数に取る。
+ */
+export const readEnvironmentFilesIn = async (
   dir: string,
 ): Promise<readonly EnvironmentSettings[]> => {
-  // eslint-disable-next-line security/detect-non-literal-fs-filename
-  const files: readonly Dirent<string>[] = await fs.readdir(dir, {
-    withFileTypes: true,
-  });
+  const files = await listJsonFilesIn(dir);
 
   const fileContents: readonly string[] = await Promise.all(
-    files
-      .filter((d) => d.isFile())
-      .map((d) =>
-        // eslint-disable-next-line security/detect-non-literal-fs-filename
-        fs.readFile(path.resolve(dir, d.name), { encoding: 'utf8' }),
-      ),
+    files.map((file) =>
+      // eslint-disable-next-line security/detect-non-literal-fs-filename
+      fs.readFile(file, { encoding: 'utf8' }),
+    ),
   );
 
   const validationResults = fileContents.map((content) =>

package/src/github/environments/read-environment-contents.test.mts

@@ -0,0 +1,31 @@
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { readEnvironmentFilesIn } from './read-environment-contents.mjs';
+
+// This repository's own declarations, as a known-valid fixture.
+const environmentsDir = path.resolve(
+  import.meta.dirname,
+  '../../../../../repo-settings/environments',
+);
+
+describe(readEnvironmentFilesIn, () => {
+  test('reads the declarations and ignores a README beside them', async () => {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), 'read-environments-'));
+
+    const declarations = await fs
+      .readdir(environmentsDir)
+      .then((names) => names.filter((n) => n.endsWith('.json')));
+
+    for (const name of declarations) {
+      await fs.copyFile(path.join(environmentsDir, name), path.join(dir, name));
+    }
+
+    // eslint-disable-next-line security/detect-non-literal-fs-filename
+    await fs.writeFile(path.join(dir, 'README.md'), '# notes');
+
+    const values = await readEnvironmentFilesIn(dir);
+
+    expect(values).toHaveLength(declarations.length);
+  });
+});

package/src/github/environments/select-declared-environments.mts

@@ -0,0 +1,18 @@
+/**
+ * The live environments `apply` may write back: those whose name a declaration
+ * file names. One that exists only on GitHub (made in the UI, or created by
+ * GitHub when a workflow names it) is left to the drift check rather than
+ * adopted as a declaration.
+ */
+export const selectDeclaredEnvironments = <
+  const E extends Readonly<{ name: string }>,
+>(
+  live: readonly E[],
+  declared: readonly Readonly<{ name: string }>[],
+): readonly E[] => {
+  const declaredNames: ReadonlySet<string> = new Set(
+    declared.map((e) => e.name),
+  );
+
+  return live.filter((e) => declaredNames.has(e.name));
+};

package/src/github/environments/select-declared-environments.test.mts

@@ -0,0 +1,28 @@
+import { selectDeclaredEnvironments } from './select-declared-environments.mjs';
+
+describe(selectDeclaredEnvironments, () => {
+  test('keeps the live environments that are declared, by name', () => {
+    const live = [
+      { name: 'npm-publish', wait_timer: 0 },
+      { name: 'made-in-the-ui', wait_timer: 0 },
+      { name: 'github-pages', wait_timer: 5 },
+    ] as const;
+
+    const declared = [
+      { name: 'github-pages' },
+      { name: 'npm-publish' },
+    ] as const;
+
+    assert.deepStrictEqual(selectDeclaredEnvironments(live, declared), [
+      { name: 'npm-publish', wait_timer: 0 },
+      { name: 'github-pages', wait_timer: 5 },
+    ]);
+  });
+
+  test('writes nothing back when nothing is declared', () => {
+    assert.deepStrictEqual(
+      selectDeclaredEnvironments([{ name: 'made-in-the-ui' }], []),
+      [],
+    );
+  });
+});

package/src/github/index.mts

@@ -2,6 +2,7 @@ export * from './actions-settings/index.mjs';
 export * from './clear-json-files.mjs';
 export * from './constants.mjs';
 export * from './environments/index.mjs';
+export * from './list-json-files.mjs';
 export * from './pages/index.mjs';
 export * from './repository/index.mjs';
 export * from './resolve-target-repo.mjs';

package/src/github/list-json-files.mts

@@ -0,0 +1,22 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+
+/**
+ * `dir` の直下にある `*.json` の絶対パス。宣言のディレクトリを読むところと
+ * 消すところは、どちらもこれで宣言のファイルを選ぶ。
+ *
+ * 拡張子で絞るのは、宣言の隣に置く README（`repo-settings/variables/README.md`
+ * のような、JSON でない同居ファイル）を宣言として読んだり消したりしないため。
+ * 読む側が絞らないと、README を置いただけで `JSON.parse` が投げ、apply が何も
+ * 送らずに止まる。
+ */
+export const listJsonFilesIn = async (
+  dir: string,
+): Promise<readonly string[]> => {
+  // eslint-disable-next-line security/detect-non-literal-fs-filename
+  const entries = await fs.readdir(dir, { withFileTypes: true });
+
+  return entries
+    .filter((entry) => entry.isFile() && entry.name.endsWith('.json'))
+    .map((entry) => path.resolve(dir, entry.name));
+};

package/src/github/list-json-files.test.mts

@@ -0,0 +1,45 @@
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { listJsonFilesIn } from './list-json-files.mjs';
+
+const makeDir = async (): Promise<string> =>
+  fs.mkdtemp(path.join(os.tmpdir(), 'list-json-files-'));
+
+/** 途中のディレクトリごと作って書く。入れ子の fixture もこれで用意する。 */
+const write = async (filePath: string, content: string): Promise<void> => {
+  // eslint-disable-next-line security/detect-non-literal-fs-filename
+  await fs.mkdir(path.dirname(filePath), { recursive: true });
+
+  // eslint-disable-next-line security/detect-non-literal-fs-filename
+  await fs.writeFile(filePath, content);
+};
+
+describe(listJsonFilesIn, () => {
+  test('lists the json files directly under the directory, and nothing beside them', async () => {
+    const dir = await makeDir();
+
+    await write(path.join(dir, 'main.json'), '{}');
+
+    await write(path.join(dir, 'release.json'), '{}');
+
+    await write(path.join(dir, 'README.md'), '# notes');
+
+    await write(path.join(dir, 'nested', 'deep.json'), '{}');
+
+    const files = await listJsonFilesIn(dir);
+
+    assert.deepStrictEqual(files.toSorted(), [
+      path.join(dir, 'main.json'),
+      path.join(dir, 'release.json'),
+    ]);
+  });
+
+  test('is empty for a directory holding no json', async () => {
+    const dir = await makeDir();
+
+    await write(path.join(dir, 'README.md'), '# notes');
+
+    assert.deepStrictEqual(await listJsonFilesIn(dir), []);
+  });
+});

package/src/github/resolve-target-repo.mts

@@ -10,6 +10,53 @@ export type TargetRepo = Readonly<{
   repo: string;
 }>;
 
+/**
+ * 操作対象の repository を決める。
+ *
+ * 優先順位は以下の通り。
+ *
+ * 1. コマンドライン引数 `--owner` / `--repo`
+ * 2. 環境変数 `OWNER` / `REPO_NAME`
+ * 3. `git remote get-url origin`
+ * 4. `package.json` の `name` （ repo のみ ）
+ */
+export const resolveTargetRepo = async (): Promise<TargetRepo> => {
+  const sources: readonly Partial<TargetRepo>[] = [
+    fromCliArgs(),
+    fromEnv(),
+    fromGitRemote(),
+    await fromPackageJson(),
+  ] as const;
+
+  const owner = sources.map((s) => s.owner).find((v) => v !== undefined);
+
+  if (owner === undefined) {
+    throw new Error(
+      [
+        'owner を特定できませんでした。次のいずれかで指定してください:',
+        '  --owner <owner> （コマンドライン引数）',
+        '  OWNER=<owner>   （環境変数）',
+        '  git remote add origin <URL> （ origin の URL から推測されます）',
+      ].join('\n'),
+    );
+  }
+
+  const repo = sources.map((s) => s.repo).find((v) => v !== undefined);
+
+  if (repo === undefined) {
+    throw new Error(
+      [
+        'repository 名を特定できませんでした。次のいずれかで指定してください:',
+        '  --repo <repo>     （コマンドライン引数）',
+        '  REPO_NAME=<repo>  （環境変数）',
+        '  git remote add origin <URL> （ origin の URL から推測されます）',
+      ].join('\n'),
+    );
+  }
+
+  return { owner, repo };
+};
+
 /** `strict: false` の解析結果は string | boolean | 配列 になりうるため絞り込む。 */
 const pickString = (value: unknown): string | undefined =>
   value !== '' && isString(value) ? value : undefined;
@@ -95,50 +142,3 @@ const fromPackageJson = async (): Promise<Partial<TargetRepo>> => {
     return {};
   }
 };
-
-/**
- * 操作対象の repository を決める。
- *
- * 優先順位は以下の通り。
- *
- * 1. コマンドライン引数 `--owner` / `--repo`
- * 2. 環境変数 `OWNER` / `REPO_NAME`
- * 3. `git remote get-url origin`
- * 4. `package.json` の `name` （ repo のみ ）
- */
-export const resolveTargetRepo = async (): Promise<TargetRepo> => {
-  const sources: readonly Partial<TargetRepo>[] = [
-    fromCliArgs(),
-    fromEnv(),
-    fromGitRemote(),
-    await fromPackageJson(),
-  ] as const;
-
-  const owner = sources.map((s) => s.owner).find((v) => v !== undefined);
-
-  if (owner === undefined) {
-    throw new Error(
-      [
-        'owner を特定できませんでした。次のいずれかで指定してください:',
-        '  --owner <owner> （コマンドライン引数）',
-        '  OWNER=<owner>   （環境変数）',
-        '  git remote add origin <URL> （ origin の URL から推測されます）',
-      ].join('\n'),
-    );
-  }
-
-  const repo = sources.map((s) => s.repo).find((v) => v !== undefined);
-
-  if (repo === undefined) {
-    throw new Error(
-      [
-        'repository 名を特定できませんでした。次のいずれかで指定してください:',
-        '  --repo <repo>     （コマンドライン引数）',
-        '  REPO_NAME=<repo>  （環境変数）',
-        '  git remote add origin <URL> （ origin の URL から推測されます）',
-      ].join('\n'),
-    );
-  }
-
-  return { owner, repo };
-};

package/src/github/ruleset/api/create-ruleset.mts

@@ -11,9 +11,9 @@ export const createRuleset = async ({
   payload: { name, target, enforcement, bypass_actors, conditions, rules },
 }: Readonly<{
   payload: CreateRulesetRequest;
-}>): Promise<void> => {
+}>): Promise<number> => {
   // https://docs.github.com/ja/rest/repos/rules?apiVersion=2022-11-28#create-a-repository-ruleset
-  await octokit.request(
+  const { data } = await octokit.request(
     'POST /repos/{owner}/{repo}/rulesets' satisfies EndpointKeys,
     // transformer-ignore-next-line convert-to-readonly
     {
@@ -32,4 +32,7 @@ export const createRuleset = async ({
       ) as components['schemas']['repository-rule'][],
     },
   );
+
+  // 作られた ruleset の id。 apply の書き戻しは、送った ruleset をこれで特定する。
+  return data.id;
 };

package/src/github/ruleset/apply.mts

@@ -42,8 +42,10 @@ export const applyRulesets = async (): Promise<void> => {
     });
   }
 
+  const mut_createdIds: number[] = [];
+
   for (const ruleset of rulesetsToCreate) {
-    await createRuleset({
+    const createdId = await createRuleset({
       payload: {
         bypass_actors: ruleset.bypass_actors,
         conditions: ruleset.conditions ?? undefined,
@@ -53,15 +55,28 @@ export const applyRulesets = async (): Promise<void> => {
         target: ruleset.target === 'repository' ? undefined : ruleset.target,
       },
     });
+
+    mut_createdIds.push(createdId);
   }
 
-  // update local ruleset files
-  {
-    const rulesetsResult = await getAllRulesets();
+  // 書き戻すのは、いま送った ruleset だけ — 更新したものは宣言の id で、
+  // 作ったものは GitHub が付けた id で特定する。宣言に無い ruleset（GUI で
+  // 作られたもの、 organization の ruleset）まで書くと、 drift 検査が報せる
+  // はずのものが宣言として取り込まれてしまう。名前では特定しない。親の
+  // ruleset が同じ名前を持てるので、別物が同じファイルに書かれうる。
+  const appliedIds: ReadonlySet<number> = new Set<number>([
+    ...rulesetsToUpdate.map((r) => r.id),
+    ...mut_createdIds,
+  ]);
 
-    for (const rule of rulesetsResult) {
-      const content = await getRuleset(rule.id);
+  // 反映後の実際の値で、送った ruleset のファイルを更新する。 GitHub が値を
+  // 正規化したり受け付けなかったりしたものが diff に出る。一覧は読み直さず
+  // id ごとに取る（一覧はページ分割され、親の ruleset も含む）。全部取って
+  // から書くので、途中で取得に失敗しても一部だけ書き換わることはない。
+  {
+    const contents = await Promise.all(Array.from(appliedIds, getRuleset));
 
+    for (const content of contents) {
       const str = JSON.stringify(
         Obj.pick(content, rulesetKeysToPick),
         undefined,
@@ -70,7 +85,7 @@ export const applyRulesets = async (): Promise<void> => {
 
       // `settingsFilePath` が `rulesetsDir` の直下であることを確かめている。
       // eslint-disable-next-line security/detect-non-literal-fs-filename
-      await fs.writeFile(settingsFilePath(rulesetsDir, rule.name), str);
+      await fs.writeFile(settingsFilePath(rulesetsDir, content.name), str);
     }
 
     await formatUncommittedFiles();

package/src/github/ruleset/read-rule-set-contents.mts

@@ -1,29 +1,27 @@
-import type { Dirent } from 'node:fs';
 import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
 import * as t from 'ts-fortress';
 import { isDirectlyExecuted, Result } from 'ts-repo-utils';
 import { rulesetsDir } from '../constants.mjs';
+import { listJsonFilesIn } from '../list-json-files.mjs';
 import { RulesetPicked } from './constants.mjs';
 
 export const readRulesetFiles = async (): Promise<readonly RulesetPicked[]> =>
-  readFilesIn(rulesetsDir);
+  readRulesetFilesIn(rulesetsDir);
 
-const readFilesIn = async (dir: string): Promise<readonly RulesetPicked[]> => {
-  // eslint-disable-next-line security/detect-non-literal-fs-filename
-  const files: readonly Dirent<string>[] = await fs.readdir(dir, {
-    withFileTypes: true,
-  });
+/**
+ * `dir` の直下の宣言（`*.json`）を読んで検証する。テストが一時ディレクトリを
+ * 渡せるように、ディレクトリを引数に取る。
+ */
+export const readRulesetFilesIn = async (
+  dir: string,
+): Promise<readonly RulesetPicked[]> => {
+  const files = await listJsonFilesIn(dir);
 
   const rulesetFileContents: readonly string[] = await Promise.all(
-    files
-      .filter((d) => d.isFile())
-      .map((d) =>
-        // eslint-disable-next-line security/detect-non-literal-fs-filename
-        fs.readFile(path.resolve(dir, d.name), {
-          encoding: 'utf8',
-        }),
-      ),
+    files.map((file) =>
+      // eslint-disable-next-line security/detect-non-literal-fs-filename
+      fs.readFile(file, { encoding: 'utf8' }),
+    ),
   );
 
   const validationResults = rulesetFileContents.map((rule) =>

package/src/github/ruleset/read-rule-set-contents.test.mts

@@ -0,0 +1,31 @@
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { readRulesetFilesIn } from './read-rule-set-contents.mjs';
+
+// This repository's own declarations, as a known-valid fixture.
+const rulesetsDir = path.resolve(
+  import.meta.dirname,
+  '../../../../../repo-settings/rulesets',
+);
+
+describe(readRulesetFilesIn, () => {
+  test('reads the declarations and ignores a README beside them', async () => {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), 'read-rulesets-'));
+
+    const declarations = await fs
+      .readdir(rulesetsDir)
+      .then((names) => names.filter((n) => n.endsWith('.json')));
+
+    for (const name of declarations) {
+      await fs.copyFile(path.join(rulesetsDir, name), path.join(dir, name));
+    }
+
+    // eslint-disable-next-line security/detect-non-literal-fs-filename
+    await fs.writeFile(path.join(dir, 'README.md'), '# notes');
+
+    const values = await readRulesetFilesIn(dir);
+
+    expect(values).toHaveLength(declarations.length);
+  });
+});