ddd-ts-kit 0.0.0-stage → 0.1.1

package/dist/check/fixtures/source.d.ts

@@ -0,0 +1,3 @@
+/** A source written line by line, ending with a newline. */
+export declare function source(...lines: string[]): string;
+//# sourceMappingURL=source.d.ts.map

package/dist/check/fixtures/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/check/fixtures/source.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,wBAAgB,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEjD"}

package/dist/check/fixtures/source.js

@@ -0,0 +1,5 @@
+/** A source written line by line, ending with a newline. */
+export function source(...lines) {
+    return `${lines.join('\n')}\n`;
+}
+//# sourceMappingURL=source.js.map

package/dist/check/fixtures/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/check/fixtures/source.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,UAAU,MAAM,CAAC,GAAG,KAAe;IACvC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC"}

package/dist/check/fixtures/standard-fixtures.d.ts

@@ -0,0 +1,3 @@
+import type { Fixture } from './fixture.js';
+export declare const STANDARD_FIXTURES: readonly Fixture[];
+//# sourceMappingURL=standard-fixtures.d.ts.map

package/dist/check/fixtures/standard-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-fixtures.d.ts","sourceRoot":"","sources":["../../../src/check/fixtures/standard-fixtures.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAM5C,eAAO,MAAM,iBAAiB,EAAE,SAAS,OAAO,EAmG/C,CAAC"}

package/dist/check/fixtures/standard-fixtures.js

@@ -0,0 +1,86 @@
+import { CONFIG_FILE } from '../../config/index.js';
+import { config } from './config.js';
+import { PATHS } from './paths.js';
+import { project } from './project.js';
+const { ADAPTER, BILLING, MODULE, ROUTE } = PATHS;
+export const STANDARD_FIXTURES = [
+    {
+        ruleId: 'aspects/outside-in',
+        name: 'decorators on an adapter and in the platform, wrappers bound in the module file',
+        expect: 'pass',
+        files: project({
+            [ADAPTER]: "import { Retry } from '@ddd-ts-kit/aspects/decorators';\nexport class InMemoryInvoiceRepository {\n  @Retry({ attempts: 3 })\n  async find(): Promise<void> {}\n}\n",
+            'src/platform/payments/payment-client.ts': "import { Timeout } from '@ddd-ts-kit/aspects/decorators';\nexport class PaymentClient {\n  @Timeout(2000)\n  async charge(): Promise<void> {}\n}\n",
+            [MODULE]: "import { retry, timeout } from '@ddd-ts-kit/aspects';\nexport function billingModule(builder: Builder): void {\n  builder.bind(PaymentGateway).toClass(StripePaymentGateway, []).with(retry({ attempts: 3 }), timeout(2000));\n}\n",
+        }),
+    },
+    {
+        ruleId: 'aspects/outside-in',
+        name: 'an aspect decorator in a route',
+        expect: { file: ROUTE },
+        files: project({
+            [ROUTE]: "import { Logged } from '@ddd-ts-kit/aspects/decorators';\nexport class IssueInvoiceRoute {\n  @Logged()\n  async handle(): Promise<void> {}\n}\n",
+        }),
+    },
+    {
+        ruleId: 'aspects/outside-in',
+        name: 'an aspect decorator in the module file',
+        expect: { file: MODULE },
+        files: project({
+            [MODULE]: "import { decoratorOf } from '@ddd-ts-kit/aspects/decorators';\nexport const billingModule = decoratorOf(audited);\n",
+        }),
+    },
+    {
+        ruleId: 'aspects/outside-in',
+        name: 'an aspect decorator in the shared kernel',
+        expect: { file: 'src/shared-kernel/money.vo.ts' },
+        files: project({
+            'src/shared-kernel/money.vo.ts': "import { Cached } from '@ddd-ts-kit/aspects/decorators';\nexport class Money {}\nexport { Cached };\n",
+        }),
+    },
+    {
+        ruleId: 'standard/no-parallel-interface',
+        name: 'the kernel interfaces used and implemented under adapter names, the request context of a route, a dropped default',
+        expect: 'pass',
+        files: project({
+            [ADAPTER]: "import type { Logger, Page } from '@ddd-ts-kit/kernel';\nexport class InMemoryInvoiceRepository {\n  constructor(private readonly logger: Logger) {}\n\n  async search(): Promise<Page<string>> {\n    return { items: [] };\n  }\n}\n",
+            [`${BILLING}/infrastructure/external/pino.logger.ts`]: "import type { Logger } from '@ddd-ts-kit/kernel';\n\nexport class PinoLogger implements Logger {}\n",
+            [`${BILLING}/infrastructure/external/cache.service.ts`]: "import type { Cache } from '@ddd-ts-kit/kernel';\n\nexport class CacheService implements Cache {}\n",
+            [`${BILLING}/presentation/http/request-context.dto.ts`]: "import { type ILogger } from '@/contexts/billing/presentation/http/legacy.js';\n\nexport interface RequestContext {\n  readonly logger: ILogger;\n}\n",
+            'src/platform/current-user.ts': 'export interface CurrentUser {\n  readonly id: string;\n}\n',
+        }, { [CONFIG_FILE]: config({ standardInterfaces: { CurrentUser: false } }) }),
+    },
+    {
+        ruleId: 'standard/no-parallel-interface',
+        name: 'a home-made logger port',
+        expect: { file: `${BILLING}/application/ports/i-logger.port.ts` },
+        files: project({
+            [`${BILLING}/application/ports/i-logger.port.ts`]: 'export abstract class ILogger {\n  abstract info(message: string): void;\n}\n',
+        }),
+    },
+    {
+        ruleId: 'standard/no-parallel-interface',
+        name: 'a user context next to the execution context',
+        expect: { file: 'src/shared-kernel/user-context.ts' },
+        files: project({
+            'src/shared-kernel/user-context.ts': 'export type UserContext = Readonly<{ userId: string; tenantId: string }>;\n',
+        }),
+    },
+    {
+        ruleId: 'standard/no-parallel-interface',
+        name: 'a paginated result class, and a name added by the config',
+        expect: { file: 'src/platform/paginated-result.ts' },
+        files: project({
+            'src/platform/paginated-result.ts': 'export class PaginatedResult<T> {\n  readonly items: readonly T[] = [];\n}\n\nexport type TenantInfo = Readonly<{ tenantId: string }>;\n',
+        }, { [CONFIG_FILE]: config({ standardInterfaces: { TenantInfo: 'TenantScoped' } }) }),
+    },
+    {
+        ruleId: 'standard/no-parallel-interface',
+        name: 'a home-made scheduler, and an error reporter behind an I',
+        expect: { file: 'src/platform/cron-scheduler.ts' },
+        files: project({
+            'src/platform/cron-scheduler.ts': 'export class CronScheduler {}\n\nexport type IErrorReporter = Readonly<{ report(error: unknown): void }>;\n',
+        }),
+    },
+];
+//# sourceMappingURL=standard-fixtures.js.map

