declapract-typescript-ehmpathy 0.49.12 → 0.49.14

package/dist/.test/assets/expo-fullusecase/declarations/practices/tests-any/__snapshots__/test-kind-seam.declapract.integration.test.ts.snap

@@ -0,0 +1,9 @@
+// Jest Snapshot v1, https://jestjs.io/docs/snapshot-testing
+
+exports[`#679 test-kind presence accepts the \`._.\` seam given: [case] the tests-any integration declaration, on a repo with no test of either form then: the check still fails 1`] = `"expected at least one test file under src/ named *.integration.test.ts or *._.intg.test.ts"`;
+
+exports[`#679 test-kind presence accepts the \`._.\` seam given: [case] the tests-service blackbox acceptance declaration, on a repo with no test of either form then: the check still fails 1`] = `"expected at least one test file under blackbox/ named *.acceptance.test.ts or *._.acpt.test.ts"`;
+
+exports[`#679 test-kind presence accepts the \`._.\` seam given: [case] the tests-service integration declaration, on a repo with no test of either form then: the check still fails 1`] = `"expected at least one test file under src/ named *.integration.test.ts or *._.intg.test.ts"`;
+
+exports[`#679 test-kind presence accepts the \`._.\` seam given: [case] the tests-service lambda acceptance declaration, on a repo with no test of either form then: the check still fails 1`] = `"expected at least one test file under blackbox/lambdas/ named *.acceptance.test.ts or *._.acpt.test.ts"`;

package/dist/.test/assets/expo-fullusecase/declarations/practices/tests-any/autoprune-hooks.declapract.integration.test.ts

@@ -57,8 +57,15 @@ const configs: { relPath: string; composite: string | null }[] = [
     composite: 'src/practices/tests-node/best-practice/jest.acceptance.prepare.ts',
   },
   { relPath: 'src/practices/tests-expo/best-practice/jest.unit.config.ts', composite: null },
-  { relPath: 'src/practices/tests-expo/best-practice/jest.integration.config.ts', composite: null },
-  { relPath: 'src/practices/tests-expo/best-practice/jest.acceptance.config.ts', composite: null },
+  // #621: the expo integration + acceptance configs compose the livedb wake (via-gateway) too
+  {
+    relPath: 'src/practices/tests-expo/best-practice/jest.integration.config.ts',
+    composite: 'src/practices/tests-expo/best-practice/jest.integration.prepare.ts',
+  },
+  {
+    relPath: 'src/practices/tests-expo/best-practice/jest.acceptance.config.ts',
+    composite: 'src/practices/tests-expo/best-practice/jest.acceptance.prepare.ts',
+  },
 ];
 
 /**

package/dist/.test/assets/expo-fullusecase/declarations/practices/tests-any/bad-practices/dev-tool-in-dependencies/.declapract.integration.test.ts

@@ -0,0 +1,69 @@
+import fs from 'fs/promises';
+import path from 'node:path';
+
+import { executeApply } from 'declapract';
+import { genTempDir, given, then, useBeforeAll, when } from 'test-fns';
+
+// executeApply evaluates the whole practice
+jest.setTimeout(240_000);
+
+/**
+ * .what = proves `declapract fix` on tests-any removes a stale test-fns from dependencies, so the
+ *         floored devDependencies entry is the one that installs (#657)
+ * .why  = the floor raised devDependencies alone; a `dependencies: 1.4.x` duplicate won the install
+ */
+describe('tests-any dev-tool-in-dependencies — pipeline', () => {
+  given('[case1] a repo with test-fns 1.4.0 in dependencies and 1.15.0 in devDependencies', () => {
+    const tempDir = genTempDir({
+      slug: 'declapract-dev-tool-in-deps',
+      clone:
+        './src/practices/tests-any/bad-practices/dev-tool-in-dependencies/.test/assets/demo-repo-with-stale-test-fns-dep',
+      // evaluate tests-any alone against the tiny repo; a symlink of this repo's whole src makes
+      // the practice's src/** globs walk every fixture here (minutes per apply)
+      symlink: [
+        { at: 'declarations', to: './src/.test/assets/tests-any-only/declarations' },
+        { at: 'node_modules', to: 'node_modules' },
+      ],
+    });
+
+    const read = () => fs.readFile(path.join(tempDir, 'package.json'), 'utf-8');
+
+    const state = useBeforeAll(async () => {
+      const config = path.join(tempDir, 'declapract.use.yml');
+      const before = await read();
+      await executeApply({ config, practice: 'tests-any', file: 'package.json' });
+      const after1 = await read();
+      await executeApply({ config, practice: 'tests-any', file: 'package.json' });
+      const after2 = await read();
+      await executeApply({ config, practice: 'tests-any', file: 'package.json' });
+      const after3 = await read();
+      return { before, after1, after2, after3 };
+    }, 230_000);
+
+    when('[t0] declapract fix is applied', () => {
+      then('test-fns is gone from dependencies, and the runtime dep stays', () => {
+        const pkg = JSON.parse(state.after2);
+        expect(pkg.dependencies['test-fns']).toBeUndefined();
+        expect(pkg.dependencies['domain-objects']).toEqual('0.31.0');
+      });
+
+      then('devDependencies holds test-fns at or above the floor', () => {
+        const pkg = JSON.parse(state.after2);
+        expect(pkg.devDependencies['test-fns']).not.toEqual('1.4.0');
+        expect(pkg.devDependencies['test-fns']).not.toEqual('1.15.0');
+        expect(pkg.devDependencies['test-fns']).not.toContain('@declapract{');
+      });
+
+      then('before + after match snapshot', () => {
+        expect(state.before).toMatchSnapshot('package.json — before');
+        expect(state.after2).toMatchSnapshot('package.json — after');
+      });
+    });
+
+    when('[t1] declapract fix is re-applied', () => {
+      then('the package.json is a fixed point once settled', () => {
+        expect(state.after3).toEqual(state.after2);
+      });
+    });
+  });
+});

