From d2389cac03d2723f5552fa39cfc8af6e7c2dd28c Mon Sep 17 00:00:00 2001 From: DongHun Date: Thu, 24 Sep 2026 21:32:19 +0900 Subject: [PATCH 1/4] CI: validate develop PR merge result --- .github/workflows/current-code-validation.yml | 1 - AGENTS.md | 2 +- docs/prd/current/04-verification-and-handoff.md | 9 +++++++++ 3 files changed, 10 insertions(+), 2 deletions(-) diff --git a/.github/workflows/current-code-validation.yml b/.github/workflows/current-code-validation.yml index aa3bac9..14ec5e2 100644 --- a/.github/workflows/current-code-validation.yml +++ b/.github/workflows/current-code-validation.yml @@ -17,7 +17,6 @@ jobs: steps: - uses: actions/checkout@v7 with: - ref: ${{ github.event.pull_request.head.sha || github.sha }} persist-credentials: false - uses: actions/setup-node@v7 with: diff --git a/AGENTS.md b/AGENTS.md index b2f0231..653b52e 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -52,7 +52,7 @@ Gate Status: Date: Fri, 2 Oct 2026 00:26:14 +0900 Subject: [PATCH 2/4] =?UTF-8?q?fix(deps):=20undici=20WebSocket=20DoS=20?= =?UTF-8?q?=EB=B3=B4=EC=95=88=20=ED=8C=A8=EC=B9=98=EB=A5=BC=20=EC=A0=81?= =?UTF-8?q?=EC=9A=A9=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit undici 잠금 버전을 6.28.0에서 6.28.1로 갱신한다. GHSA-rfgv-xxqx-mfg5의 요청하지 않은 WebSocket 하위 프로토콜 응답으로 인한 프로세스 종료를 수정한다. --- package-lock.json | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/package-lock.json b/package-lock.json index f3e88fa..74c11ce 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1323,9 +1323,9 @@ } }, "node_modules/undici": { - "version": "6.28.0", - "resolved": "https://registry.npmjs.org/undici/-/undici-6.28.0.tgz", - "integrity": "sha512-LIY910g9TI13YS95lrMFrs8Rm/u/irgHeTWoKCoteeJ04CUJ92eEfj0rVn+7VKMPBpUPiUoBKfhNyLI23EE/KA==", + "version": "6.28.1", + "resolved": "https://registry.npmjs.org/undici/-/undici-6.28.1.tgz", + "integrity": "sha512-zWpdTVD54H48CIybL0rWQ3ukpb9d23wM7eH5RtfdmeP70cWHNjtfo7P4vZX+5CoDcO53J4Pu5uXp7lNfjc6DRA==", "license": "MIT", "engines": { "node": ">=18.17" From da2a10994c792c144fb626f42404c04ed2324c43 Mon Sep 17 00:00:00 2001 From: DongHun <81342336+OstenHun@users.noreply.github.com> Date: Fri, 2 Oct 2026 01:40:41 +0900 Subject: [PATCH 3/4] =?UTF-8?q?revert(deps):=20undici=20=EB=B3=B4=EC=95=88?= =?UTF-8?q?=20=ED=8C=A8=EC=B9=98=EB=A5=BC=20PR=20#18=EB=A1=9C=20=EB=B6=84?= =?UTF-8?q?=EB=A6=AC=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit PR #16은 CI 병합 결과 검증과 관련 문서 변경에 집중하도록 fcaa472의 잠금 파일 변경만 되돌린다. 충돌 해결 이력은 유지하며 보안 패치는 독립 PR #18에서 검토한다. --- package-lock.json | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/package-lock.json b/package-lock.json index 74c11ce..f3e88fa 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1323,9 +1323,9 @@ } }, "node_modules/undici": { - "version": "6.28.1", - "resolved": "https://registry.npmjs.org/undici/-/undici-6.28.1.tgz", - "integrity": "sha512-zWpdTVD54H48CIybL0rWQ3ukpb9d23wM7eH5RtfdmeP70cWHNjtfo7P4vZX+5CoDcO53J4Pu5uXp7lNfjc6DRA==", + "version": "6.28.0", + "resolved": "https://registry.npmjs.org/undici/-/undici-6.28.0.tgz", + "integrity": "sha512-LIY910g9TI13YS95lrMFrs8Rm/u/irgHeTWoKCoteeJ04CUJ92eEfj0rVn+7VKMPBpUPiUoBKfhNyLI23EE/KA==", "license": "MIT", "engines": { "node": ">=18.17" From b6370a9a190e05d7d310f98ffa1d2aa5dc7d0be5 Mon Sep 17 00:00:00 2001 From: DongHun <81342336+OstenHun@users.noreply.github.com> Date: Fri, 2 Oct 2026 02:20:21 +0900 Subject: [PATCH 4/4] =?UTF-8?q?ci:=20Linux=20Node.js=2022=EC=99=80=2024=20?= =?UTF-8?q?=EA=B2=80=EC=A6=9D=20=ED=96=89=EB=A0=AC=EC=9D=84=20=EC=B6=94?= =?UTF-8?q?=EA=B0=80=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Docker와 개발 환경의 Node.js 버전을 함께 검사하고 두 job의 결과를 독립적으로 수집한다. 기본 PR 병합 결과 checkout과 기존 검증 명령 및 읽기 전용 권한을 유지한다. PRD 04의 현재 CI 및 재현 가능한 런타임 기준을 정렬한다. --- .github/workflows/current-code-validation.yml | 8 ++++++-- docs/prd/current/04-verification-and-handoff.md | 12 +++++++++++- 2 files changed, 17 insertions(+), 3 deletions(-) diff --git a/.github/workflows/current-code-validation.yml b/.github/workflows/current-code-validation.yml index 14ec5e2..1c91bc0 100644 --- a/.github/workflows/current-code-validation.yml +++ b/.github/workflows/current-code-validation.yml @@ -11,16 +11,20 @@ permissions: jobs: validate: - name: Linux / Node.js 20 + name: Linux / Node.js ${{ matrix.node-version }} runs-on: ubuntu-latest timeout-minutes: 10 + strategy: + fail-fast: false + matrix: + node-version: ['22', '24'] steps: - uses: actions/checkout@v7 with: persist-credentials: false - uses: actions/setup-node@v7 with: - node-version: '20' + node-version: ${{ matrix.node-version }} package-manager-cache: false - run: npm ci - run: npm test diff --git a/docs/prd/current/04-verification-and-handoff.md b/docs/prd/current/04-verification-and-handoff.md index 0c279e5..1e04f82 100644 --- a/docs/prd/current/04-verification-and-handoff.md +++ b/docs/prd/current/04-verification-and-handoff.md @@ -34,6 +34,13 @@ ReportAgent 인계, 정본 영속화 또는 전달 실패 검증이 아니다. `develop@795990e`에는 재귀적으로 현재 코드 테스트를 찾아 실행하고 테스트 파일이 0개면 실패하는 `tests/run-tests.mjs`와 가짜 입력 기반 테스트 4개가 있다. 이 CI는 해당 코드의 회귀, TypeScript 검사와 빌드 가능성만 확인한다. 위의 정본 P0 수직 흐름, 실제 원천 통합, 성능 임계값, Windows 이식성은 아직 입증하지 않는다. Windows 개발자는 로컬 `npm test` 실패를 Linux CI와 별도로 보고한다. +### 2026-10-01 현재 코드 CI 런타임 정렬 (PAAR/PAR) + +- Problem: Node.js 20은 [공식 지원 일정](https://github.com/nodejs/Release#release-schedule)상 2026-04-30 지원이 종료됐다. 기존 단일 버전 CI는 Docker의 Node.js 22와 개발 환경의 Node.js 24를 직접 검사하지 않는다. +- Analyze: Linux Node.js 22/24 행렬은 두 환경의 런타임 호환성을 함께 확인한다. Node.js 22만 검사하면 개발 환경 차이가 남고, Docker까지 Node.js 24로 바꾸면 배포 런타임 변경 검증으로 범위가 넓어진다. +- Action: PR merge checkout, develop push, 읽기 전용 권한과 자격 증명 미보존을 유지하고 각 버전에서 `npm ci`, `npm test`, `npm run typecheck`, `npm run build`를 실행한다. `fail-fast: false`로 한 버전이 실패해도 다른 버전의 결과를 수집한다. 각 job의 제한 시간은 10분이다. 롤백은 행렬 변경을 되돌리는 것이지만 지원 종료된 Node.js 20 복귀는 권장하지 않는다. +- Result: `Linux / Node.js 22`와 `Linux / Node.js 24` 두 job이 모두 성공해야 현재 코드 호환성 검증 통과로 판정한다. 어느 버전의 실패도 허용하지 않는다. Linux 검사는 Windows 이식성, Docker 이미지/Alpine 실행, 실제 원천 통합 또는 아래 성능 임계값을 증명하지 않는다. + 이 게이트와 아래 인계는 API/대기열/저장, 진단 에이전트/도구 코어, 가짜 원천, 증거/오류, 리포트 에이전트/조립/영속화와 가짜 Discord 전달을 대상으로 한다. 실제 원천 어댑터와 개발 환경 간이 점검의 정확한 매핑은 PRD 05가 소유하며 아직 @@ -57,7 +64,7 @@ Node/TypeScript 테스트 골격, 정본 증거/도구 오류/리포트와 PRD 0 성능 임계값은 다음 기준 환경에서 측정한다. -- Node.js 20.x, 의존성 잠금 파일 그대로 설치 +- Node.js 22.x (Docker와 같은 major), 의존성 잠금 파일 그대로 설치. Node.js 24.x의 CI 호환성 결과는 별도로 기록한다. - 운영 빌드, 테스트 전용 가짜 진단/리포트 모델, 도구와 Discord 전송 계층 - 최소 4 vCPU, 8 GiB RAM, 로컬 SSD 작업공간 - SQLite WAL + PRD 01의 사용 중 시간 초과 @@ -70,6 +77,9 @@ Node/TypeScript 테스트 골격, 정본 증거/도구 오류/리포트와 PRD 0 다른 환경에서 실행하면 CPU/RAM/OS/Node 버전, 부하, 표본 수를 결과와 함께 기록하고 임계값 비교 여부를 명시한다. +Node.js 20 기준의 과거 측정값이 있다면 새 Node.js 22 기준 결과와 직접 합산하거나 +동일 환경의 성능 근거로 취급하지 않는다. CI 런타임 정렬 자체는 성능 재검증 결과가 아니다. + ## 성공 지표 ### 정확성 및 추적성