package/dist/check/fixtures/standard-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-fixtures.js","sourceRoot":"","sources":["../../../src/check/fixtures/standard-fixtures.ts"],"names":[],"mappings":"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"}

package/dist/check/fixtures/test-fixtures.d.ts

@@ -0,0 +1,3 @@
+import type { Fixture } from './fixture.js';
+export declare const TEST_FIXTURES: readonly Fixture[];
+//# sourceMappingURL=test-fixtures.d.ts.map

package/dist/check/fixtures/test-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-fixtures.d.ts","sourceRoot":"","sources":["../../../src/check/fixtures/test-fixtures.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAQ5C,eAAO,MAAM,aAAa,EAAE,SAAS,OAAO,EAwE3C,CAAC"}

package/dist/check/fixtures/test-fixtures.js

@@ -0,0 +1,77 @@
+import { CONFIG_FILE } from '../../config/index.js';
+import { aggregate } from './aggregate.js';
+import { config } from './config.js';
+import { PATHS } from './paths.js';
+import { project } from './project.js';
+import { SAMPLES } from './samples.js';
+const { AGGREGATE, AGGREGATE_SPEC, BILLING, BUILDER, CATALOG, HANDLER, HANDLER_SPEC } = PATHS;
+const { SPEC } = SAMPLES;
+export const TEST_FIXTURES = [
+    {
+        ruleId: 'test/spec-required',
+        name: 'a spec found by base name anywhere under test/',
+        expect: 'pass',
+        files: project({
+            [AGGREGATE]: 'export class Invoice {}\n',
+            [BUILDER]: 'export const anInvoice = 1;\n',
+            [`${BILLING}/test/unit/domain/invoice.aggregate.spec.ts`]: SPEC,
+            [`${BILLING}/domain/value-objects/money.vo.ts`]: 'export class Money {}\n',
+            [`${BILLING}/test/unit/money.spec.ts`]: SPEC,
+        }),
+    },
+    {
+        ruleId: 'test/spec-required',
+        name: 'an aggregate without a spec',
+        expect: { file: AGGREGATE },
+        files: project({ [AGGREGATE]: 'export class Invoice {}\n', [BUILDER]: 'export const anInvoice = 1;\n' }),
+    },
+    {
+        ruleId: 'test/spec-required',
+        name: 'a handler whose spec lives in another context',
+        expect: { file: HANDLER },
+        files: project({
+            [HANDLER]: 'export class IssueInvoiceHandler {}\n',
+            [`${CATALOG}/test/unit/issue-invoice.handler.spec.ts`]: SPEC,
+        }),
+    },
+    {
+        ruleId: 'test/no-mocks',
+        name: 'a test built on a fake',
+        expect: 'pass',
+        files: project({
+            [HANDLER]: 'export class IssueInvoiceHandler {}\n',
+            [HANDLER_SPEC]: "import { it } from 'vitest';\nconst note = 'no vi.fn() here';\n// jest.mock('x')\nit.todo(note);\n",
+        }, { [CONFIG_FILE]: config({ rules: { 'clean/no-commented-out-code': 'off' } }) }),
+    },
+    {
+        ruleId: 'test/no-mocks',
+        name: 'a test using vi.fn and vi.spyOn',
+        expect: { file: HANDLER_SPEC },
+        files: project({
+            [HANDLER]: 'export class IssueInvoiceHandler {}\n',
+            [HANDLER_SPEC]: "import { it, vi } from 'vitest';\nconst save = vi.fn();\nvi.spyOn(console, 'log');\nit.todo(String(save));\n",
+        }),
+    },
+    {
+        ruleId: 'test/no-mocks',
+        name: 'a test importing a mocking library',
+        expect: { file: HANDLER_SPEC },
+        files: project({
+            [HANDLER]: 'export class IssueInvoiceHandler {}\n',
+            [HANDLER_SPEC]: "import { it } from 'vitest';\nimport sinon from 'sinon';\nit.todo(String(sinon));\n",
+        }),
+    },
+    {
+        ruleId: 'test/builder-required',
+        name: 'an aggregate with its builder',
+        expect: 'pass',
+        files: project(aggregate('export class Invoice {}\n')),
+    },
+    {
+        ruleId: 'test/builder-required',
+        name: 'an aggregate without a builder',
+        expect: { file: AGGREGATE },
+        files: project({ [AGGREGATE]: 'export class Invoice {}\n', [AGGREGATE_SPEC]: SPEC }),
+    },
+];
+//# sourceMappingURL=test-fixtures.js.map

