devcontour-harness 0.1.0-alpha.5 → 0.1.0-alpha.7

package/examples/turbo-starter/harness/acceptance/generation.test.mjs

@@ -0,0 +1,54 @@
+// Gate `sdk-generation` (S02): закоммиченные OpenAPI и SDK равны выходу закреплённого генератора
+// на закоммиченных исходниках. Генератор запускается штатной командой starter; после
+// сравнения рабочее дерево возвращается к проверяемому коммиту, чтобы gate не менял
+// отслеживаемые файлы (harness проверяет это отдельно).
+//   node --test --test-reporter=junit --test-reporter-destination=<report> .harness/acceptance/generation.test.mjs
+import { after, before, test } from 'node:test';
+import assert from 'node:assert/strict';
+import { execFileSync, spawnSync } from 'node:child_process';
+
+/** Выходы генерации, которые поручение вправе менять только через генератор. */
+export const GENERATED = [
+  'apps/nest-backend/openapi',
+  'packages/client-rest-api-sdk/src/generated',
+  'packages/admin-rest-api-sdk/src/generated',
+];
+/** Штатная команда генерации starter; версия codegen закреплена в package.json SDK (защищён). */
+const GENERATOR = ['pnpm', 'rest-api-sdk:generate'];
+
+const root = process.env.FIXTURE_ROOT ?? process.cwd();
+const git = (...args) => execFileSync('git', args, { cwd: root, encoding: 'utf8' });
+let generation;
+
+before(() => {
+  // Детерминированный вход: без .env файлов starter и без сетевого update-check Prisma.
+  generation = spawnSync(GENERATOR[0], GENERATOR.slice(1), {
+    cwd: root,
+    encoding: 'utf8',
+    env: { ...process.env, DOTENV_CONFIG_PATH: '/dev/null', CHECKPOINT_DISABLE: '1' },
+    timeout: 540_000,
+  });
+});
+
+after(() => {
+  // Вернуть дерево к проверяемому коммиту: только пути генерации.
+  git('checkout', '--', ...GENERATED);
+  git('clean', '-fdq', '--', ...GENERATED);
+});
+
+test('sdk-generation: генератор завершился успешно', () => {
+  assert.equal(
+    generation.status,
+    0,
+    `${GENERATOR.join(' ')}: exit ${generation.status}\n${(generation.stderr || generation.stdout).slice(-4000)}`,
+  );
+});
+
+for (const path of GENERATED)
+  test(`sdk-generation: ${path} совпадает с выходом генератора`, () => {
+    assert.equal(generation.status, 0, 'генерация не выполнена');
+    const diff = git('diff', '--stat', '--', path).trim();
+    const untracked = git('ls-files', '--others', '--exclude-standard', '--', path).trim();
+    assert.equal(diff, '', `устаревший или изменённый вручную выход генерации:\n${diff}`);
+    assert.equal(untracked, '', `генератор создал незакоммиченные файлы:\n${untracked}`);
+  });

package/examples/turbo-starter/harness/acceptance/issued-at.test.mjs

@@ -0,0 +1,43 @@
+// Приёмочные проверки поручения `issued-at` (S01): контракт backend → OpenAPI → SDK → потребитель.
+// Поставляются примером devcontour-harness и запускаются gate `acceptance`:
+//   node --test --test-reporter=junit --test-reporter-destination=<report> .harness/acceptance/issued-at.test.mjs
+// Только встроенные модули Node: зависимостей проекта не требуется.
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+const root = process.env.FIXTURE_ROOT ?? process.cwd();
+const read = (path) => readFileSync(resolve(root, path), 'utf8');
+
+/** Тело `export interface <name> { ... }` в сгенерированном файле SDK. */
+function interfaceBody(source, name) {
+  const start = source.indexOf(`export interface ${name} {`);
+  assert.ok(start >= 0, `в SDK нет interface ${name}`);
+  return source.slice(start, source.indexOf('\n}', start));
+}
+
+for (const realm of ['client', 'admin']) {
+  test(`issued-at: ${realm} OpenAPI AccessTokenDto.issuedAt — обязательный date-time`, () => {
+    const doc = JSON.parse(read(`apps/nest-backend/openapi/${realm}.openapi.json`));
+    const schema = doc.components.schemas.AccessTokenDto;
+    assert.equal(schema.properties.issuedAt?.type, 'string');
+    assert.equal(schema.properties.issuedAt?.format, 'date-time');
+    assert.ok(schema.required.includes('issuedAt'), 'issuedAt должен быть required');
+  });
+  test(`issued-at: ${realm} SDK AccessTokenDto объявляет issuedAt: string`, () => {
+    const body = interfaceBody(
+      read(`packages/${realm}-rest-api-sdk/src/generated/data-contracts.ts`),
+      'AccessTokenDto',
+    );
+    assert.match(body, /\n\s+issuedAt: string;/);
+  });
+}
+
+test('issued-at: потребитель web использует AccessTokenDto.issuedAt из SDK', () => {
+  const path = 'apps/next-web-app/src/infra/client-api/types/access-token-issued-at.type.ts';
+  assert.ok(existsSync(resolve(root, path)), `нет ${path}`);
+  const text = read(path);
+  assert.match(text, /from '@oim\/client-rest-api-sdk\/data-contracts'/);
+  assert.match(text, /AccessTokenDto\['issuedAt'\]/);
+});

package/examples/turbo-starter/harness/acceptance/lifecycle-probe.test.mjs

@@ -0,0 +1,47 @@
+// Gate `lifecycle-probe` (S04): отмечает момент старта gate в каталоге окружения фазы
+// и ведёт себя по файлу режима S04_GATE ({"mode":"pass"|"fail"|"block"}):
+//   pass  — успех; fail — отказ проверки; block — ждать, пока процесс harness не исчезнет
+//   (сценарий прерывает его SIGKILL при активном окружении).
+//   node --test --test-reporter=junit --test-reporter-destination=.artifacts/junit/lifecycle.xml \
+//     .harness/acceptance/lifecycle-probe.test.mjs
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+const env = process.env;
+const dir = env.HARNESS_ENVIRONMENT_DIR ?? env.DEVCONTOUR_ENVIRONMENT_DIR;
+const mode =
+  env.S04_GATE && existsSync(env.S04_GATE)
+    ? JSON.parse(readFileSync(env.S04_GATE, 'utf8')).mode
+    : 'pass';
+
+test('S04 lifecycle-probe: gate стартует только в готовом окружении', async () => {
+  assert.ok(dir, 'нет каталога окружения фазы');
+  const receipt = JSON.parse(readFileSync(join(dir, 'bridge', 'receipt.json'), 'utf8'));
+  writeFileSync(
+    join(dir, 'gate-started.json'),
+    JSON.stringify({
+      at: new Date().toISOString(),
+      pid: process.pid,
+      bridge: receipt.status,
+      mode,
+    }),
+  );
+  assert.equal(receipt.status, 'ready', 'gate до ready');
+  if (mode === 'block') {
+    // Процесс harness — владелец окружения из его receipt. Его исчезновение и есть сигнал.
+    const owner = JSON.parse(readFileSync(join(dir, 'environment.json'), 'utf8')).ownerPid;
+    const alive = () => {
+      try {
+        process.kill(owner, 0);
+        return true;
+      } catch (error) {
+        return error.code === 'EPERM';
+      }
+    };
+    while (alive()) await new Promise((r) => setTimeout(r, 200));
+    assert.fail('процесс harness прерван');
+  }
+  assert.notEqual(mode, 'fail', 'проверка намеренно провалена (S04 gate failure)');
+});