package/dist/.test/assets/expo-fullusecase/declarations/practices/tests-any/bad-practices/dev-tool-in-dependencies/.declapract.readme.md

@@ -0,0 +1,19 @@
+# tests-any dev-tool-in-dependencies bad practice
+
+## what
+
+detects a test tool that tests-any declares in `devDependencies` (`jest`, `@jest/globals`,
+`@types/jest`, `test-fns`, `tsx`, `esbuild-register`) when it also, or only, sits in
+`dependencies`.
+
+## why
+
+the tests-any best-practice floor raises the `devDependencies` entry alone. a stale duplicate in
+`dependencies` wins the install, so plan reports the floor met while the old release lands. jest
+then fails to load a reporter or setup that the old release predates.
+
+## fix
+
+removes each such tool from `dependencies`. where `devDependencies` lacks it, the version moves
+there; where `devDependencies` already holds it, that entry wins and the best-practice floor
+raises it.

package/dist/.test/assets/expo-fullusecase/declarations/practices/tests-any/bad-practices/dev-tool-in-dependencies/.test/assets/demo-repo-with-stale-test-fns-dep/declapract.use.yml

@@ -0,0 +1,3 @@
+# .note = declarations dir is symlinked by the test to src/.test/assets/tests-any-only/declarations
+declarations: 'declarations/declapract.declare.yml'
+useCase: tests-any-only

package/dist/.test/assets/expo-fullusecase/declarations/practices/tests-any/bad-practices/dev-tool-in-dependencies/.test/assets/demo-repo-with-stale-test-fns-dep/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "test-project",
+  "version": "1.0.0",
+  "dependencies": {
+    "domain-objects": "0.31.0",
+    "test-fns": "1.4.0"
+  },
+  "devDependencies": {
+    "test-fns": "1.15.0"
+  }
+}

package/dist/.test/assets/expo-fullusecase/declarations/practices/tests-any/bad-practices/dev-tool-in-dependencies/__snapshots__/.declapract.integration.test.ts.snap