package/dist/check/fixtures/test-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-fixtures.js","sourceRoot":"","sources":["../../../src/check/fixtures/test-fixtures.ts"],"names":[],"mappings":"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"}

package/dist/check/fixtures/tracing-fixtures.d.ts

@@ -0,0 +1,3 @@
+import type { Fixture } from './fixture.js';
+export declare const TRACING_FIXTURES: readonly Fixture[];
+//# sourceMappingURL=tracing-fixtures.d.ts.map

package/dist/check/fixtures/tracing-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-fixtures.d.ts","sourceRoot":"","sources":["../../../src/check/fixtures/tracing-fixtures.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAa5C,eAAO,MAAM,gBAAgB,EAAE,SAAS,OAAO,EA8C9C,CAAC"}

package/dist/check/fixtures/tracing-fixtures.js

@@ -0,0 +1,55 @@
+import { CONFIG_FILE } from '../../config/index.js';
+import { config } from './config.js';
+import { handler } from './handler.js';
+import { PATHS } from './paths.js';
+import { project } from './project.js';
+const { ADAPTER, MODULE } = PATHS;
+const RULE = 'tracing/platform-only';
+const TRACING = "import { traceApplication } from '@ddd-ts-kit/tracing';\n";
+const API = "import { trace } from '@opentelemetry/api';\n";
+const SPEC = "import { installTestTracing } from '@ddd-ts-kit/tracing/testing';\nimport { it } from 'vitest';\n\nit.todo('behaves');\n";
+export const TRACING_FIXTURES = [
+    {
+        ruleId: RULE,
+        name: 'tracing wired by the platform, main.ts and the entry point of a context',
+        expect: 'pass',
+        files: project({
+            'src/platform/tracing.ts': `${TRACING}${API}import { initTracing } from '@ddd-ts-kit/tracing/node';\n\nexport const tracing = initTracing(traceApplication, trace);\n`,
+            'src/platform/tracing.spec.ts': SPEC,
+            'src/main.ts': `${TRACING}\nawait traceApplication();\n`,
+            'src/apps/billing/main.ts': `${API}\ntrace.getTracer('billing');\n`,
+        }),
+    },
+    {
+        ruleId: RULE,
+        name: 'an adapter opening a span with the OpenTelemetry API',
+        expect: { file: ADAPTER },
+        files: project({
+            [ADAPTER]: `${API}export class InMemoryInvoiceRepository {\n  readonly tracer = trace.getTracer('billing');\n}\n`,
+        }),
+    },
+    {
+        ruleId: RULE,
+        name: 'the tracing package in a module file',
+        expect: { file: MODULE },
+        files: project({ [MODULE]: `${TRACING}export const billingModule = traceApplication;\n` }),
+    },
+    {
+        ruleId: RULE,
+        name: 'the tracing package in a use case, refused by its layer too',
+        expect: { file: PATHS.HANDLER },
+        also: ['layer/application-inward'],
+        files: project(handler(`${TRACING}export class IssueInvoiceHandler {\n  readonly traced = traceApplication;\n}\n`)),
+    },
+    {
+        ruleId: RULE,
+        name: 'the test entry of the tracing package in a spec of a context, and the default directory once the platform is moved',
+        expect: { file: 'src/platform/tracing.ts' },
+        files: project({
+            [`${PATHS.BILLING}/test/unit/spans.spec.ts`]: SPEC,
+            'src/platform/tracing.ts': `${API}export const tracer = trace.getTracer('billing');\n`,
+            'src/infra-platform/tracing.ts': `${API}export const tracer = trace;\n`,
+        }, { [CONFIG_FILE]: config({ platformDir: 'src/infra-platform' }) }),
+    },
+];
+//# sourceMappingURL=tracing-fixtures.js.map

