refactor(layout): 루트 경로 목록을 등록부 하나에서 고르고 schemas/를 옮긴다
루트 항목 하나를 옮기려면 코드 7곳의 루트 경로 목록을 같이 고쳐야 했다(복사 대상, 비밀값 검사 범위, 공급망 시험의 필수 입력, 이력 문서 검사, 규모 입력, vite 입력, TS 전용 규칙). 서로 다른 부분집합이고 한 곳에서 선언하지 않았다. 목록이 갈라져 공급망 생성이 깨진 적도 있다 (removal-fixture.ts 주석). 루트에는 JSON Schema 5개만 담은 `schemas/`가 `config/` 옆에 따로 있었다. `artifacts/`(출력 폴더)에는 사람이 쓴 수동 a11y 기록이, `config/hosting/`(호스트 계약)에는 시험 fixture가 섞였다. 고른 방법(design-docs repo-structure/04-frontend-layout.md 9.2절 3단계, 11절 R1·R2, 소유자 승인 2026-11-07): - `config/repository-layout.json`이 루트 항목마다 종류·역할·읽는 곳과 들어가는 목록(`sets`, 항목 안 경로는 `setPaths`)을 적는다. `scripts/lib/repository-layout.ts`가 읽고 검증한다. 6곳은 이름 붙은 집합을 고른다. JSON인 비밀값 검사 정책은 집합의 사본을 두고 시험이 같은지 본다(정책 파일은 릴리스 후보에 실려 형식을 바꾸지 않았다). 공급망 시험의 필수 입력 목록은 그 시험으로 대신한다. - `tests/unit/repository-layout.test.ts`: 등록부에 없는 루트 항목이 추적되면 실패(R1). 7곳이 등록부 모듈을 쓰고 루트 이름 둘 이상의 문자열 배열을 갖지 않는지(R2). - `schemas/artifacts/` → `config/schemas/artifacts/`, recipe 카탈로그 스키마 → `config/schemas/recipes/`. 정책 입력 순서(ASCII)에 맞춰 `config/schemas/`가 `config/security/` 앞에 온다. - 수동 a11y 기록 3개 → `docs/accessibility/route-reviews/`. `artifacts/`는 `.gitkeep`만 추적한다. 기록은 단위 시험이 읽어서 drill 사본에도 복사한다(`fixture-copy` 집합의 `docs/accessibility/route-reviews`). - `config/hosting/response-headers.fixture.json` → `tests/fixtures/hosting/response-headers.json`. 버린 것: 비밀값 검사 정책이 집합 이름을 참조하게 바꾸는 방법. 정책 파일은 릴리스 후보와 로컬 증거 평가가 읽는 형식이라 바꾸면 릴리스 증거 계약이 바뀐다. 루트 항목이 지워졌는데 등록부에 남는 경우는 시험하지 않았다. drill 사본은 일부만 복사해 그 방향을 볼 수 없다. 그런 항목은 그 집합을 쓰는 곳(복사, 비밀값 검사)에서 실패한다. 위험: 하네스 작업(fe-c)이 더할 `AGENTS.md`·`.claude/`를 미리 등록했다 (optional). 등록부가 이력 문서(`SPEC.md`)와 `CLAUDE.md` 이름을 적어서 이력 문서 검사에서 등록부 파일은 뺐다. 다운스트림은 자기 루트 항목을 등록부에 더해야 한다(CHANGELOG). CI 계약 기준선을 다시 받았다(a11y 기록 산출물 id·경로). 검증(desktop): 아래 4단계 커밋까지 쌓은 트리에서 test:unit, check:types, check:ci, lint, verify:documentation을 돌렸다(그 커밋에 적음). 이 커밋 단독으로 test:unit·check:ci·check:types를 돌렸다. Refs: design-docs repo-structure/04-frontend-layout.md 2.4·9.2·11절, README.md 3.4절
This commit is contained in:
@@ -9,6 +9,7 @@ import { ESLint } from "eslint";
|
||||
import { architectureDependencyReportArtifactSchema } from "./contracts/release-artifacts.ts";
|
||||
import { checkArchitectureLintFixtures } from "./lib/architecture-lint-fixtures.ts";
|
||||
import { formatArchitectureViolation } from "./lib/architecture-violation-message.ts";
|
||||
import { selectRepositoryEntries } from "./lib/repository-layout.ts";
|
||||
import { writeValidatedJsonArtifact } from "./lib/validated-json-artifact.ts";
|
||||
|
||||
type PathRule = Readonly<{ path?: string; pathNot?: string }>;
|
||||
@@ -1044,8 +1045,11 @@ async function runGraphFixtureChecks(): Promise<GraphFixtureResult> {
|
||||
}
|
||||
|
||||
async function inspectTypeScriptOnlyPolicy(): Promise<TypeScriptOnlyPolicy> {
|
||||
const requiredRoots = ["src", "scripts", "tests", ".storybook"] as const;
|
||||
const optionalRoots = ["recipes"] as const;
|
||||
// The typescript-only set of config/repository-layout.json (R2). An optional
|
||||
// root (recipes/) may be gone after a removal drill.
|
||||
const selected = selectRepositoryEntries("typescript-only");
|
||||
const requiredRoots = selected.filter(({ optional }) => !optional).map(({ path }) => path);
|
||||
const optionalRoots = selected.filter(({ optional }) => optional).map(({ path }) => path);
|
||||
const checkedRoots = [...requiredRoots, ...optionalRoots];
|
||||
const files = (
|
||||
await Promise.all(
|
||||
|
||||
@@ -54,7 +54,7 @@ try {
|
||||
assertMatchesJsonSchema(
|
||||
JSON.parse(
|
||||
await readFile(
|
||||
"schemas/config/frontend-capability-recipes.schema.json",
|
||||
"config/schemas/recipes/frontend-capability-recipes.schema.json",
|
||||
"utf8",
|
||||
),
|
||||
),
|
||||
|
||||
@@ -748,7 +748,7 @@ if (usesRepositoryBaseline && failures.length === 0) {
|
||||
assertMatchesJsonSchema(
|
||||
JSON.parse(
|
||||
await readFile(
|
||||
"schemas/artifacts/registry-snapshot.schema.json",
|
||||
"config/schemas/artifacts/registry-snapshot.schema.json",
|
||||
"utf8",
|
||||
),
|
||||
),
|
||||
|
||||
@@ -880,7 +880,7 @@ const manualA11yResultSchema = z
|
||||
})
|
||||
.strict()
|
||||
.superRefine((result, context) => {
|
||||
if (result.path !== `artifacts/tests/a11y-manual/${result.routeId}.md`) {
|
||||
if (result.path !== `docs/accessibility/route-reviews/${result.routeId}.md`) {
|
||||
context.addIssue({ code: "custom", path: ["path"], message: "path must match routeId" });
|
||||
}
|
||||
const hasIdentity = Boolean(
|
||||
@@ -1429,7 +1429,7 @@ export const documentationReviewArtifactSchema = z
|
||||
reportDigestValid: z.boolean(),
|
||||
/**
|
||||
* The manual accessibility review scope: the installed routes that have no
|
||||
* record file under artifacts/tests/a11y-manual/. It is derived from the
|
||||
* record file under docs/accessibility/route-reviews/. It is derived from the
|
||||
* route registry, not read off a document (1101/14-05).
|
||||
*/
|
||||
routeScope: z.array(
|
||||
|
||||
@@ -375,7 +375,7 @@ export function planFeature(
|
||||
: []),
|
||||
...planned.map(
|
||||
(route) =>
|
||||
[`artifacts/tests/a11y-manual/${route.routeId}.md`, renderA11yRecord(route.routeId)] as const,
|
||||
[`docs/accessibility/route-reviews/${route.routeId}.md`, renderA11yRecord(route.routeId)] as const,
|
||||
),
|
||||
]);
|
||||
return Object.freeze({
|
||||
@@ -1767,7 +1767,7 @@ function report(plan: FeaturePlan): string {
|
||||
"",
|
||||
"Next:",
|
||||
` 1. Before a release, have a person review and sign ${plan.routes
|
||||
.map((route) => `artifacts/tests/a11y-manual/${route.routeId}.md`)
|
||||
.map((route) => `docs/accessibility/route-reviews/${route.routeId}.md`)
|
||||
.join(", ")} (FE-GATE-028). The merge gates check only their format.`,
|
||||
" 2. Run the merge gates: corepack pnpm ci:gate -- FE-GATE-<NNN> for each gate of the merge stage in config/ci/gates.json (README lists the loop). test:feature-scaffold runs them on a generated feature except the browser gates FE-GATE-008/009 and test:system.",
|
||||
` The feature's own tests: node scripts/run-vitest.ts run tests/features/${plan.id} (test:coverage runs them in CI)`,
|
||||
|
||||
@@ -15,22 +15,22 @@ import { writeValidatedJsonArtifact } from "./lib/validated-json-artifact.ts";
|
||||
|
||||
const ARTIFACT_SCHEMA_DEFINITIONS = Object.freeze([
|
||||
{
|
||||
relativePath: "schemas/artifacts/build-manifest.schema.json",
|
||||
relativePath: "config/schemas/artifacts/build-manifest.schema.json",
|
||||
id: undefined,
|
||||
schema: buildManifestArtifactSchema,
|
||||
},
|
||||
{
|
||||
relativePath: "schemas/artifacts/dependency-inventory.schema.json",
|
||||
relativePath: "config/schemas/artifacts/dependency-inventory.schema.json",
|
||||
id: "https://clean-architecture-frontend.local/schemas/dependency-inventory.schema.json",
|
||||
schema: dependencyInventoryArtifactSchema,
|
||||
},
|
||||
{
|
||||
relativePath: "schemas/artifacts/registry-snapshot.schema.json",
|
||||
relativePath: "config/schemas/artifacts/registry-snapshot.schema.json",
|
||||
id: undefined,
|
||||
schema: registrySnapshotArtifactSchema,
|
||||
},
|
||||
{
|
||||
relativePath: "schemas/artifacts/supply-chain-verification.schema.json",
|
||||
relativePath: "config/schemas/artifacts/supply-chain-verification.schema.json",
|
||||
id: "https://clean-architecture-frontend.local/schemas/supply-chain-verification.schema.json",
|
||||
schema: supplyChainVerificationArtifactSchema,
|
||||
},
|
||||
|
||||
@@ -122,12 +122,12 @@ export async function verifyLocalSupplyChainEvidence(
|
||||
|
||||
for (const [schemaPath, artifact, label] of [
|
||||
[
|
||||
"schemas/artifacts/dependency-inventory.schema.json",
|
||||
"config/schemas/artifacts/dependency-inventory.schema.json",
|
||||
inventory,
|
||||
"dependency inventory",
|
||||
],
|
||||
[
|
||||
"schemas/artifacts/supply-chain-verification.schema.json",
|
||||
"config/schemas/artifacts/supply-chain-verification.schema.json",
|
||||
verification,
|
||||
"supply-chain verification",
|
||||
],
|
||||
@@ -1020,7 +1020,7 @@ export async function assessLocalEvidenceForProducer(input: Readonly<{
|
||||
assertMatchesJsonSchema(
|
||||
await readJson(
|
||||
repositoryRoot,
|
||||
"schemas/artifacts/build-manifest.schema.json",
|
||||
"config/schemas/artifacts/build-manifest.schema.json",
|
||||
),
|
||||
buildManifest,
|
||||
"build manifest",
|
||||
|
||||
@@ -58,6 +58,9 @@ export const LOCAL_EVIDENCE_VERIFIER_SOURCE_PATHS = Object.freeze([
|
||||
] as const);
|
||||
|
||||
export const LOCAL_EVIDENCE_POLICY_INPUT_PATHS = Object.freeze([
|
||||
"config/schemas/artifacts/build-manifest.schema.json",
|
||||
"config/schemas/artifacts/dependency-inventory.schema.json",
|
||||
"config/schemas/artifacts/supply-chain-verification.schema.json",
|
||||
"config/security/dependency-baseline.approval.json",
|
||||
"config/security/dependency-baseline.json",
|
||||
"config/security/dependency-change-evidence.json",
|
||||
@@ -65,9 +68,6 @@ export const LOCAL_EVIDENCE_POLICY_INPUT_PATHS = Object.freeze([
|
||||
"config/security/secret-scan-policy.json",
|
||||
"config/security/vulnerability-exceptions.json",
|
||||
"config/security/vulnerability-policy.json",
|
||||
"schemas/artifacts/build-manifest.schema.json",
|
||||
"schemas/artifacts/dependency-inventory.schema.json",
|
||||
"schemas/artifacts/supply-chain-verification.schema.json",
|
||||
...LOCAL_EVIDENCE_VERIFIER_SOURCE_PATHS,
|
||||
] as const);
|
||||
|
||||
|
||||
@@ -20,23 +20,20 @@ import {
|
||||
linkFixtureNodeModules,
|
||||
} from "./fixture-node-modules.ts";
|
||||
import { generateCiWorkflow } from "../generate-ci-workflow.ts";
|
||||
import { selectRepositoryPaths } from "./repository-layout.ts";
|
||||
import { updateCiContractBaseline } from "../update-ci-contract-baseline.ts";
|
||||
|
||||
export const REMOVAL_FIXTURE_COPY_TARGETS = Object.freeze([
|
||||
"src", "tests", "recipes", "scripts", "schemas", "config", "public",
|
||||
".gitea", ".storybook", "index.html", "package.json", "tsconfig.base.json",
|
||||
"tsconfig.json", "tsconfig.app.json", "tsconfig.node.json", "tsconfig.test.json",
|
||||
"tsconfig.service-worker.json",
|
||||
"vite.service-worker.config.ts", "vite.config.ts", "vitest.config.ts",
|
||||
"playwright.config.ts", "playwright.capabilities.config.ts", "playwright.dev.config.ts",
|
||||
"playwright.storybook.config.ts", "playwright.visual.config.ts", "eslint.config.ts",
|
||||
".dependency-cruiser.json", ".nvmrc", ".gitignore",
|
||||
// Install and workspace identity. Without these the fixture is not the same
|
||||
// project: `corepack pnpm` resolves a different store, and the provider
|
||||
// suites — which build a release candidate containing `pnpm-lock.yaml` —
|
||||
// cannot assemble their fixture at all.
|
||||
".npmrc", "pnpm-lock.yaml", "pnpm-workspace.yaml",
|
||||
] as const);
|
||||
/**
|
||||
* The fixture-copy set of config/repository-layout.json (R2). It includes the
|
||||
* install and workspace identity (`.npmrc`, `pnpm-lock.yaml`,
|
||||
* `pnpm-workspace.yaml`): without them the fixture is not the same project,
|
||||
* `corepack pnpm` resolves a different store, and the provider suites — which
|
||||
* build a release candidate containing `pnpm-lock.yaml` — cannot assemble
|
||||
* their fixture at all. It also carries the manual a11y review records
|
||||
* (docs/accessibility/route-reviews), which unit tests read, without the rest
|
||||
* of `docs/`.
|
||||
*/
|
||||
export const REMOVAL_FIXTURE_COPY_TARGETS = selectRepositoryPaths("fixture-copy");
|
||||
|
||||
/**
|
||||
* This is the only copy-target list. Each removal script used to keep its own,
|
||||
@@ -53,11 +50,7 @@ export const REMOVAL_FIXTURE_COPY_TARGETS = Object.freeze([
|
||||
* the documents describe the capability they delete, and what those drills
|
||||
* prove is that the code still builds and tests without it.
|
||||
*/
|
||||
export const REMOVAL_FIXTURE_DOCUMENT_TARGETS = Object.freeze([
|
||||
"README.md",
|
||||
"CHANGELOG.md",
|
||||
"docs",
|
||||
] as const);
|
||||
export const REMOVAL_FIXTURE_DOCUMENT_TARGETS = selectRepositoryPaths("fixture-documents");
|
||||
|
||||
/**
|
||||
* 1103/02-06. Tests that read REMOVAL_FIXTURE_DOCUMENT_TARGETS. A fixture
|
||||
|
||||
@@ -0,0 +1,141 @@
|
||||
import { readFileSync } from "node:fs";
|
||||
|
||||
/**
|
||||
* The repository root registry, config/repository-layout.json (R1 in
|
||||
* docs/manual/03-outside-feature-folder.md). Every tracked root item has an
|
||||
* entry, and every list of root paths is a named set chosen from it (R2).
|
||||
* Seven places used to keep their own literal lists of root paths, each a
|
||||
* different subset, so moving one root item meant editing all seven
|
||||
* (design-docs repo-structure/04-frontend-layout.md §2.4).
|
||||
*/
|
||||
|
||||
export const REPOSITORY_LAYOUT_SETS = Object.freeze([
|
||||
"fixture-copy",
|
||||
"fixture-documents",
|
||||
"secret-scan",
|
||||
"history-free",
|
||||
"scale-source",
|
||||
"vite-build",
|
||||
"typescript-only",
|
||||
] as const);
|
||||
export type RepositoryLayoutSet = (typeof REPOSITORY_LAYOUT_SETS)[number];
|
||||
|
||||
export const REPOSITORY_LAYOUT_KINDS = Object.freeze([
|
||||
"source",
|
||||
"tool-convention",
|
||||
"gate-input",
|
||||
"document",
|
||||
"history",
|
||||
"output",
|
||||
] as const);
|
||||
export type RepositoryLayoutKind = (typeof REPOSITORY_LAYOUT_KINDS)[number];
|
||||
|
||||
export type RepositoryLayoutEntry = Readonly<{
|
||||
/** A root item name: one path segment, no slash. */
|
||||
path: string;
|
||||
kind: RepositoryLayoutKind;
|
||||
role: string;
|
||||
readBy: string;
|
||||
/** A removal drill or a product copy may not have it; a selection skips it when absent. */
|
||||
optional: boolean;
|
||||
/** The sets that select the whole item. */
|
||||
sets: readonly RepositoryLayoutSet[];
|
||||
/** The sets that select only these paths inside the item. */
|
||||
setPaths: Readonly<Partial<Record<RepositoryLayoutSet, readonly string[]>>>;
|
||||
}>;
|
||||
|
||||
export const REPOSITORY_LAYOUT_FILE = "config/repository-layout.json";
|
||||
|
||||
export function parseRepositoryLayout(value: unknown): readonly RepositoryLayoutEntry[] {
|
||||
const document = record(value, "layout");
|
||||
if (document["schemaVersion"] !== 1) throw new Error("layout: schemaVersion must be 1");
|
||||
const entries = document["entries"];
|
||||
if (!Array.isArray(entries) || entries.length === 0) {
|
||||
throw new Error("layout: entries must be a non-empty array");
|
||||
}
|
||||
const seen = new Set<string>();
|
||||
return Object.freeze(
|
||||
entries.map((raw, index) => {
|
||||
const entry = record(raw, `entries[${index}]`);
|
||||
const at = `entries[${index}]`;
|
||||
const itemPath = text(entry["path"], `${at}.path`);
|
||||
if (itemPath.includes("/")) throw new Error(`${at}.path: a root item has no slash: ${itemPath}`);
|
||||
if (seen.has(itemPath)) throw new Error(`${at}.path: duplicate root item ${itemPath}`);
|
||||
seen.add(itemPath);
|
||||
const kind = text(entry["kind"], `${at}.kind`);
|
||||
if (!(REPOSITORY_LAYOUT_KINDS as readonly string[]).includes(kind)) {
|
||||
throw new Error(`${at}.kind: unknown kind ${kind}`);
|
||||
}
|
||||
const sets = (entry["sets"] ?? []) as unknown;
|
||||
if (!Array.isArray(sets)) throw new Error(`${at}.sets must be an array`);
|
||||
const setPaths = record(entry["setPaths"] ?? {}, `${at}.setPaths`);
|
||||
for (const set of [...sets, ...Object.keys(setPaths)]) {
|
||||
if (!(REPOSITORY_LAYOUT_SETS as readonly string[]).includes(set as string)) {
|
||||
throw new Error(`${at}: unknown set ${String(set)}`);
|
||||
}
|
||||
}
|
||||
for (const [set, paths] of Object.entries(setPaths)) {
|
||||
if (!Array.isArray(paths) || paths.length === 0) {
|
||||
throw new Error(`${at}.setPaths.${set} must be a non-empty array`);
|
||||
}
|
||||
for (const inner of paths) {
|
||||
if (typeof inner !== "string" || !inner.startsWith(`${itemPath}/`)) {
|
||||
throw new Error(`${at}.setPaths.${set}: ${String(inner)} is not inside ${itemPath}`);
|
||||
}
|
||||
}
|
||||
if (sets.includes(set)) throw new Error(`${at}: ${set} selects the whole item and paths in it`);
|
||||
}
|
||||
return Object.freeze({
|
||||
path: itemPath,
|
||||
kind: kind as RepositoryLayoutKind,
|
||||
role: text(entry["role"], `${at}.role`),
|
||||
readBy: text(entry["readBy"], `${at}.readBy`),
|
||||
optional: entry["optional"] === true,
|
||||
sets: Object.freeze([...sets] as RepositoryLayoutSet[]),
|
||||
setPaths: Object.freeze(setPaths as Partial<Record<RepositoryLayoutSet, readonly string[]>>),
|
||||
});
|
||||
}),
|
||||
);
|
||||
}
|
||||
|
||||
export const REPOSITORY_LAYOUT: readonly RepositoryLayoutEntry[] = parseRepositoryLayout(
|
||||
JSON.parse(readFileSync(new URL(`../../${REPOSITORY_LAYOUT_FILE}`, import.meta.url), "utf8")),
|
||||
);
|
||||
|
||||
/** The paths a set selects, in registry order. */
|
||||
export function selectRepositoryPaths(
|
||||
set: RepositoryLayoutSet,
|
||||
layout: readonly RepositoryLayoutEntry[] = REPOSITORY_LAYOUT,
|
||||
): readonly string[] {
|
||||
return Object.freeze(
|
||||
layout.flatMap((entry) =>
|
||||
entry.sets.includes(set) ? [entry.path] : [...(entry.setPaths[set] ?? [])],
|
||||
),
|
||||
);
|
||||
}
|
||||
|
||||
/** Like selectRepositoryPaths, with whether a drill or a copy may lack each path. */
|
||||
export function selectRepositoryEntries(
|
||||
set: RepositoryLayoutSet,
|
||||
layout: readonly RepositoryLayoutEntry[] = REPOSITORY_LAYOUT,
|
||||
): readonly Readonly<{ path: string; optional: boolean }>[] {
|
||||
return Object.freeze(
|
||||
layout.flatMap((entry) =>
|
||||
(entry.sets.includes(set) ? [entry.path] : [...(entry.setPaths[set] ?? [])]).map(
|
||||
(selected) => Object.freeze({ path: selected, optional: entry.optional }),
|
||||
),
|
||||
),
|
||||
);
|
||||
}
|
||||
|
||||
function record(value: unknown, at: string): Record<string, unknown> {
|
||||
if (typeof value !== "object" || value === null || Array.isArray(value)) {
|
||||
throw new Error(`${at} must be an object`);
|
||||
}
|
||||
return value as Record<string, unknown>;
|
||||
}
|
||||
|
||||
function text(value: unknown, at: string): string {
|
||||
if (typeof value !== "string" || value.trim() === "") throw new Error(`${at} must be a non-empty string`);
|
||||
return value;
|
||||
}
|
||||
@@ -1,3 +1,5 @@
|
||||
import { selectRepositoryPaths } from "./repository-layout.ts";
|
||||
|
||||
/**
|
||||
* 1105/15-03. The files `vite build` reads from the repository root, for the
|
||||
* measurements and tests that copy them into a temporary root and build
|
||||
@@ -7,15 +9,6 @@
|
||||
* a new local import in vite.config.ts broke both, and both had to be edited
|
||||
* (7f9a515, 799ab7f). tests/unit/vite-build-inputs.test.ts fails, naming the
|
||||
* file, when vite.config.ts imports a local file this list does not cover.
|
||||
* The list is the vite-build set of config/repository-layout.json (R2).
|
||||
*/
|
||||
export const VITE_BUILD_INPUTS = Object.freeze([
|
||||
"src",
|
||||
"public",
|
||||
"index.html",
|
||||
"package.json",
|
||||
"vite.config.ts",
|
||||
"tsconfig.base.json",
|
||||
"tsconfig.app.json",
|
||||
"scripts/lib/run-isolation.ts",
|
||||
"scripts/lib/vite-module-inventory.ts",
|
||||
] as const);
|
||||
export const VITE_BUILD_INPUTS = selectRepositoryPaths("vite-build");
|
||||
|
||||
@@ -24,7 +24,7 @@ type ManualA11yResult = Readonly<{
|
||||
if (process.argv.includes("--format-only")) {
|
||||
const failures: string[] = [];
|
||||
for (const routeId of MANUAL_A11Y_ROUTE_IDS) {
|
||||
const path = `artifacts/tests/a11y-manual/${routeId}.md`;
|
||||
const path = `docs/accessibility/route-reviews/${routeId}.md`;
|
||||
const record = await readFile(path, "utf8").catch(() => null);
|
||||
const invalid = record === null ? ["missing record"] : validateManualA11yRecordFormat(record, routeId);
|
||||
if (invalid.length > 0) failures.push(`${path}: ${invalid.join(", ")}`);
|
||||
@@ -41,7 +41,7 @@ if (process.argv.includes("--format-only")) {
|
||||
|
||||
const results: ManualA11yResult[] = [];
|
||||
for (const routeId of MANUAL_A11Y_ROUTE_IDS) {
|
||||
const path = `artifacts/tests/a11y-manual/${routeId}.md`;
|
||||
const path = `docs/accessibility/route-reviews/${routeId}.md`;
|
||||
const evidence = await readFile(path, "utf8");
|
||||
const validation = validateManualA11yEvidence(evidence);
|
||||
const failures =
|
||||
|
||||
@@ -21,7 +21,7 @@ import { writeValidatedJsonArtifact } from "./lib/validated-json-artifact.ts";
|
||||
* every new feature edit two template-owned documents (1101/14-05), so the
|
||||
* documents now name this folder and the record files are what is checked.
|
||||
*/
|
||||
const MANUAL_A11Y_RECORDS = "artifacts/tests/a11y-manual/";
|
||||
const MANUAL_A11Y_RECORDS = "docs/accessibility/route-reviews/";
|
||||
|
||||
type DocumentationReview = Readonly<{
|
||||
sourcePath: string;
|
||||
|
||||
@@ -5,6 +5,8 @@ import { mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
|
||||
import { arch, platform, userInfo } from "node:os";
|
||||
import path from "node:path";
|
||||
|
||||
import { selectRepositoryPaths } from "./lib/repository-layout.ts";
|
||||
|
||||
/**
|
||||
* Executable evidence for the extreme-scale acceptance matrix.
|
||||
*
|
||||
@@ -46,20 +48,8 @@ export const EXTREME_SCALE_GATES = Object.freeze([
|
||||
"check:scale:release",
|
||||
] as const);
|
||||
|
||||
/** Inputs whose content defines "the current code" for this evidence. */
|
||||
const SOURCE_ROOTS = Object.freeze(["src", "scripts", "tests", "config", ".storybook", "recipes"]);
|
||||
const SOURCE_FILES = Object.freeze([
|
||||
"package.json",
|
||||
"pnpm-lock.yaml",
|
||||
".dependency-cruiser.json",
|
||||
"eslint.config.ts",
|
||||
"vite.config.ts",
|
||||
"vitest.config.ts",
|
||||
"tsconfig.json",
|
||||
"tsconfig.app.json",
|
||||
"tsconfig.test.json",
|
||||
"tsconfig.node.json",
|
||||
]);
|
||||
/** Inputs whose content defines "the current code": the scale-source set of config/repository-layout.json (R2). */
|
||||
const SOURCE_PATHS = selectRepositoryPaths("scale-source");
|
||||
|
||||
async function listFiles(directory: string): Promise<string[]> {
|
||||
const found: string[] = [];
|
||||
@@ -80,8 +70,17 @@ async function listFiles(directory: string): Promise<string[]> {
|
||||
/** sha256 over every source input (path + content), in a stable order. */
|
||||
export async function sourceDigest(root: string): Promise<Readonly<{ digest: string; files: number }>> {
|
||||
const files = [
|
||||
...(await Promise.all(SOURCE_ROOTS.map((entry) => listFiles(path.join(root, entry))))).flat(),
|
||||
...SOURCE_FILES.map((file) => path.join(root, file)).filter((file) => existsSync(file)),
|
||||
...(
|
||||
await Promise.all(
|
||||
SOURCE_PATHS.map((entry) => path.join(root, entry)).map(async (target) =>
|
||||
(await stat(target).catch(() => null))?.isDirectory()
|
||||
? listFiles(target)
|
||||
: existsSync(target)
|
||||
? [target]
|
||||
: [],
|
||||
),
|
||||
)
|
||||
).flat(),
|
||||
]
|
||||
.map((file) => path.relative(root, file))
|
||||
.sort();
|
||||
|
||||
@@ -129,7 +129,7 @@ if (liveTarget?.passed && !slotEmpty) {
|
||||
} else {
|
||||
mode = "fixture";
|
||||
const fixture = await readDocument(
|
||||
"config/hosting/response-headers.fixture.json",
|
||||
"tests/fixtures/hosting/response-headers.json",
|
||||
);
|
||||
responses = responseHeaders(fixture.responses);
|
||||
}
|
||||
|
||||
@@ -95,7 +95,7 @@ const buildManifestDocument: unknown = JSON.parse(
|
||||
);
|
||||
assertMatchesJsonSchema(
|
||||
JSON.parse(
|
||||
await readFile("schemas/artifacts/build-manifest.schema.json", "utf8"),
|
||||
await readFile("config/schemas/artifacts/build-manifest.schema.json", "utf8"),
|
||||
),
|
||||
buildManifestDocument,
|
||||
"build manifest",
|
||||
|
||||
Reference in New Issue
Block a user