chore(review): 1106 검사 범위 조치 브랜치를 합친다

This commit is contained in:
DongHyeonka
2026-11-06 07:02:34 +09:00
11 changed files with 317 additions and 15 deletions
+4 -1
View File
@@ -74,7 +74,10 @@ What the automated run scans:
no alert box is on screen, so a list page is scanned in its empty state. A
read of one resource (a detail page) has no generic answer: that route is
scanned in its failure state and the run records an `a11y-data-state`
annotation.
annotation. `a11y.json` lists it under `notChecked`. When a protected
route's `paramsSchema` is the input of such a read, the report expects that
record from the descriptors alone and fails without it
(`scripts/write-a11y-report.ts`).
- The reference sample's list in its success, empty and error states, its
detail, its form with submit errors and its status page, each after that
state is on screen (`tests/e2e/reference-form.spec.ts`, removed with the
+5 -2
View File
@@ -269,6 +269,7 @@ DTO와 problem details(`type`·`title`·`status`)를 감싸지 않고 보내는
- `boundary`: descriptor의 입력·응답·실패 검증기와 라우트의 `paramsSchema`·`searchSchema`에서 쓰인 자리로 정해진다. 다르면 `<schemaId>: row <적은 값>, used as <맞는 값>`으로 실패한다. 쓰이는데 행이 없으면 `<schemaId>: no FE-REG-SCHEMA row`.
- `direction`: 입력은 `REQUEST`, 응답·실패는 `RESPONSE`.
- `unknownFieldPolicy`: zod가 모르는 키를 거부하면(`.strict()`) `REJECT_UNKNOWN`, 버리면(`.strip()`) `STRIP_UNKNOWN`.
- descriptor의 입력·응답·실패 검증기로 쓰인 스키마의 행은 `direction`·`unknownFieldPolicy`를 빼지 않는다. 빼면 `row states no direction` 또는 `row states no unknownFieldPolicy`로 실패한다(1106/07-02). 칸이 없으면 응답 DTO를 `.strict()`로 바꿔도 행이 바뀌지 않아 `check:registries`가 breaking으로 보지 못한다. 라우트에만 쓰이는 행은 두 칸이 없어도 된다.
- 이 테스트는 설치된 기능을 읽는다. 기능을 더한 상태에서 `test:unit`을 돌릴 때 잡힌다.
예: 공지 기능의 검색값 GET과 경로 파라미터 GET. 입력에 관한 칸과 응답 모양 줄만 적었다.
@@ -431,6 +432,7 @@ projectRequest: (input) => Object.freeze({
- 이 spec은 등록된 모든 라우트를 열어 axe로 검사한다. 경로 파라미터는 이름과 상관없이 모두 `a11y-1`로 바꾼다. 파라미터 스키마가 이 값을 거부하면 기능 페이지 대신 잘못된 경로 화면을 검사하므로, id 스키마는 짧은 영문·숫자 문자열을 받게 둔다.
- API 요청은 설치된 descriptor에서 method와 `pathTemplate`으로 찾아 답한다. 목록 조회에는 빈 목록을 그 operation의 모양(`responseEnvelope: "ENVELOPE_V1"`이면 Envelope)으로 답한다. 그 뒤 경고 상자(`role="alert"`)가 없는지 본다. 그래서 목록 페이지는 빈 상태로 검사된다.
- 한 자원을 읽는 조회(경로 파라미터가 있고 빈 목록을 받지 않는 GET)에는 빈 목록 말고 답할 것이 없다. 그래서 상세 페이지는 실패 상태로 그려지고, 테스트 결과에 `a11y-data-state` annotation이 남는다.
- `a11y.json`은 그 라우트를 통과(`scope`)가 아니라 `notChecked`에 적는다. report(`scripts/write-a11y-report.ts`)는 라우트의 `paramsSchema`가 그런 GET의 입력 스키마이면 descriptor만 보고 그 라우트를 `notChecked`로 기대한다. spec이 기록을 남기지 않으면 `a11y.json not written:`으로 실패한다(1106/11-01). 생성 명령의 상세 라우트는 GET과 같은 `<Pascal>Params`를 쓰므로 이 규칙에 든다.
- 설치된 GET이 아닌 요청을 그리기 전에 보내면 spec이 실패한다(`requests no installed list or single-resource read answers`).
- spec은 h1이 보일 때까지 기다린다. 그래서 상세 페이지는 데이터가 없을 때도 h1을 그린다. 예: `heading={{ title: notice?.title ?? message("notice.detail.titlePending") }}`처럼 데이터가 없으면 고정 제목("공지")을 쓴다.
- 기능이 앱 홈(`/`)을 대신하려면 route ID `APP_HOME`을 쓴다. `docs/architecture/starter-experience.md`의 "Product home and layouts" 절을 본다.
@@ -656,10 +658,11 @@ corepack pnpm test:sample-removal -- --feature=invoice-feature
③ **잡는 검사 / 못 잡는 것**
- 남은 파일이 지운 기능을 가리키면 실패한다. `src`는 기능 ID나 폴더 이름을 담은 파일, `tests`는 이름에 기능 ID가 있거나 기능 폴더에서 import하는 파일이다.
- 남은 파일이 지운 기능을 가리키면 실패한다. `src`는 기능 ID나 폴더 이름을 담은 파일, `tests`는 이름에 기능 ID가 있거나 기능 폴더에서 import하는 파일, 그리고 본문에 기능 ID나 폴더 이름을 한 이름으로 적은 Playwright spec(`*.spec.ts`)이다.
- 메시지: `<id> removal failed:` 다음 줄 `fixture-id-residue: residue: <files>`
- 템플릿 테스트가 예시 ID(`invoice-feature` 등)를 데이터로 쓰는 것은 잔여로 세지 않는다(1105/16-04). 그래서 매뉴얼 예시 이름으로 만든 기능도 이 단계를 통과한다.
- **못 잡음**: 기능을 가리키지 않는 폴더 밖 파일. 예: route ID만 적은 e2e spec, `artifacts/tests/a11y-manual/<ROUTE_ID>.md`. `tests` 안에서 기능 ID를 글자로만 적은 테스트도 잔여로 세지 않는다. 그 테스트가 지운 기능에 기대면 같은 드릴의 `test:all`이 실패한다. 드릴은 `src`와 `tests`만 찾고, a11y 기록은 남아도 검사가 실패하지 않는다.
- spec 본문은 이름 단위로 찾는다(1106/16-01). `test.describe("invoice-feature", …)`는 잔여이고, `product-feature`를 지울 때 `generate-product-feature-index.ts`처럼 더 긴 이름 안에 든 것은 잔여가 아니다. spec은 `test:all`(vitest)도 드릴의 다른 단계도 돌리지 않으므로 이 검사가 아니면 다음 CI의 브라우저 게이트에서야 실패한다.
- **못 잡음**: 기능을 가리키지 않는 폴더 밖 파일. 예: route ID나 URL만 적은 e2e spec, `artifacts/tests/a11y-manual/<ROUTE_ID>.md`. 기능 전용 spec은 [03 문서](03-outside-feature-folder.md)의 목록대로 손으로 지운다. vitest 테스트(`*.test.ts`) 안에서 기능 ID를 글자로만 적은 것도 잔여로 세지 않는다. 그 테스트가 지운 기능에 기대면 같은 드릴의 `test:all`이 실패한다. 드릴은 `src`와 `tests`만 찾고, a11y 기록은 남아도 검사가 실패하지 않는다.
④ **쓸 스킬**: `documentation-and-adrs`, `deprecation-and-migration`
+3 -1
View File
@@ -86,6 +86,7 @@ lint / check:architecture / check:i18n → FE-GATE-002, FE-GATE-010
| `duplicate operation: <operationId>` (계약 조립 오류의 `reason`) | operation ID 중복 | `contracts/<base>-contract-contribution.ts`. 접두어를 붙인다 |
| `FE-REG-API.<operationId>.requestSchema references unknown FE-REG-SCHEMA.schemaId=<id>` | descriptor의 입력 스키마 ID가 스키마 메타데이터에 없다 (`responseSchema`, `problemSchema`도 같은 꼴. 실패 본문 행은 `boundary: "api-problem"`) | `contracts/<base>-schema-metadata.ts` |
| `<schemaId>: row <boundary>, used as <boundary>` (`tests/unit/schema-metadata-policy.test.ts`) | 스키마 메타 행의 `boundary`가 그 스키마가 쓰인 자리와 다르다. `no FE-REG-SCHEMA row`는 쓰이는데 행이 없다 | `contracts/<base>-schema-metadata.ts` |
| `<operationId> <schemaId>: row states no direction, used as <direction>` 또는 `row states no unknownFieldPolicy, validator <policy>` (`tests/unit/schema-metadata-policy.test.ts`) | descriptor가 쓰는 스키마의 행이 `direction`·`unknownFieldPolicy`를 적지 않았다(1106/07-02) | `contracts/<base>-schema-metadata.ts`에 두 칸을 적는다. 값은 쓰인 자리와 검증기가 정한다 |
| `Unregistered route codec: <codecId>` | URL 함수가 기능 codec을 `buildRouteUrl`에 넘기지 않았다 | `presentation/<base>-routes.ts` |
| `contract package <packageId> is declared, but no loaded contribution pins it` | 계약 `contractPackages`에 적은 패키지를 계약 기여가 쓰지 않는다 | `contracts/<base>-contract-contribution.ts`의 `source` |
| `<id> contributes contract package <packageId>, which no installed feature declares in contracts.contractPackages` | 계약 기여의 신원과 계약 선언의 신원이 다르다 | 둘 다 `<BASE>_CONTRACT_PACKAGE` 하나를 쓰게 한다 |
@@ -177,6 +178,7 @@ lint / check:architecture / check:i18n → FE-GATE-002, FE-GATE-010
|---|---|---|
| `artifacts/tests/a11y-manual/ has no record for route IDs: <ids>` (`verify:documentation`) | 라우트의 a11y 기록 파일이 없다 | 기존 pending 기록을 복사해 제목과 `Route ID`를 바꾼다 |
| `Manual accessibility record format is invalid:` 다음 `artifacts/tests/a11y-manual/<ROUTE_ID>.md: missing record` (FE-GATE-009) | 같은 원인 | 같은 곳 |
| `a11y.json not written:` 다음 `a11y: <ROUTE_ID> reads one resource (<operationId>) but has no failure-state record in artifacts/tests/a11y-data-state` (`test:a11y`, FE-GATE-009) | 라우트의 `paramsSchema`가 한 자원을 읽는 GET의 입력인데, 접근성 spec이 그 라우트를 실패 화면으로만 봤다는 기록을 남기지 않았다(1106/11-01). 그대로면 `a11y.json`이 그 라우트를 통과로 센다 | `tests/e2e/accessibility.spec.ts`의 기록 호출(`recordA11yDataState`). 기능 파일은 고치지 않는다 |
| `Manual accessibility evidence is incomplete:` 다음 `<ROUTE_ID>: <failures>` (FE-GATE-028) | 서명하지 않은 기록 | [03 문서](../03-outside-feature-folder.md#수동-접근성-검토-서명) |
| `release IDs do not match` (FE-GATE-028) | 라우트마다 다른 릴리스로 검토했다 | 같은 릴리스 후보로 다시 검토한다 |
| `<doc> names paths that do not exist: <paths>` (`verify:documentation`) | 문서가 없는 경로를 적었다 | 그 문서 |
@@ -196,6 +198,6 @@ lint / check:architecture / check:i18n → FE-GATE-002, FE-GATE-010
| 메시지 | 원인 | 고칠 곳 |
|---|---|---|
| `<id> removal failed:` 다음 `fixture-id-residue: residue: <files>` (`test:sample-removal`) | 기능을 지운 뒤에도 그 기능을 가리키는 파일이 남았다. `src`는 기능 ID나 폴더 이름을 담은 파일, `tests`는 이름이 기능 ID를 담거나 기능 폴더(`src/features/<id>/`, `tests/features/<id>/`)에서 import하는 파일이다 | 그 파일을 기능 폴더 안으로 옮기거나, 기능을 가리키지 않게 한다. 목록에 템플릿 파일이 나오면 템플릿 결함이다. 그 파일을 고치지 말고 템플릿에 알린다 |
| `<id> removal failed:` 다음 `fixture-id-residue: residue: <files>` (`test:sample-removal`) | 기능을 지운 뒤에도 그 기능을 가리키는 파일이 남았다. `src`는 기능 ID나 폴더 이름을 담은 파일, `tests`는 이름이 기능 ID를 담거나 기능 폴더(`src/features/<id>/`, `tests/features/<id>/`)에서 import하는 파일, 본문에 기능 ID나 폴더 이름을 한 이름으로 적은 Playwright spec(`*.spec.ts`)이다 | 그 파일을 기능 폴더 안으로 옮기거나, 기능을 가리키지 않게 한다. 지운 기능 전용 spec이면 지운다. 목록에 템플릿 파일이 나오면 템플릿 결함이다. 그 파일을 고치지 말고 템플릿에 알린다 |
| `No installed feature declares FEATURE_MODULE_ID "<id>"` | `--feature=`에 없는 기능 ID | 명령 인자 |
| `feature scaffold failed:` 다음 `<check>: <failure>` (`test:feature-scaffold`) | 생성한 기능이 게이트 하나를 통과하지 못했다 | `scripts/create-feature.ts`의 템플릿. 제품 팀이 아니라 템플릿을 고칠 일이다 |
+88
View File
@@ -14,6 +14,12 @@ import path from "node:path";
* only the failure state, no record otherwise. A route's latest run therefore
* decides. `scripts/write-a11y-report.ts` reads the records and reports those
* routes under `notChecked` instead of in the passed `scope`.
*
* 1106/11-01. No record used to mean "checked", and nothing but the spec said
* which routes needed one: a record call changed to `null` (review 11-R2) put
* the detail page back in `scope` and every check passed. The report now
* works the same routes out from the installed descriptors
* (`oneResourceReadRoutes`) and fails when one has no record.
*/
export const A11Y_DATA_STATE_DIRECTORY = "artifacts/tests/a11y-data-state";
@@ -74,6 +80,88 @@ export async function readA11yNotCheckedRoutes(
return Object.freeze(notChecked);
}
export type OneResourceRoute = Readonly<{
routeId: string;
operationIds: readonly string[];
}>;
type RouteFacts = Readonly<{
routeId: string;
access: string;
paramsSchema: string | null;
}>;
type ReadFacts = Readonly<{
contract: Readonly<{
operationId: string;
method: string;
pathTemplate: string;
inputValidator: Readonly<{ schemaId: string }>;
outputValidator: Readonly<{
safeParse(value: unknown): Readonly<{ success: boolean }>;
}>;
}>;
}>;
/**
* 1106/11-01. The installed routes the spec can scan only on their failure
* state, from the descriptors alone: a protected route whose `paramsSchema` is
* the input of a GET that reads one resource. A GET reads one resource by the
* rule `tests/e2e/support/installed-api-answers.ts` answers with: it has a
* path parameter and its output rejects an empty list, so no generic body
* answers it. The spec signs in only on protected routes, so a public route is
* not listed.
*
* This finds the detail pages that take their params schema from their read
* (the reference sample and every `create:feature --with-create` slice). A
* detail page whose params schema differs is not found, and its record alone
* decides, as before.
*/
export function oneResourceReadRoutes(
routes: Iterable<RouteFacts>,
operations: Iterable<ReadFacts>,
): readonly OneResourceRoute[] {
const readsByInput = new Map<string, string[]>();
for (const { contract } of operations) {
if (contract.method !== "GET" || !contract.pathTemplate.includes("{")) continue;
if (contract.outputValidator.safeParse([]).success) continue;
const reads = readsByInput.get(contract.inputValidator.schemaId) ?? [];
reads.push(contract.operationId);
readsByInput.set(contract.inputValidator.schemaId, reads);
}
const found: OneResourceRoute[] = [];
for (const route of routes) {
if (route.access !== "session-required" || route.paramsSchema === null) continue;
const reads = readsByInput.get(route.paramsSchema);
if (reads === undefined) continue;
found.push(
Object.freeze({ routeId: route.routeId, operationIds: Object.freeze([...reads]) }),
);
}
return Object.freeze(found);
}
/**
* 1106/11-01. One line for each route in `expected` that `notChecked` leaves
* out, which `a11y.json` would count as passed. Empty when every route that
* reads one resource has its failure-state record. A record for a route not in
* `expected` claims less and is not refused.
*/
export function oneResourceRoutesCountedAsChecked(
expected: readonly OneResourceRoute[],
notChecked: readonly A11yNotCheckedRoute[],
): readonly string[] {
const recorded = new Set(notChecked.map(({ routeId }) => routeId));
return Object.freeze(
expected
.filter(({ routeId }) => !recorded.has(routeId))
.map(
({ routeId, operationIds }) =>
`${routeId} reads one resource (${operationIds.join(", ")}) but has no failure-state record in ${A11Y_DATA_STATE_DIRECTORY}; tests/e2e/accessibility.spec.ts must record why it scanned the route on its failure state only`,
),
);
}
/**
* The `artifacts/tests/a11y.json` value. `automatedStatus: "passed"` speaks
* for `scope` only: the installed routes axe scanned in their own state.
+24 -7
View File
@@ -11,13 +11,21 @@ import path from "node:path";
* there is a reference the type checker cannot see (a catalog key, a
* runtime override, a link).
* - `tests/`: a file named after the feature, or one that imports from the
* feature's `src/features/<dir>/` or `tests/features/<dir>/`. The test
* text is not searched for the bare name: the template's own tests use
* example IDs as data (`tests/unit/create-feature.test.ts` writes
* feature's `src/features/<dir>/` or `tests/features/<dir>/`. A vitest
* test's text is not searched for the bare name: the template's own tests
* use example IDs as data (`tests/unit/create-feature.test.ts` writes
* `invoice-feature`, the manual's example, 51 times), and the drill flagged
* them as residue of a product feature that took that name. A test that
* still depends on the removed feature fails `test:all`, which the drill
* runs.
* them as residue of a product feature that took that name. A vitest test
* that still depends on the removed feature fails `test:all`, which the
* drill runs.
* - 1106/16-01. `test:all` runs vitest only (the `*.test.ts(x)` files under
* `tests/`, vitest.config.ts), and no step of the drill runs a Playwright
* spec. So a spec (`*.spec.ts`) that names the feature only in its text,
* such as `test.describe("invoice-feature", ...)`, is residue: its text is
* searched for the ID or folder name as a whole kebab-case name. A longer
* name that contains it (`generate-product-feature-index.ts` for
* `product-feature`) does not count. A spec that names only the feature's
* routes or URLs is not found; 03's hand list removes the feature's specs.
*
* The reference sample keeps its own, wider pattern in
* scripts/test-sample-removal.ts: the template owns all of its files.
@@ -48,6 +56,8 @@ export async function productFeatureResidue(
String.raw`(?:\bfrom\s*|\bimport\s*\(\s*|\bimport\s+|\bmock\s*\(\s*)["'][^"'\n]*/features/(?:${names})/`,
"u",
);
const wholeName = new RegExp(`(?<![A-Za-z0-9-])(?:${names})(?![A-Za-z0-9-])`, "iu");
const playwrightSpec = /\.spec\.[cm]?[jt]sx?$/u;
const residue: string[] = [];
const relative = (file: string) => path.relative(root, file).split(path.sep).join("/");
for (const file of await filesUnder(path.join(root, "src"))) {
@@ -56,7 +66,14 @@ export async function productFeatureResidue(
}
for (const file of await filesUnder(path.join(root, "tests"))) {
const name = relative(file);
if (named.test(name) || imported.test(await readFile(file, "utf8"))) residue.push(name);
const text = await readFile(file, "utf8");
if (
named.test(name) ||
imported.test(text) ||
(playwrightSpec.test(name) && wholeName.test(text))
) {
residue.push(name);
}
}
return residue.sort();
}
+20
View File
@@ -1,8 +1,12 @@
import { mkdir } from "node:fs/promises";
import { ROUTE_REGISTRY } from "../src/features/installed-feature-contracts.ts";
import { COMPOSED_CONTRACT_CONTRIBUTIONS } from "../src/features/loaded-feature-runtimes.ts";
import { automatedA11yArtifactSchema } from "./contracts/release-artifacts.ts";
import {
automatedA11yReport,
oneResourceReadRoutes,
oneResourceRoutesCountedAsChecked,
readA11yNotCheckedRoutes,
} from "./lib/a11y-data-state.ts";
import { MANUAL_A11Y_ROUTE_IDS } from "./lib/manual-a11y-evidence.ts";
@@ -12,6 +16,22 @@ await mkdir("artifacts/tests", { recursive: true });
// 1103/11-01. Routes the spec scanned only on their failure state are not
// reported as passed.
const notChecked = await readA11yNotCheckedRoutes(MANUAL_A11Y_ROUTE_IDS);
// 1106/11-01. The records come from the spec alone. The descriptors say which
// routes need one, so a record call the spec lost fails here instead of
// counting a detail page as passed.
const countedAsChecked = oneResourceRoutesCountedAsChecked(
oneResourceReadRoutes(
Object.values(ROUTE_REGISTRY),
COMPOSED_CONTRACT_CONTRIBUTIONS.httpByOperationId.values(),
),
notChecked,
);
if (countedAsChecked.length > 0) {
process.stderr.write(
`a11y.json not written:\n${countedAsChecked.map((line) => `a11y: ${line}`).join("\n")}\n`,
);
process.exit(1);
}
await writeValidatedJsonArtifact({
path: "artifacts/tests/a11y.json",
schema: automatedA11yArtifactSchema,
+4
View File
@@ -40,6 +40,10 @@ for (const definition of ROUTES) {
test(`@a11y ${route} has no critical or serious axe violations`, async ({
page,
}) => {
// 1106/11-01. An earlier run's record never outlives this run, even when
// no record call below is reached. scripts/write-a11y-report.ts then
// fails on a route the descriptors say reads one resource.
await recordA11yDataState(definition.routeId, null);
const heading = page.getByRole("heading", { level: 1 });
if (definition.access === "session-required") {
// 1103/11-01. Feature data is not this spec's subject: a list read gets
@@ -23,6 +23,7 @@ import { REFERENCE_FEATURE_ROUTE_CODECS } from "../../../src/features/reference-
import type { ReferenceFeatureInput } from "../../../src/features/reference-feature/application/reference-feature-api.ts";
import { createTestApplication } from "../../helpers/create-test-application.ts";
import { createReferenceFeatureInstalledInput } from "../../../src/features/reference-feature/adapters/create-reference-feature-input.ts";
import { oneResourceReadRoutes } from "../../../scripts/lib/a11y-data-state.ts";
describe("reference feature boundary contracts", () => {
it("propagates uncertain command effect certainty into the application failure", async () => {
@@ -138,6 +139,23 @@ describe("reference feature boundary contracts", () => {
);
});
// 1106/11-01. scripts/write-a11y-report.ts fails when a11y.json would count
// these routes as passed: the accessibility spec has no generic answer for a
// read of one resource and scans the page on its failure state only.
it("has one detail page the a11y report expects under notChecked", () => {
expect(
oneResourceReadRoutes(
Object.values(REFERENCE_FEATURE_CONTRACT.routes),
REFERENCE_FEATURE_TEMPLATE_CONTRIBUTION.http,
),
).toEqual([
{
routeId: "REFERENCE_RESOURCE_DETAIL",
operationIds: ["GET_REFERENCE_RESOURCE"],
},
]);
});
it("contributes an identity-based invalidation graph and an explicit wire version", () => {
expect(REFERENCE_FEATURE_CONTRACT.invalidation).toEqual({
topics: [REFERENCE_RESOURCE_INVALIDATION_TOPIC],
+96
View File
@@ -7,6 +7,8 @@ import { afterEach, describe, expect, it } from "vitest";
import { automatedA11yArtifactSchema } from "../../scripts/contracts/release-artifacts.ts";
import {
automatedA11yReport,
oneResourceReadRoutes,
oneResourceRoutesCountedAsChecked,
readA11yNotCheckedRoutes,
recordA11yDataState,
} from "../../scripts/lib/a11y-data-state.ts";
@@ -99,3 +101,97 @@ describe("automated accessibility report", () => {
).toBe(false);
});
});
/**
* 1106/11-01. Which routes need a failure-state record comes from the
* descriptors, not from the spec that writes the records. Review 11-R2 passed
* `null` for the detail page's record and every check passed.
*/
describe("routes the accessibility spec can scan only on their failure state", () => {
const read = (
operationId: string,
method: string,
pathTemplate: string,
inputSchemaId: string,
acceptsEmptyList: boolean,
) => ({
contract: {
operationId,
method,
pathTemplate,
inputValidator: { schemaId: inputSchemaId },
outputValidator: {
safeParse: (value: unknown) => ({
success: acceptsEmptyList && Array.isArray(value),
}),
},
},
});
const route = (
routeId: string,
access: string,
paramsSchema: string | null,
) => ({ routeId, access, paramsSchema });
it("finds a protected route whose params are the input of a read of one resource", () => {
expect(
oneResourceReadRoutes(
[
route("THING_LIST", "session-required", null),
route("THING_DETAIL", "session-required", "ThingParams"),
route("THING_PARTS", "session-required", "ThingPartsParams"),
route("THING_EDIT", "session-required", "ThingEditParams"),
route("PUBLIC_THING", "public", "ThingParams"),
],
[
read("LIST_THINGS", "GET", "/api/things", "ThingListQuery", true),
read("GET_THING", "GET", "/api/things/{thingId}", "ThingParams", false),
// A list under a path parameter gets the empty list.
read("LIST_THING_PARTS", "GET", "/api/things/{thingId}/parts", "ThingPartsParams", true),
// Not a read.
read("DELETE_THING", "DELETE", "/api/things/{thingId}", "ThingEditParams", false),
],
),
).toEqual([{ routeId: "THING_DETAIL", operationIds: ["GET_THING"] }]);
});
it("refuses records that count such a route as checked", async () => {
const directory = await recordDirectory();
const expected = [
{ routeId: FAILURE_STATE_ROUTE, operationIds: ["TEST_GET_ENTITY"] },
];
// 11-R2: the spec recorded the route as scanned in its own state.
await recordA11yDataState(FAILURE_STATE_ROUTE, null, directory);
expect(
oneResourceRoutesCountedAsChecked(
expected,
await readA11yNotCheckedRoutes(ROUTES, directory),
),
).toEqual([
expect.stringContaining(
`${FAILURE_STATE_ROUTE} reads one resource (TEST_GET_ENTITY) but has no failure-state record`,
),
]);
await recordA11yDataState(FAILURE_STATE_ROUTE, REASON, directory);
expect(
oneResourceRoutesCountedAsChecked(
expected,
await readA11yNotCheckedRoutes(ROUTES, directory),
),
).toEqual([]);
});
it("does not refuse a record for a route the descriptors do not name", async () => {
const directory = await recordDirectory();
await recordA11yDataState(FAILURE_STATE_ROUTE, REASON, directory);
expect(
oneResourceRoutesCountedAsChecked(
[],
await readA11yNotCheckedRoutes(ROUTES, directory),
),
).toEqual([]);
});
});
+41
View File
@@ -59,6 +59,47 @@ describe("product feature residue (1105/16-04)", () => {
]);
});
// 1106/16-01. test:all is vitest only and the drill runs no Playwright
// spec, so a spec that names the removed feature in its text and nowhere
// else was caught by no step.
it("counts a Playwright spec that names the feature only in its text", async () => {
const spec = [
`test.describe("${ID}", () => {`,
' test("opens", async ({ page }) => {',
' await page.goto("/invoice");',
" });",
"});",
"",
].join("\n");
const root = await fixture({
"tests/e2e/checkout.spec.ts": spec,
"tests/visual/billing.visual.spec.ts": `const FEATURE = '${ID}';\n`,
// The same text in a vitest test is data (1105/16-04).
"tests/unit/checkout.test.ts": spec,
"tests/e2e/route-only.spec.ts": 'test("opens", ({ page }) => page.goto("/invoice"));\n',
});
expect(await productFeatureResidue(root, ID, ID)).toEqual([
"tests/e2e/checkout.spec.ts",
"tests/visual/billing.visual.spec.ts",
]);
});
it("does not count a spec whose longer names only contain the ID", async () => {
const root = await fixture({
"tests/e2e/builds.spec.ts": [
'run("scripts/generate-product-feature-index.ts");',
'const attribute = "data-product-feature";',
'const registry = "product-features";',
"",
].join("\n"),
});
expect(
await productFeatureResidue(root, "product-feature", "product-feature"),
).toEqual([]);
});
it("matches the folder name as well as the ID", async () => {
const root = await fixture({
"src/contracts/leftover.ts": 'export const DIRECTORY = "invoices";\n',
+14 -4
View File
@@ -21,6 +21,13 @@ import {
* `unrecognized_keys` rejects unknown fields; one that reaches the object
* without that issue tolerates them. A nested object below that level is not
* probed.
*
* 1106/07-02. Both fields are optional in the row type, and a row that left
* them out used to be skipped here. 1105/07-02 grades a response row whose
* policy turns `REJECT_UNKNOWN` as breaking, but a row with no policy does not
* change when its DTO turns `.strict()`, so nothing saw it. A schema an HTTP
* operation uses now fails here without them. Route-only rows (`NotFoundSplat`)
* are not in `slots` and still need neither.
*/
const PROBE_KEY = "__unknownFieldProbe";
@@ -127,9 +134,11 @@ describe("FE-REG-SCHEMA policy of the installed HTTP schemas (1103/07-03)", () =
it("declares the direction each schema is used in", () => {
const wrong = slots.flatMap(({ operationId, direction, validator }) => {
const declared = SCHEMA_REGISTRY[validator.schemaId]?.direction;
return declared === undefined || declared === direction
return declared === direction
? []
: [`${operationId} ${validator.schemaId}: row ${declared}, used as ${direction}`];
: [
`${operationId} ${validator.schemaId}: row ${declared ?? "states no direction"}, used as ${direction}`,
];
});
expect(wrong).toEqual([]);
@@ -154,11 +163,12 @@ describe("FE-REG-SCHEMA policy of the installed HTTP schemas (1103/07-03)", () =
it("declares the unknown-field policy its validator applies", () => {
const wrong = slots.flatMap(({ operationId, validator }) => {
const declared = SCHEMA_REGISTRY[validator.schemaId]?.unknownFieldPolicy;
if (declared === undefined) return [];
const probed = probeUnknownFieldPolicy(validator);
return probed === declared
? []
: [`${operationId} ${validator.schemaId}: row ${declared}, validator ${probed}`];
: [
`${operationId} ${validator.schemaId}: row ${declared ?? "states no unknownFieldPolicy"}, validator ${probed}`,
];
});
expect(wrong).toEqual([]);