package/dist/check/fixtures/tracing-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing-fixtures.js","sourceRoot":"","sources":["../../../src/check/fixtures/tracing-fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;AAClC,MAAM,IAAI,GAAG,uBAAuB,CAAC;AACrC,MAAM,OAAO,GAAG,2DAA2D,CAAC;AAC5E,MAAM,GAAG,GAAG,+CAA+C,CAAC;AAE5D,MAAM,IAAI,GACR,0HAA0H,CAAC;AAE7H,MAAM,CAAC,MAAM,gBAAgB,GAAuB;IAClD;QACE,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,yEAAyE;QAC/E,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,OAAO,CAAC;YACb,yBAAyB,EAAE,GAAG,OAAO,GAAG,GAAG,2HAA2H;YACtK,8BAA8B,EAAE,IAAI;YACpC,aAAa,EAAE,GAAG,OAAO,+BAA+B;YACxD,0BAA0B,EAAE,GAAG,GAAG,iCAAiC;SACpE,CAAC;KACH;IACD;QACE,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,sDAAsD;QAC5D,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;QACzB,KAAK,EAAE,OAAO,CAAC;YACb,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,gGAAgG;SAClH,CAAC;KACH;IACD;QACE,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,sCAAsC;QAC5C,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;QACxB,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,kDAAkD,EAAE,CAAC;KAC3F;IACD;QACE,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,6DAA6D;QACnE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE;QAC/B,IAAI,EAAE,CAAC,0BAA0B,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,gFAAgF,CAAC,CAAC;KACpH;IACD;QACE,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,oHAAoH;QAC1H,MAAM,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE;QAC3C,KAAK,EAAE,OAAO,CACZ;YACE,CAAC,GAAG,KAAK,CAAC,OAAO,0BAA0B,CAAC,EAAE,IAAI;YAClD,yBAAyB,EAAE,GAAG,GAAG,qDAAqD;YACtF,+BAA+B,EAAE,GAAG,GAAG,gCAAgC;SACxE,EACD,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC,EAAE,CACjE;KACF;CACF,CAAC"}