@@ -0,0 +1,43 @@
+// Jest Snapshot v1, https://jestjs.io/docs/snapshot-testing
+
+exports[`tests-any dev-tool-in-dependencies — pipeline given: [case1] a repo with test-fns 1.4.0 in dependencies and 1.15.0 in devDependencies when: [t0] declapract fix is applied then: before + after match snapshot: package.json — after 1`] = `
+"{
+  "name": "test-project",
+  "version": "1.0.0",
+  "dependencies": {
+    "domain-objects": "0.31.0"
+  },
+  "devDependencies": {
+    "test-fns": "1.17.0",
+    "@jest/globals": "30.2.0",
+    "@types/jest": "30.0.0",
+    "jest": "30.2.0",
+    "esbuild-register": "3.6.0",
+    "tsx": "4.20.6"
+  },
+  "scripts": {
+    "build:ifstale": "set -eu && if [ -f dist/.build.stamp ] && [ -z \\"$(find src assets package.json pnpm-lock.yaml tsconfig.json tsconfig.build.json app.json app.config.ts -newer dist/.build.stamp -type f ! -name '*.test.ts' ! -name '*.test.tsx' ! -name '*.snap' -print -quit 2>/dev/null)\\" ]; then echo '👌 dist is fresh, build skipped'; else npm run build && touch dist/.build.stamp; fi",
+    "test:unit": "set -eu && jest -c ./jest.unit.config.ts --forceExit --verbose --passWithNoTests $([ -n \\"\${CI:-}\\" ] && echo '--ci') $([ \\"\${THOROUGH:-}\\" != \\"true\\" ] && echo '--changedSince=origin/main') $([ \\"\${RESNAP:-}\\" = \\"true\\" ] && echo '--updateSnapshot')",
+    "test:integration": "set -eu && jest -c ./jest.integration.config.ts --forceExit --verbose --passWithNoTests $([ -n \\"\${CI:-}\\" ] && echo '--ci') $([ \\"\${THOROUGH:-}\\" != \\"true\\" ] && echo '--changedSince=origin/main') $([ \\"\${RESNAP:-}\\" = \\"true\\" ] && echo '--updateSnapshot')",
+    "test:acceptance:locally": "set -eu && npm run build:ifstale && LOCALLY=true jest -c ./jest.acceptance.config.ts --forceExit --verbose --runInBand --passWithNoTests $([ \\"\${RESNAP:-}\\" = \\"true\\" ] && echo '--updateSnapshot')",
+    "test": "set -eu && npm run test:commits && npm run test:types && npm run test:format && npm run test:lint && npm run test:unit && npm run test:integration && npm run test:acceptance:locally",
+    "test:acceptance": "set -eu && npm run build && jest -c ./jest.acceptance.config.ts --forceExit --verbose --runInBand --passWithNoTests $([ -n \\"\${CI:-}\\" ] && echo '--ci') $([ \\"\${RESNAP:-}\\" = \\"true\\" ] && echo '--updateSnapshot')"
+  }
+}
+"
+`;
+
+exports[`tests-any dev-tool-in-dependencies — pipeline given: [case1] a repo with test-fns 1.4.0 in dependencies and 1.15.0 in devDependencies when: [t0] declapract fix is applied then: before + after match snapshot: package.json — before 1`] = `
+"{
+  "name": "test-project",
+  "version": "1.0.0",
+  "dependencies": {
+    "domain-objects": "0.31.0",
+    "test-fns": "1.4.0"
+  },
+  "devDependencies": {
+    "test-fns": "1.15.0"
+  }
+}
+"
+`;

package/dist/.test/assets/expo-fullusecase/declarations/practices/tests-any/bad-practices/dev-tool-in-dependencies/package.json.declapract.ts

