Merge lane K: CI, guardrails and release fixes
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
+1
-1
@@ -206,7 +206,7 @@ src/shared/api
|
||||
|
||||
### 1.2 계층 방향
|
||||
|
||||
현재 `config/architecture/layers.json`의 방향을 유지한다.
|
||||
현재 방향을 유지한다. 기준은 `.dependency-cruiser.json` 하나이고 `check:architecture`가 강제한다(`config/architecture/layers.json`은 아무도 읽지 않는 낡은 사본이라 지웠다, 리뷰 12-09).
|
||||
|
||||
```text
|
||||
domain -> domain only
|
||||
|
||||
@@ -50,7 +50,10 @@ architecture/security/type negative input으로 전환했다. 이는 7번 결정
|
||||
|
||||
- `check:types`는 app, Node scripts/config, tests project를 모두 검사한다.
|
||||
- TS invalid-call, invalid port, discriminated-union fixture는 실패해야 한다.
|
||||
- ESLint와 dependency-cruiser는 TS/TSX architecture fixture를 검사한다.
|
||||
- ESLint와 `check:architecture`의 import 그래프(`scripts/check-architecture.ts`)가
|
||||
TS/TSX architecture fixture를 검사한다. dependency-cruiser 18은 TypeScript 7을
|
||||
해석하지 못해 0개 모듈을 검사하고 통과했으므로 실행하지 않는다(리뷰 12-05).
|
||||
`.dependency-cruiser.json`은 이름만 남은 규칙 파일이고 그래프가 읽는다.
|
||||
- registry scanner는 TS registry의 required field, uniqueness와 reference를
|
||||
검증한다.
|
||||
- browser security gate는 TSX의 금지된 raw HTML fixture를 거절한다.
|
||||
|
||||
@@ -38,9 +38,18 @@
|
||||
|
||||
## 경계와 검증
|
||||
|
||||
- 제품 코드는 `presentation/design-system/index`만 import한다.
|
||||
- design-system 검사기는 direct icon/headless import, deep import, raw palette,
|
||||
undefined token과 tooltip-only required information fixture를 거절한다.
|
||||
- 제품 코드는 `presentation/design-system/index`만 import한다. 예외는 규칙에
|
||||
이름으로 적는다. `presentation/components/ui/*.ts`는 아래 Rollback의 재수출
|
||||
facade이고, `presentation/templates/page-templates.tsx`는 index가 내보내지
|
||||
않는 `PaginationLandmarkContext`를 읽는다.
|
||||
- deep import와 direct icon import는 `check:architecture` 그래프 규칙
|
||||
`design-system-is-reached-through-its-index`, `icon-vendor-is-facade-only`
|
||||
(`.dependency-cruiser.json`)가 거절한다. 경로 해석이 끝난 간선을 보므로
|
||||
presentation 안의 상대 경로 import도 잡는다(리뷰 12-08). 음성 fixture는
|
||||
`tests/fixtures/architecture/dependency-graph/import-boundaries`다.
|
||||
- design-system 검사기(`scripts/check-design-system.ts`)는 headless vendor
|
||||
import, raw palette, undefined token과 tooltip-only required information
|
||||
fixture를 거절한다.
|
||||
- type negative fixture는 accessible name 없는 `IconButton`을 거절한다.
|
||||
- component test는 decorative icon, form control, Menu, Tabs, Drawer와 Toast를
|
||||
검증한다.
|
||||
|
||||
@@ -65,7 +65,7 @@ P0/P1 acceptance와 P2 recipe 기본값은 `LOCAL_TEMPLATE_READY`다. 다만 실
|
||||
| 영역 | 현재 판정 | 근거 | 필요한 다음 상태 |
|
||||
| --- | --- | --- | --- |
|
||||
| 부트·런타임 설정 | 준비됨 | `src/bootstrap`, runtime schema, release 검사 | 현 상태 유지, TS 전환 시 동일 게이트 유지 |
|
||||
| 계층 의존 방향 | 준비됨 | dependency-cruiser + TS-aware static graph, unresolved/parse/layer/cycle negative fixture | 새 rule shape와 source extension도 같은 fail-closed graph에 추가 |
|
||||
| 계층 의존 방향 | 준비됨 | TS-aware static graph(`scripts/check-architecture.ts`, 규칙 `.dependency-cruiser.json`), unresolved/parse/layer/cycle negative fixture. dependency-cruiser 자체는 TS 7을 해석하지 못해 실행하지 않음(12-05) | 새 rule shape와 source extension도 같은 fail-closed graph에 추가 |
|
||||
| application facade | 준비됨 | module-augmented feature input registry, typed output catalog, provider, production composition test | feature별 input contribution과 제거 gate 유지 |
|
||||
| REST HTTP client | 준비됨 + hardening delta | reference vertical의 path/search/body projection, attempt timeout/retry, abort/cleanup은 `COMPOSED` | auth fail-close/final invariant, total deadline, bounded decoder, status/media/CSRF/conditional/pagination은 `DESIGNED_NOT_IMPLEMENTED` |
|
||||
| Browser RPC 공통 계약/runtime | 준비됨/미조립 | V3 operation/profile registry, typed application port, bounded unary/server-stream lifecycle와 unavailable adapter는 `AVAILABLE_NOT_COMPOSED` | actual descriptor/generated client, protocol transport, proxy/provider/browser conformance |
|
||||
|
||||
+40
-13
@@ -25,6 +25,15 @@ The following edges are forbidden:
|
||||
- an adapter to presentation, bootstrap internals, or another concrete adapter
|
||||
- feature domain/application to its presentation or outbound adapter, and
|
||||
feature presentation to its outbound adapter
|
||||
- a module presentation may import to a concrete adapter: files outside a
|
||||
feature's layer folders (`src/features/*.ts`, `src/features/<id>/*.ts`),
|
||||
`src/contexts` and `src/apps` (`feature-and-app-roots-do-not-reach-adapters`).
|
||||
The graph checks one edge at a time, so a re-export there would carry an
|
||||
adapter into presentation with every other rule passing. The one exception is
|
||||
the type-only `src/features/feature-adapter-contribution.ts`
|
||||
- presentation to `src/apps` or `src/contexts`, except
|
||||
`src/presentation/routes/app-router.tsx`, which mounts the app's route tree
|
||||
(`presentation-does-not-import-apps-or-contexts`)
|
||||
|
||||
## The adapter kernel
|
||||
|
||||
@@ -35,14 +44,25 @@ purpose and is the only adapter code an adapter may reach across a group for:
|
||||
the bounded-capacity guard
|
||||
- `src/adapters/browser-file-storage/result.ts` — the browser-data result and
|
||||
failure constructors
|
||||
- `src/adapters/cross-context-invalidation/index.ts` — the cross-context
|
||||
invalidation transport and its types. Any adapter may import it; today
|
||||
`query-cache` does
|
||||
|
||||
Each rule above is enforced by `check:architecture`, including the kernel
|
||||
carve-out, so this table and the executable rules cannot drift apart. Two edges
|
||||
are still open and are named explicitly in `.dependency-cruiser.json` rather
|
||||
than left silent: the generic presentation modules that read the installed
|
||||
registries today, and the two collaborator types `query-cache` reads from
|
||||
`cross-context-invalidation`. Both lists are frozen — a new edge of either kind
|
||||
fails the gate.
|
||||
carve-out, so this table and the executable rules cannot drift apart.
|
||||
|
||||
Every exception is written in the rule itself (`.dependency-cruiser.json`): the
|
||||
exempted path in `pathNot`, and the reason, owner and revisit condition in
|
||||
`comment` (review 12-07). Besides the kernel, the exceptions are:
|
||||
|
||||
- the generic presentation modules that read the installed registries today
|
||||
(`generic-presentation-does-not-compose-the-product`). The list names exact
|
||||
files, so a new module that reads a registry fails the gate
|
||||
- `src/presentation/adapters/query`, the TanStack Query binding
|
||||
(`presentation-does-not-know-adapters`)
|
||||
- `src/presentation/routes/app-router.tsx` importing the app
|
||||
(`presentation-does-not-import-apps-or-contexts`)
|
||||
- the design-system facades (`design-system-is-reached-through-its-index`)
|
||||
|
||||
## 어댑터 그룹의 공개 경계
|
||||
|
||||
@@ -63,10 +83,15 @@ fails the gate.
|
||||
위한 것이다.
|
||||
|
||||
`storage`는 최상위 배럴이 `indexeddb/`·`opfs/` 서브배럴을 재수출하지
|
||||
않는다. 두 런타임이 각자 독립적으로 제거 가능하고
|
||||
(`test:browser-file-storage-removal`), 그래서 각 서브배럴이 곧 경계다.
|
||||
규칙의 도착점 정규식이 1단계 중첩 `index.ts`를 배럴로 인정하는 이유가
|
||||
이것이다.
|
||||
않는다. 두 폴더는 browser-file-storage 번들의 런타임이다. 제거 드릴
|
||||
(`test:browser-file-storage-removal`)은 그 번들 전체(`browser-file-storage`,
|
||||
`browser-files`, `browser-transfer`, `cache-storage`, `storage/indexeddb`,
|
||||
`storage/opfs`)를 함께 지운다. 최상위 `storage` 배럴(Web Storage)은 그 뒤에도
|
||||
남아야 하므로 두 폴더를 재수출하지 않고, 그래서 각 서브배럴이 그 런타임의 공개
|
||||
경계다.
|
||||
규칙의 도착점 정규식은 이 두 서브배럴만 배럴로 인정한다. 다른 그룹의 2단계
|
||||
`index.ts`(예: `http/internals/index.ts`)는 공개 배럴이 아니고, 그룹 바깥에서
|
||||
import하면 실패한다(리뷰 12-07, `dependency-graph/barrel` fixture).
|
||||
|
||||
`service-worker/index.ts`는 `tsconfig.service-worker.json`의 `exclude`에
|
||||
들어 있다. 그 설정이 그룹 폴더를 통째로 WebWorker lib로 컴파일하면서 페이지
|
||||
@@ -83,8 +108,9 @@ application APIs augment the generic typed input registry. Concrete output
|
||||
ports are composed in bootstrap and stay hidden behind the application facade.
|
||||
Project-selected capabilities still implement the same output boundaries.
|
||||
|
||||
`check:architecture` keeps dependency-cruiser's report and adds the
|
||||
authoritative TypeScript-aware graph below it:
|
||||
`check:architecture` writes the TypeScript-aware graph below. It reads the rules
|
||||
from `.dependency-cruiser.json` but does not run dependency-cruiser, which cannot
|
||||
parse TypeScript 7 and checked zero modules (review 12-05):
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -103,7 +129,8 @@ authoritative TypeScript-aware graph below it:
|
||||
```
|
||||
|
||||
The graph scans TypeScript and TSX, including static, dynamic, type, CommonJS
|
||||
and JSDoc import references. It applies the path rules from
|
||||
and JSDoc import references. `import.meta.glob` is a parse failure: it loads
|
||||
modules without naming one, so no edge rule could see them (review 12-06). It applies the path rules from
|
||||
`.dependency-cruiser.json`, requires explicit TypeScript extensions for local
|
||||
source imports, and fails closed on JavaScript-family source/specifiers,
|
||||
unsupported rule shapes, unresolved imports, parse failures, error-severity
|
||||
|
||||
@@ -130,6 +130,15 @@ Web Push를 함께 설치하지 않는다.
|
||||
integration test를 작성한다.
|
||||
9. runtime config schema, dependency inventory/approval, SBOM, bundle budget,
|
||||
browser support와 runbook을 갱신한다.
|
||||
운영 CSP(`config/hosting/security-headers.json`)도 여기서 넓힌다. 기본 CSP는
|
||||
아래 기능을 막는다(리뷰 13-08).
|
||||
- 다른 origin의 realtime: `connect-src`에 `wss://<realtime origin>`을 더한다.
|
||||
`https:`는 `wss:`를 허용하지 않는다(CSP3 scheme 비교).
|
||||
- 파일 preview(`src/adapters/browser-files/object-url-lease.ts`의 object URL):
|
||||
`img-src`에 `blob:`을 더한다.
|
||||
- 이미지 CDN: `img-src`에 CDN origin을 더한다.
|
||||
바꾼 CSP 아래에서 `tests/e2e/production-csp.spec.ts`가 그 기능의 화면을 열도록
|
||||
smoke를 늘린다.
|
||||
10. 실제 provider integration과 negative behavior가 통과한 뒤에만 catalog 상태를
|
||||
별도 project catalog에서 `INSTALLED`로 바꾼다.
|
||||
|
||||
|
||||
@@ -53,8 +53,9 @@ and exact input type.
|
||||
Route contracts/codecs, the route-input provider, and lazy runtime modules are
|
||||
separate modules so feature pages do not import the router that loads them.
|
||||
Expected application failures use the shared `Result`/`AppFailure` contract.
|
||||
The architecture gate analyzes TS/TSX imports independently of
|
||||
dependency-cruiser, rejects local JavaScript-family specifiers and executable
|
||||
The architecture gate analyzes TS/TSX imports with its own graph (the rules
|
||||
live in `.dependency-cruiser.json`; dependency-cruiser itself cannot parse
|
||||
TypeScript 7 and does not run), rejects local JavaScript-family specifiers and executable
|
||||
JavaScript-family files, and fails on unresolved imports, parse failures,
|
||||
forbidden layer edges, or cycles. The remaining project-owned work includes
|
||||
selecting and verifying real hosting, identity, telemetry, vulnerability and
|
||||
|
||||
@@ -29,5 +29,10 @@ sequenceDiagram
|
||||
CI->>Browser: boot, route, API, and reload-loop smoke
|
||||
```
|
||||
|
||||
In this repository the workflow stops at promotion. The upload, pointer switch
|
||||
and smoke steps above belong to the project's provider adapter; after it has
|
||||
deployed the promoted release, FE-GATE-019 probes the live headers (review
|
||||
13-05, [`release-cache-rollback.md`](../operations/release-cache-rollback.md)).
|
||||
|
||||
Rollback changes the active pointer only after confirming that the prior
|
||||
immutable release has a coherent HTML/assets/config/API/manifest tuple.
|
||||
|
||||
@@ -52,7 +52,9 @@ TypeScript 전환 목적은 확장자 변경이 아니라 이 계약을 컴파
|
||||
1. ESLint가 product와 negative fixture의 `ts`/`tsx`를 모두 검사한다.
|
||||
2. React Hooks 규칙을 추가하고 TypeScript/ESLint parser와 JSX accessibility
|
||||
도구는 설치된 compiler/linter의 공식 peer 범위 안에서 선택한다.
|
||||
3. dependency-cruiser의 extension과 resolver가 TS/TSX를 포함한다.
|
||||
3. `check:architecture`의 import 그래프가 TS/TSX를 해석한다. 규칙은
|
||||
`.dependency-cruiser.json`에 있지만 dependency-cruiser는 실행하지 않는다.
|
||||
TypeScript 7을 해석하지 못해 0개 모듈을 검사했기 때문이다(리뷰 12-05).
|
||||
4. `scripts/check-registries.ts`가 TS/TSX를 검색한다.
|
||||
5. `config/contracts/registry-governance.json`과 승인 baseline은 `.ts/.tsx`
|
||||
source 경로를 사용한다.
|
||||
|
||||
Reference in New Issue
Block a user