package/dist/check/fixtures/tree-fixtures.d.ts

@@ -0,0 +1,3 @@
+import type { Fixture } from './fixture.js';
+export declare const TREE_FIXTURES: readonly Fixture[];
+//# sourceMappingURL=tree-fixtures.d.ts.map

package/dist/check/fixtures/tree-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-fixtures.d.ts","sourceRoot":"","sources":["../../../src/check/fixtures/tree-fixtures.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAS5C,eAAO,MAAM,aAAa,EAAE,SAAS,OAAO,EAsM3C,CAAC"}

package/dist/check/fixtures/tree-fixtures.js

@@ -0,0 +1,194 @@
+import { CONFIG_FILE } from '../../config/index.js';
+import { CONTEXT_DOC_HEADINGS } from '../canonical/context-doc-headings.js';
+import { aggregate } from './aggregate.js';
+import { config } from './config.js';
+import { contextDoc } from './context-doc.js';
+import { DECLARED } from './declared.js';
+import { declaredProject } from './declared-project.js';
+import { handler } from './handler.js';
+import { PATHS } from './paths.js';
+import { project } from './project.js';
+import { SAMPLES } from './samples.js';
+const { AGGREGATE, BARREL, BILLING, JOB, JOB_SPEC, MODULE, POLICY, ROUTES } = PATHS;
+const { SPEC } = SAMPLES;
+export const TREE_FIXTURES = [
+    {
+        ruleId: 'tree/closed',
+        name: 'canonical directories, an open use-case level and a declared extra directory',
+        expect: 'pass',
+        files: project({
+            ...handler('export class IssueInvoiceHandler {}\n'),
+            [`${BILLING}/infrastructure/messaging/outbox.ts`]: 'export const outbox = 1;\n',
+            [`${BILLING}/test/unit/domain/deep/anything.spec.ts`]: SPEC,
+            [`${BILLING}/billing.module.ts`]: 'export const billingModule = {};\n',
+        }, {
+            [CONFIG_FILE]: config({
+                contexts: {
+                    billing: {
+                        classification: 'core',
+                        upstreams: ['catalog'],
+                        extraDirectories: [{ path: 'infrastructure/messaging', reason: 'outbox relay' }],
+                    },
+                    catalog: { classification: 'supporting', upstreams: [] },
+                },
+            }),
+        }),
+    },
+    {
+        ruleId: 'tree/closed',
+        name: 'an ad hoc directory',
+        expect: { file: `${BILLING}/domain/utils` },
+        files: project({ [`${BILLING}/domain/utils/rounding.ts`]: 'export const rounding = 1;\n' }),
+    },
+    {
+        ruleId: 'tree/closed',
+        name: 'a source file outside a role directory',
+        expect: { file: `${BILLING}/domain/rounding.ts` },
+        files: project({ [`${BILLING}/domain/rounding.ts`]: 'export const rounding = 1;\n' }),
+    },
+    {
+        ruleId: 'tree/context-doc',
+        name: 'a complete CONTEXT.md',
+        expect: 'pass',
+        files: project({}),
+    },
+    {
+        ruleId: 'tree/context-doc',
+        name: 'no CONTEXT.md',
+        expect: { file: `${BILLING}/CONTEXT.md` },
+        files: (() => {
+            const { [`${BILLING}/CONTEXT.md`]: _removed, ...rest } = project({
+                [`${BILLING}/published-language/index.ts`]: 'export {};\n',
+            });
+            return rest;
+        })(),
+    },
+    {
+        ruleId: 'tree/context-doc',
+        name: 'a missing section',
+        expect: { file: `${BILLING}/CONTEXT.md` },
+        files: project({}, {
+            [`${BILLING}/CONTEXT.md`]: contextDoc('core', CONTEXT_DOC_HEADINGS.filter((heading) => heading !== '## Relationships')),
+        }),
+    },
+    {
+        ruleId: 'tree/context-doc',
+        name: 'a classification that contradicts the config',
+        expect: { file: `${BILLING}/CONTEXT.md` },
+        files: project({}, { [`${BILLING}/CONTEXT.md`]: contextDoc('generic') }),
+    },
+    {
+        ruleId: 'naming/suffix',
+        name: 'role suffixes in kebab-case',
+        expect: 'pass',
+        files: project({
+            ...aggregate('export class Invoice {}\n'),
+            [`${BILLING}/domain/errors/invoice-already-issued.error.ts`]: 'export class InvoiceAlreadyIssuedError extends Error {}\n',
+            [`${BILLING}/domain/errors/index.ts`]: "export * from '@/contexts/billing/domain/errors/invoice-already-issued.error.js';\n",
+            [`${BILLING}/presentation/http/invoice.dto.ts`]: 'export interface InvoiceDto { readonly id: string }\n',
+        }),
+    },
+    {
+        ruleId: 'naming/suffix',
+        name: 'a file without the suffix of its role',
+        expect: { file: `${BILLING}/domain/errors/invoice-already-issued.ts` },
+        files: project({
+            [`${BILLING}/domain/errors/invoice-already-issued.ts`]: 'export class InvoiceAlreadyIssued extends Error {}\n',
+        }),
+    },
+    {
+        ruleId: 'naming/suffix',
+        name: 'a file name that is not kebab-case',
+        expect: { file: `${BILLING}/domain/errors/InvoiceAlreadyIssued.error.ts` },
+        also: ['clean/one-export-per-file'],
+        files: project({
+            [`${BILLING}/domain/errors/InvoiceAlreadyIssued.error.ts`]: 'export class InvoiceAlreadyIssuedError extends Error {}\n',
+        }),
+    },
+    {
+        ruleId: 'naming/one-concept-per-file',
+        name: 'one exported class, with private helpers and types',
+        expect: 'pass',
+        files: project(aggregate('class Money {}\n\nexport interface InvoiceState {\n  readonly total: Money;\n}\n\nexport class Invoice {\n  constructor(readonly state: InvoiceState) {}\n}\n// export class Ghost {}\n'), { [CONFIG_FILE]: config({ rules: { 'clean/no-commented-out-code': 'off' } }) }),
+    },
+    {
+        ruleId: 'naming/one-concept-per-file',
+        name: 'two exported classes in an aggregate file',
+        expect: { file: AGGREGATE },
+        also: ['clean/one-export-per-file'],
+        files: project(aggregate('export class Invoice {}\nexport class IssuedInvoice {}\n')),
+    },
+    {
+        ruleId: 'naming/suffix',
+        name: 'a builder without its suffix',
+        expect: { file: `${BILLING}/test/builders/invoice.ts` },
+        files: project({ [`${BILLING}/test/builders/invoice.ts`]: 'export const anInvoice = 1;\n' }),
+    },
+    {
+        ruleId: 'naming/suffix',
+        name: 'declared style: the routes file named after the context, a result next to its command, a job',
+        expect: 'pass',
+        files: declaredProject({
+            [ROUTES]: 'export const billingRoutes = (): unknown[] => [];\n',
+            [`${BILLING}/application/commands/issue-invoice/issue-invoice.result.ts`]: 'export interface IssueInvoiceResult {\n  readonly invoiceId: string;\n}\n',
+            [JOB]: DECLARED.job,
+            [JOB_SPEC]: SPEC,
+        }),
+    },
+    {
+        ruleId: 'naming/suffix',
+        name: 'explicit style: a routes file named after the context',
+        expect: 'pass',
+        files: project({ [ROUTES]: 'export const billingRoutes = (): unknown[] => [];\n' }),
+    },
+    {
+        ruleId: 'naming/suffix',
+        name: 'a routes file named after another context',
+        expect: { file: `${BILLING}/presentation/http/shipping.routes.ts` },
+        files: project({
+            [`${BILLING}/presentation/http/shipping.routes.ts`]: 'export const shippingRoutes = (): unknown[] => [];\n',
+        }),
+    },
+    {
+        ruleId: 'naming/suffix',
+        name: 'a job without its suffix',
+        expect: { file: `${BILLING}/application/scheduling/send-reminders.ts` },
+        files: project({ [`${BILLING}/application/scheduling/send-reminders.ts`]: 'export class SendReminders {}\n' }),
+    },
+    {
+        ruleId: 'test/spec-required',
+        name: 'a job without a spec',
+        expect: { file: JOB },
+        files: declaredProject({ [JOB]: DECLARED.job }),
+    },
+    {
+        ruleId: 'tree/closed',
+        name: 'declared style: the generated barrel at the root of a context, next to a module file kept on purpose',
+        expect: 'pass',
+        files: declaredProject({ [MODULE]: 'export const billingModule = {};\n' }),
+    },
+    {
+        ruleId: 'tree/closed',
+        name: 'explicit style: a barrel of declarations at the root of a context',
+        expect: { file: BARREL },
+        files: project({ [BARREL]: 'export {};\n' }),
+    },
+    {
+        ruleId: 'naming/one-concept-per-file',
+        name: 'declared style: two declared classes in one role file',
+        expect: { file: POLICY },
+        also: ['clean/one-export-per-file'],
+        files: declaredProject({
+            [POLICY]: `${DECLARED.policy}\n@Policy(billingPermissions['invoice.issue'], { name: 'billing.only-accountant-issues' })\nexport class OnlyAccountantIssuesPolicy {}\n`,
+        }),
+    },
+    {
+        ruleId: 'naming/one-concept-per-file',
+        name: 'explicit style: a second declared class in a policy file is not counted',
+        expect: 'pass',
+        files: project({
+            [POLICY]: `${DECLARED.policy}\n@Policy(billingPermissions['invoice.issue'], { name: 'billing.only-accountant-issues' })\nclass OnlyAccountantIssuesPolicy {}\n`,
+        }),
+    },
+];
+//# sourceMappingURL=tree-fixtures.js.map

