Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 6 additions & 3 deletions .github/workflows/current-code-validation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -11,17 +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:
ref: ${{ github.event.pull_request.head.sha || github.sha }}
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
Expand Down
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ Gate Status: <blocked | ready_for_design | ready_for_implementation | ready_for_

- 의존성 또는 TypeScript 변경 후 `npm run typecheck`와 `npm run build`를 실행합니다.
- 의존성이 없거나 잠금 파일이 변경된 경우에만 `npm ci`를 사용합니다.
- `npm test`는 현재 코드의 TypeScript 테스트 타입 검사와 테스트 실행을 포함합니다. 통과를 전체 P0 또는 실제 원천 검증 완료로 해석하지 않습니다.
- `npm test`는 현재 코드의 TypeScript 테스트 타입 검사 후 테스트를 재귀적으로 실행하며 테스트 파일이 없으면 실패합니다. 통과 범위는 실행된 테스트에 한정하고 전체 P0 또는 실제 원천 검증 완료로 해석하지 않습니다.
- 단위, 통합, 동시성 검증은 사용자가 실제 환경을 명시적으로 승인하지 않는 한 가짜 제공자와 가짜 도구를 사용해야 합니다.

## AMDC 기본값
Expand Down
21 changes: 20 additions & 1 deletion docs/prd/current/04-verification-and-handoff.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,22 @@ ReportAgent 인계, 정본 영속화 또는 전달 실패 검증이 아니다.
상태에서 통과했다. 이 결과는 TypeScript 정적 검사 근거일 뿐 REST, Run/SQLite,
도구 코어, Evidence/Report, 실패 주입이나 Discord 전달 순서를 검증하지 않는다.

### 2026-09-24 현재 코드 CI 판정 (PAAR/PAR)

- Problem: `develop@795990e`의 CI는 PR head를 직접 체크아웃해 병합 결과를 검증하지 않는다. 충돌한 PR에서는 `pull_request` 실행 자체가 멈추므로 체크가 없는 상태를 통과로 해석할 수 없다.
- Analyze: 기존 워크플로의 기본 PR merge 체크아웃을 사용하면 하나의 체크에서 통합 결과를 검증한다. 새 head 전용 워크플로는 중복 실행과 서로 다른 통과 신호를 만들고, 충돌로 막힌 PR 이벤트도 해결하지 못한다.
- Action: 기존 워크플로의 명시적 head 체크아웃만 제거한다. Linux Node.js 20에서 `npm ci`, `npm test`, `npm run typecheck`, `npm run build`를 유지한다. 실제 AMDB/OpenAI 자격 증명과 Docker 운영 환경, PR 충돌 해결, 제품 코드 수정은 범위 밖이다. 롤백은 체크아웃 변경을 되돌리는 것이다.
- Result: 충돌 없는 `develop` 대상 PR의 테스트 대상이 GitHub 생성 merge ref이며 네 명령 중 하나라도 실패하면 단일 CI job이 실패해야 한다. `develop` push는 해당 커밋을 검사한다. 워크플로 구문, 로컬 명령 결과와 PR의 실제 체크 SHA를 각각 확인한다.

`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가 소유하며 아직
Expand All @@ -48,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의 사용 중 시간 초과
Expand All @@ -61,6 +77,9 @@ Node/TypeScript 테스트 골격, 정본 증거/도구 오류/리포트와 PRD 0
다른 환경에서 실행하면 CPU/RAM/OS/Node 버전, 부하, 표본 수를 결과와 함께
기록하고 임계값 비교 여부를 명시한다.

Node.js 20 기준의 과거 측정값이 있다면 새 Node.js 22 기준 결과와 직접 합산하거나
동일 환경의 성능 근거로 취급하지 않는다. CI 런타임 정렬 자체는 성능 재검증 결과가 아니다.

## 성공 지표

### 정확성 및 추적성
Expand Down
Loading