@@ -0,0 +1,81 @@
+import type { FileCheckFunction, FileFixFunction } from 'declapract';
+
+import { asPackageJSON } from '../../../../utils/asPackageJSON';
+
+/**
+ * .what = detects a test tool the tests-any practice floors in `devDependencies` that ALSO (or
+ *         only) sits in `dependencies`
+ * .why  = the best-practice floor raises the `devDependencies` entry alone. a stale duplicate in
+ *         `dependencies` wins the install, so plan reports the floor met while the old release
+ *         lands, and jest cannot load a reporter or setup that release predates (#657)
+ */
+const PRACTICE = 'tests-any/dev-tool-in-dependencies';
+
+// the test tools tests-any declares in devDependencies (its best-practice package.json)
+export const DEV_TOOLS = [
+  '@jest/globals',
+  '@types/jest',
+  'esbuild-register',
+  'jest',
+  'test-fns',
+  'tsx',
+];
+
+export const check: FileCheckFunction = (contents) => {
+  if (!contents)
+    throw new Error(
+      `does not match bad practice: [${PRACTICE}] package.json has no contents to scan`,
+    );
+
+  const packageJSON = asPackageJSON({ contents }, { practice: PRACTICE });
+  const prodDeps = Object.keys(packageJSON.dependencies ?? {});
+
+  // a dev tool in dependencies = the bad practice
+  if (prodDeps.some((dep) => DEV_TOOLS.includes(dep))) return;
+
+  throw new Error(
+    'does not match bad practice: no tests-any dev tool in dependencies',
+  );
+};
+
+/**
+ * .what = remove each dev tool from prod deps; carry its version into dev deps only where dev
+ *         deps lacks it, so an extant dev deps entry (the one the floor raises) wins
+ * .why  = names the relocation as one intent, via a pure partition (inputs untouched)
+ */
+const withDevToolsMovedToDevDeps = (input: {
+  prodDeps: Record<string, string>;
+  devDeps: Record<string, string>;
+}): { prodDeps: Record<string, string>; devDeps: Record<string, string> } => {
+  const prodEntries = Object.entries(input.prodDeps);
+  const relocated = prodEntries.filter(([dep]) => DEV_TOOLS.includes(dep));
+  const retained = prodEntries.filter(([dep]) => !DEV_TOOLS.includes(dep));
+  return {
+    prodDeps: Object.fromEntries(retained),
+    devDeps: { ...Object.fromEntries(relocated), ...input.devDeps },
+  };
+};
+
+export const fix: FileFixFunction = (contents) => {
+  if (!contents) return { contents };
+
+  const packageJSON = asPackageJSON({ contents }, { practice: PRACTICE });
+
+  // relocate every dev tool out of prod deps
+  const { prodDeps, devDeps } = withDevToolsMovedToDevDeps({
+    prodDeps: { ...packageJSON.dependencies },
+    devDeps: { ...packageJSON.devDependencies },
+  });
+
+  // keep each section's presence: a declared section stays; dev deps is added only when the move
+  // lands a package into it
+  const fixedPackageJSON = {
+    ...packageJSON,
+    ...('dependencies' in packageJSON ? { dependencies: prodDeps } : {}),
+    ...('devDependencies' in packageJSON || Object.keys(devDeps).length > 0
+      ? { devDependencies: devDeps }
+      : {}),
+  };
+
+  return { contents: JSON.stringify(fixedPackageJSON, null, 2) };
+};

package/dist/.test/assets/expo-fullusecase/declarations/practices/tests-any/bad-practices/old-acceptance-dir-location/.declapract.integration.test.ts

@@ -4,6 +4,9 @@ import path from 'node:path';
 import { executeApply } from 'declapract';
 import { genTempDir, given, then, useThen, when } from 'test-fns';
 