package/dist/check/fixtures/tree-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-fixtures.js","sourceRoot":"","sources":["../../../src/check/fixtures/tree-fixtures.ts"],"names":[],"mappings":"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"}

package/dist/check/fixtures/without-file.d.ts

@@ -0,0 +1,3 @@
+import type { FixtureFiles } from './fixture-files.js';
+export declare function withoutFile(files: FixtureFiles, removed: string): FixtureFiles;
+//# sourceMappingURL=without-file.d.ts.map

package/dist/check/fixtures/without-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"without-file.d.ts","sourceRoot":"","sources":["../../../src/check/fixtures/without-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAE9E"}

package/dist/check/fixtures/without-file.js

@@ -0,0 +1,4 @@
+export function withoutFile(files, removed) {
+    return Object.fromEntries(Object.entries(files).filter(([file]) => file !== removed));
+}
+//# sourceMappingURL=without-file.js.map

package/dist/check/fixtures/without-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"without-file.js","sourceRoot":"","sources":["../../../src/check/fixtures/without-file.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW,CAAC,KAAmB,EAAE,OAAe;IAC9D,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC;AACxF,CAAC"}

package/dist/check/governance/adr-directory.d.ts

@@ -0,0 +1,2 @@
+export declare const ADR_DIRECTORY = "docs/adr";
+//# sourceMappingURL=adr-directory.d.ts.map

package/dist/check/governance/adr-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr-directory.d.ts","sourceRoot":"","sources":["../../../src/check/governance/adr-directory.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,aAAa,CAAC"}

package/dist/check/governance/adr-directory.js

@@ -0,0 +1,2 @@
+export const ADR_DIRECTORY = 'docs/adr';
+//# sourceMappingURL=adr-directory.js.map

package/dist/check/governance/adr-directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr-directory.js","sourceRoot":"","sources":["../../../src/check/governance/adr-directory.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC"}

package/dist/check/governance/decision-records.d.ts

@@ -0,0 +1,9 @@
+/** The decision records of a project, `docs/adr/<number>-<slug>.md`, listed once and only when asked. */
+export declare class DecisionRecords {
+    private readonly root;
+    private numbers;
+    constructor(root: string);
+    has(number: number): boolean;
+    private list;
+}
+//# sourceMappingURL=decision-records.d.ts.map

package/dist/check/governance/decision-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-records.d.ts","sourceRoot":"","sources":["../../../src/check/governance/decision-records.ts"],"names":[],"mappings":"AAOA,yGAAyG;AACzG,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,OAAO,CAAkC;IAEjD,YAA6B,IAAI,EAAE,MAAM,EAAI;IAE7C,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAI3B;IAED,OAAO,CAAC,IAAI;CASb"}