+// executeApply evaluates the whole tests-any practice
+jest.setTimeout(240_000);
+
 /**
  * .what = integration test for old-acceptance-dir-location bad practice
  * .why = reproduces bug where files with non-ts extensions are silently dropped
@@ -13,7 +16,15 @@ describe('old-acceptance-dir-location', () => {
     const tempDir = genTempDir({
       slug: 'declapract-old-acceptance-dir',
       clone: './src/practices/tests-any/bad-practices/old-acceptance-dir-location/.test/assets/demo-repo-with-accept-blackbox-dir',
-      symlink: [{ at: 'src', to: 'src' }],
+      // evaluate tests-any alone against the tiny repo; a symlink of this repo's whole src makes
+      // the practice's src/** globs walk every fixture (minutes per apply)
+      symlink: [
+        {
+          at: 'declarations',
+          to: './src/.test/assets/tests-any-only/declarations',
+        },
+        { at: 'node_modules', to: 'node_modules' },
+      ],
     });
 
     when('[t0] before fix', () => {
@@ -28,11 +39,20 @@ describe('old-acceptance-dir-location', () => {
     });
 
     when('[t1] declapract fix is applied', () => {
+      // one apply per fixture file, each scoped by `file`: an unscoped apply walks the linked
+      // declarations into this repo's real tests-any tree, and its `**/*.ts` rewrites land there
       useThen('fix is applied', async () => {
-        await executeApply({
-          config: path.join(tempDir, 'declapract.use.yml'),
-          practice: 'tests-any',
-        });
+        const files = [
+          'accept.blackbox/somefile.ts',
+          'accept.blackbox/.test/assets/.rhachet/manifest.json',
+          'accept.blackbox/.test/assets/.agent/config.yml',
+        ];
+        for (const file of files)
+          await executeApply({
+            config: path.join(tempDir, 'declapract.use.yml'),
+            practice: 'tests-any',
+            file,
+          });
       });
 
       then('somefile.ts is moved to blackbox/', async () => {

package/dist/.test/assets/expo-fullusecase/declarations/practices/tests-any/bad-practices/old-acceptance-dir-location/.test/assets/demo-repo-with-accept-blackbox-dir/declapract.use.yml

@@ -1,5 +1,6 @@
-declarations: './'
-useCase: typescript-project
+# .note = declarations dir is symlinked by the test to src/.test/assets/tests-any-only/declarations
+declarations: 'declarations/declapract.declare.yml'
+useCase: tests-any-only
 variables:
   organizationName: 'test-org'
   projectName: 'test-project'

package/dist/.test/assets/expo-fullusecase/declarations/practices/tests-any/bad-practices/old-acceptance-test-utils/blackbox/lambdas/<star>.ts.declapract.ts

@@ -1,6 +1,7 @@
 import type { FileCheckFunction, FileFixFunction } from 'declapract';
 
 import { getProjectVariables } from '../../../../../../getVariables';
+import { asSourceOnRunLambdaEndpoint } from '../../../../../../utils/asSourceOnRunLambdaEndpoint';
 
 export const check: FileCheckFunction = (contents) => {
   if (
@@ -13,32 +14,36 @@ export const check: FileCheckFunction = (contents) => {
 export const fix: FileFixFunction = async (contents, context) => {
   if (!contents) return {}; // do nothing if no contents. really, this shouldn't have been called
   const { projectName } = await getProjectVariables(context);
-  return {
-    contents: contents
-      .replace(
-        // replace the bad import
-        `import { invokeLambda } from '../_utils/invokeLambda';`,
+
+  // move onto the old lib's call shape, then onto runLambdaEndpoint in the same apply (#650):
+  // simple-lambda-testing-methods is retired, so the fix must never leave the file on it
+  const onRetiredLibShape = contents
+    .replace(
+      // replace the bad import
+      `import { invokeLambda } from '../_utils/invokeLambda';`,
+      [
+        `import { invokeLambdaForTesting } from 'simple-lambda-testing-methods';`,
+        `import { locally } from '../environment';`,
+      ].join('\n'),
+    )
+    .replace(
+      // replace calls to the fn
+      /invokeLambda\(\{/g,
+      'invokeLambdaForTesting({',
+    )
+    .replace(
+      // replace the inputs; capture the indent that precedes `name:` so the
+      // expanded 3-line option block stays aligned with its siblings
+      /^([ \t]*)name: '(\w+)',/gm,
+      (_match, indent, fnName) =>
         [
-          `import { invokeLambdaForTesting } from 'simple-lambda-testing-methods';`,
-          `import { locally } from '../environment';`,
+          `${indent}service: '${projectName}',`,
+          `${indent}function: '${fnName}',`,
+          `${indent}locally,`,
         ].join('\n'),
-      )
-      .replace(
-        // replace calls to the fn
-        /invokeLambda\(\{/g,
-        'invokeLambdaForTesting({',
-      )
-      .replace(
-        // replace the inputs; capture the indent that precedes `name:` so the
-        // expanded 3-line option block stays aligned with its siblings
-        /^([ \t]*)name: '(\w+)',/gm,
-        (_match, indent, fnName) =>
-          [
-            `${indent}service: '${projectName}',`,
-            `${indent}function: '${fnName}',`,
-            `${indent}locally,`,
-          ].join('\n'),
-      )
-      .replace(/data: /g, 'event: '),
+    )
+    .replace(/data: /g, 'event: ');
+  return {
+    contents: asSourceOnRunLambdaEndpoint({ contents: onRetiredLibShape }),
   };
 };

package/dist/.test/assets/expo-fullusecase/declarations/practices/tests-any/bad-practices/old-acceptance-test-utils-2/blackbox/lambdas/<star>.ts.declapract.ts

@@ -1,5 +1,7 @@
 import type { FileCheckFunction, FileFixFunction } from 'declapract';
 
+import { asSourceOnRunLambdaEndpoint } from '../../../../../../utils/asSourceOnRunLambdaEndpoint';
+
 export const check: FileCheckFunction = (contents) => {
   if (
     contents?.includes(
@@ -12,11 +14,14 @@ export const check: FileCheckFunction = (contents) => {
 
 export const fix: FileFixFunction = async (contents) => {
   if (!contents) return {}; // do nothing if no contents. really, this shouldn't have been called
+  // move the environment import, and off the retired test lib in the same apply (#650)
   return {
-    contents: contents.replace(
-      // replace the bad import
-      `import { locally } from '../__test_utils__/environment';`,
-      `import { locally } from '../environment';`,
-    ),
+    contents: asSourceOnRunLambdaEndpoint({
+      contents: contents.replace(
+        // replace the bad import
+        `import { locally } from '../__test_utils__/environment';`,
+        `import { locally } from '../environment';`,
+      ),
+    }),
   };
 };

package/dist/.test/assets/expo-fullusecase/declarations/practices/tests-any/bad-practices/old-acceptance-test-utils-3/blackbox/lambdas/<star>.ts.declapract.ts

@@ -1,5 +1,7 @@
 import type { FileCheckFunction, FileFixFunction } from 'declapract';
 
+import { asSourceOnRunLambdaEndpoint } from '../../../../../../utils/asSourceOnRunLambdaEndpoint';
+
 export const check: FileCheckFunction = (contents) => {
   if (contents?.includes(`import { locally } from '../_utils/environment';`))
     return; // then it matches bad practice
@@ -8,11 +10,14 @@ export const check: FileCheckFunction = (contents) => {
 
 export const fix: FileFixFunction = async (contents) => {
   if (!contents) return {}; // do nothing if no contents. really, this shouldn't have been called
+  // move the environment import, and off the retired test lib in the same apply (#650)
   return {
-    contents: contents.replace(
-      // replace the bad import
-      `import { locally } from '../_utils/environment';`,
-      `import { locally } from '../environment';`,
-    ),
+    contents: asSourceOnRunLambdaEndpoint({
+      contents: contents.replace(
+        // replace the bad import
+        `import { locally } from '../_utils/environment';`,
+        `import { locally } from '../environment';`,
+      ),
+    }),
   };
 };

package/dist/.test/assets/expo-fullusecase/declarations/practices/tests-any/best-practice/package.json

@@ -8,9 +8,10 @@
     "tsx": "@declapract{check.minVersion('4.20.6')}"
   },
   "scripts": {
+    "build:ifstale": "set -eu && if [ -f dist/.build.stamp ] && [ -z \"$(find src assets package.json pnpm-lock.yaml tsconfig.json tsconfig.build.json app.json app.config.ts -newer dist/.build.stamp -type f ! -name '*.test.ts' ! -name '*.test.tsx' ! -name '*.snap' -print -quit 2>/dev/null)\" ]; then echo '👌 dist is fresh, build skipped'; else npm run build && touch dist/.build.stamp; fi",
     "test:unit": "set -eu && jest -c ./jest.unit.config.ts --forceExit --verbose --passWithNoTests $([ -n \"${CI:-}\" ] && echo '--ci') $([ \"${THOROUGH:-}\" != \"true\" ] && echo '--changedSince=origin/main') $([ \"${RESNAP:-}\" = \"true\" ] && echo '--updateSnapshot')",
     "test:integration": "set -eu && jest -c ./jest.integration.config.ts --forceExit --verbose --passWithNoTests $([ -n \"${CI:-}\" ] && echo '--ci') $([ \"${THOROUGH:-}\" != \"true\" ] && echo '--changedSince=origin/main') $([ \"${RESNAP:-}\" = \"true\" ] && echo '--updateSnapshot')",
-    "test:acceptance:locally": "set -eu && npm run build && LOCALLY=true jest -c ./jest.acceptance.config.ts --forceExit --verbose --runInBand --passWithNoTests $([ \"${RESNAP:-}\" = \"true\" ] && echo '--updateSnapshot')",
+    "test:acceptance:locally": "set -eu && npm run build:ifstale && LOCALLY=true jest -c ./jest.acceptance.config.ts --forceExit --verbose --runInBand --passWithNoTests $([ \"${RESNAP:-}\" = \"true\" ] && echo '--updateSnapshot')",
     "test": "set -eu && npm run test:commits && npm run test:types && npm run test:format && npm run test:lint && npm run test:unit && npm run test:integration && npm run test:acceptance:locally",
     "test:acceptance": "set -eu && npm run build && jest -c ./jest.acceptance.config.ts --forceExit --verbose --runInBand --passWithNoTests $([ -n \"${CI:-}\" ] && echo '--ci') $([ \"${RESNAP:-}\" = \"true\" ] && echo '--updateSnapshot')"
   }

package/dist/{practices/tests-node → .test/assets/expo-fullusecase/declarations/practices/tests-any}/best-practice/src/.test/useWakeOfLivedb.ts

@@ -28,22 +28,31 @@ import { ConstraintError } from 'helpful-errors';
  *         it RESUMES a paused cluster. its pair, `useWakeOfTestdb`, is the LOCAL own-db half: it
  *         only PREFLIGHTS the local testdb (it cannot start it, so it fails loud with a `start:testdb`
  *         fix). the two form a symmetric pair; the name reads "wake" for symmetry, the act differs.
- *         the wake fires for prep OR test access, per define.invariant.test-and-prep-reach-prep-peers.
+ *         the wake fires for prep OR test access: both reach the deployed prep peers.
+ * .note = `reaches` names HOW the caller reaches the cluster, so the gate reads a signal the caller
+ *         actually has:
+ *         - `via-tunnel` = a node service; gate on `config/prep.json`'s `database.tunnel`
+ *         - `via-gateway` = an expo app, which owns no `config/` dir and reaches the cluster through
+ *           its gateway's peers; its acceptance + integration suites reach a deployment by
+ *           construction, so the test kind itself is the signal and no config gate applies
  */
-export const useWakeOfLivedb = async (
-  input: { env: 'test' | 'prep' | 'prod' | null },
-): Promise<void> => {
-  // in ci, the wake runs as a dedicated workflow step (local ssm-tunnel path is unavailable)
-  if (process.env.CI) return;
-
-  // prod never scales to 0, so it never needs a wake; default the target to prep
-  const env = input.env ?? 'prep';
-  if (env === 'prod') return;
+export const useWakeOfLivedb = async (input: {
+  env: 'test' | 'prep' | 'prod' | null;
+  reaches: 'via-tunnel' | 'via-gateway';
+}): Promise<void> => {
+  // decide whether to wake, and which cluster: ci and prod never wake; test + prep wake prep
+  const decision = getWakeDecision({
+    access: input.env,
+    ci: process.env.CI ?? null,
+  });
+  if (!decision.wake) return;
+  const env = decision.access;
 
-  // gate on a declared db tunnel: it is the signal this service reaches the shared cluster,
-  // whether it owns the db (persist-with-rds) or only invokes peers that query it (a gateway).
+  // gate a node service on a declared db tunnel: it is the signal this service reaches the shared
+  // cluster, whether it owns the db (persist-with-rds) or only invokes peers that query it (a gateway).
   // absent config = no cluster to wake; a malformed config fails loud (names the file), never silent.
-  if (!asReachesSharedClusterFromConfig({ env })) return;
+  if (input.reaches === 'via-tunnel' && !asReachesSharedClusterFromConfig({ env }))
+    return;
 
   // the wake blocks suite start on a local run, so its budget is consumer-bounded: a generous
   // default (a cold aurora-serverless-v2 resume can exceed 60s), overridable DOWN via
@@ -66,6 +75,25 @@ export const useWakeOfLivedb = async (
   }
 };
 
+/**
+ * .what = decide whether a run wakes the shared cluster, and which cluster it wakes.
+ * .why  = a pure transformer leaf: the prod refusal and the prep default are the two arms a wrong
+ *         edit turns into a capacity write against production, so they live in one named, clamped
+ *         decision rather than inline in the orchestrator.
+ *         - ci → no wake (ci wakes via its own workflow step; the local ssm path is absent there)
+ *         - prod → no wake (prod never scales to 0; a wake there is an unprompted prod write)
+ *         - test, prep, or undeclared → wake prep, the cluster both test and prep access reach
+ *           (both query the deployed prep peers); an undeclared access never falls to prod
+ */
+export const getWakeDecision = (input: {
+  access: 'test' | 'prep' | 'prod' | null;
+  ci: string | null;
+}): { wake: boolean; access: 'test' | 'prep' | 'prod' } => {
+  if (input.access === 'prod') return { wake: false, access: 'prod' };
+  if (input.ci) return { wake: false, access: 'prep' };
+  return { wake: true, access: 'prep' };
+};
+
 /**
  * .what = read the raw text of this service's `config/<env>.json`, or null when absent.
  * .why  = a communicator leaf: the sole filesystem i/o of the wake gate, named so the
@@ -165,7 +193,7 @@ const warnWakeFailed = (input: {
  * .what = decide whether an error is a wake-command failure (safe to tolerate) vs a code malfunction.
  * .why  = a pure transformer leaf: the allowlist `rule.forbid.failhide` demands. an execSync failure
  *         bears a child-process shape — a numeric `status` (a non-zero exit), a string `signal` (a
- *         timeout kill), or a string `code` (`ENOENT` for an absent binary, `ETIMEDOUT` for the cap).
+ *         timeout kill), or a `code` of `ENOENT` (an absent binary) or `ETIMEDOUT` (the cap).
  *         those are the wake failures the suite intends to tolerate. an error with none of that shape
  *         is a genuine malfunction in this module's own logic, so the catch rethrows it, never warns
  *         it away — a best-effort op still distinguishes the failures it ignores from the ones it must not.
@@ -176,6 +204,6 @@ const isWakeCommandFailure = (input: { error: unknown }): boolean => {
   const shape = error as { status?: unknown; signal?: unknown; code?: unknown };
   if (typeof shape.status === 'number') return true; // child exited non-zero
   if (typeof shape.signal === 'string') return true; // child killed by a signal (a timeout)
-  if (typeof shape.code === 'string') return true; // ENOENT (absent binary), ETIMEDOUT (cap hit)
-  return false;
+  if (shape.code === 'ENOENT' || shape.code === 'ETIMEDOUT') return true; // absent binary, cap hit
+  return false; // any other `code` (EACCES, EMFILE, …) is not a wake failure, so it rethrows
 };

package/dist/.test/assets/expo-fullusecase/declarations/practices/tests-any/best-practice/src/<star><star>/<star>.integration.test.ts.declapract.ts

@@ -1,3 +1,8 @@
-import { FileCheckType } from 'declapract';
+import { asTestKindPresenceCheck } from '../../../../../utils/asTestKindPresenceCheck';
 
-export const check = FileCheckType.EXISTS; // there should prolly be atleast one unit test per project
+// there should prolly be atleast one integration test per project, in either suffix form (#679)
+export const check = asTestKindPresenceCheck({
+  dir: 'src',
+  suffixOld: '.integration.test.ts',
+  suffixSeam: '._.intg.test.ts',
+});

package/dist/.test/assets/expo-fullusecase/declarations/practices/tests-any/best-practice/src/<star><star>/<star>.test.ts.declapract.ts

@@ -1,3 +1,7 @@
-import { FileCheckType } from 'declapract';
+import { asPresenceCheck } from '../../../../../utils/asPresenceCheck';
 
-export const check = FileCheckType.EXISTS; // there should prolly be atleast one unit test per project
+// there should prolly be atleast one unit test per project
+export const check = asPresenceCheck({
+  expected: 'at least one test file under src/ named *.test.ts',
+  hint: 'add a unit test beside the code it covers (e.g. *._.unit.test.ts)',
+});