package/dist/check/governance/decision-records.js

@@ -0,0 +1,27 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { ADR_DIRECTORY } from './adr-directory.js';
+import { recordNumber } from './record-number.js';
+const RECORD_FILE = /^(\d+)-.+\.md$/;
+/** The decision records of a project, `docs/adr/<number>-<slug>.md`, listed once and only when asked. */
+export class DecisionRecords {
+    root;
+    numbers;
+    constructor(root) {
+        this.root = root;
+    }
+    has(number) {
+        this.numbers ??= this.list();
+        return this.numbers.has(number);
+    }
+    list() {
+        try {
+            const entries = fs.readdirSync(path.join(this.root, ADR_DIRECTORY));
+            return new Set(entries.flatMap((entry) => recordNumber(RECORD_FILE.exec(entry)?.[1] ?? '') ?? []));
+        }
+        catch {
+            return new Set();
+        }
+    }
+}
+//# sourceMappingURL=decision-records.js.map

package/dist/check/governance/decision-records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-records.js","sourceRoot":"","sources":["../../../src/check/governance/decision-records.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAErC,yGAAyG;AACzG,MAAM,OAAO,eAAe;IAGG,IAAI;IAFzB,OAAO,CAAkC;IAEjD,YAA6B,IAAY;oBAAZ,IAAI;IAAW,CAAC;IAE7C,GAAG,CAAC,MAAc;QAChB,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAEO,IAAI;QACV,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;YAEpE,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACrG,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,GAAG,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;CACF"}

package/dist/check/governance/record-number.d.ts

@@ -0,0 +1,3 @@
+/** The number held by the `adr` field of a deviation: its first run of digits (`7`, `0007`, `ADR-0007`, `docs/adr/0007-slug.md`). */
+export declare function recordNumber(field: string): number | undefined;
+//# sourceMappingURL=record-number.d.ts.map

package/dist/check/governance/record-number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-number.d.ts","sourceRoot":"","sources":["../../../src/check/governance/record-number.ts"],"names":[],"mappings":"AAAA,qIAAqI;AACrI,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI9D"}

package/dist/check/governance/record-number.js

@@ -0,0 +1,6 @@
+/** The number held by the `adr` field of a deviation: its first run of digits (`7`, `0007`, `ADR-0007`, `docs/adr/0007-slug.md`). */
+export function recordNumber(field) {
+    const digits = /\d+/.exec(field)?.[0];
+    return digits === undefined ? undefined : Number.parseInt(digits, 10);
+}
+//# sourceMappingURL=record-number.js.map

package/dist/check/governance/record-number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-number.js","sourceRoot":"","sources":["../../../src/check/governance/record-number.ts"],"names":[],"mappings":"AAAA,qIAAqI;AACrI,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEtC,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACxE,CAAC"}

package/dist/check/governance/referenced-record.d.ts

@@ -0,0 +1,3 @@
+/** The number of the first decision record a free text refers to: `ADR-0007`, `ADR-7`, `ADR 7`, `adr7`, `docs/adr/0007-slug.md`. */
+export declare function referencedRecord(text: string): number | undefined;
+//# sourceMappingURL=referenced-record.d.ts.map

package/dist/check/governance/referenced-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referenced-record.d.ts","sourceRoot":"","sources":["../../../src/check/governance/referenced-record.ts"],"names":[],"mappings":"AAEA,oIAAoI;AACpI,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIjE"}

package/dist/check/governance/referenced-record.js

@@ -0,0 +1,7 @@
+const REFERENCE = /\badr[-/ ]?(\d+)/i;
+/** The number of the first decision record a free text refers to: `ADR-0007`, `ADR-7`, `ADR 7`, `adr7`, `docs/adr/0007-slug.md`. */
+export function referencedRecord(text) {
+    const digits = REFERENCE.exec(text)?.[1];
+    return digits === undefined ? undefined : Number.parseInt(digits, 10);
+}
+//# sourceMappingURL=referenced-record.js.map