test(setup): 시험 timeout을 모두 desktop 실측값으로 주고 손 숫자를 거절한다 #39
Closed
donghyeon.kang
wants to merge 0 commits from
donghyeon.kang/fix/test-timeouts-measured AGit into main
pull from: donghyeon.kang/fix/test-timeouts-measured
merge into: :main
:main
:fix/r9-structure-locale
:fix/r9-adapter-carryover
:test/shared-build-lock-order
:ci/dependency-cache-same-filesystem
:ci/release-tag-for-a11y-review
:ci/merge-dependency-cache
:fix/test-timeouts-measured
:fix/feature-residue-word-boundary
:fix/provider-wait-stderr
:fix/provider-job-host-requirements
:fix/ungated-vitest-spec
:fix/a11y-evidence-routes
:fix/verify-parts-diagnostics
:claude/w2-fe-ci-perf-dce080
:fix/child-process-test-timeouts
:chore/layout-rules-r2-r5
:claude/fe-b-docs-korean-645f55
:chore/ci-merge-jobs
:chore/layout-3-merge
:claude/fe-c-harness-0ae061
:chore/layout-2-sample-removal
:chore/layout-1-cleanup
:docs/review-guide-pointer
:fix/maturity-review-2026-11-06
:fix/maturity-review-2026-11-05-b
:docs/improvement-manual
:fix/maturity-review-2026-11-05
:fix/session-subject-required
:fix/ui-design-audit-2026-11-01
:fix/maturity-review-2026-09-25
:lane/D
:lane/B
:fix/src-review-round3
:refactor/domain-scalable
:develop
:feature-frontend-optional-adapter-recipes
:feature-frontend-supply-chain-verification
:feature-frontend-test-registry-evidence-hardening
:frontend-test-registry-evidence-hardening
:feature-frontend-diagnostics-telemetry-runtime
:feature-frontend-i18n-message-formatting-contract
:feature-frontend-design-system-platform
:feature-frontend-form-page-platform
:feature-frontend-reference-feature-vertical-slice
:feature-frontend-routing-release-recovery-runtime
:feature-frontend-http-query-contract-execution
:feature-frontend-application-boundary-runtime
:feature-frontend-typescript-tooling-foundation
:feature-frontend-platform-capability-review
:feature-frontend-performance-route-contract
:feature-frontend-starter-experience-quality-contract
:feature-frontend-responsive-theme-contract
:feature-frontend-ui-primitives-gallery-contract
:feature-frontend-app-shell-navigation-contract
:feature-frontend-runtime-composition-contract
:feature-frontend-ci-quality-gates-contract
:feature-web-vitals-performance-budget-contract
:feature-frontend-release-cache-rollback-contract
:feature-accessibility-baseline-contract
:feature-frontend-project-bootstrap-toolchain-contract
:feature-frontend-operational-runbook-contract
:feature-frontend-contract-compatibility-governance
:feature-frontend-contract-registry-governance
:feature-frontend-browser-security-boundary-contract
:feature-frontend-build-bundle-supply-chain-contract
:feature-tailwind-design-token-styling-contract
:feature-sample-feature-slice-contract-fixture
:feature-frontend-render-recovery-boundary-contract
:feature-routing-navigation-guard-contract
:feature-boundary-mapper-viewmodel-contract
:feature-async-ui-state-contract
:feature-frontend-observability-logging-trace-contract
:feature-frontend-storage-registry-contract
:feature-server-state-caching-contract
:feature-frontend-auth-session-integration-contract
:feature-frontend-error-classification-boundary-contract
:feature-runtime-schema-validation-contract
:feature-api-client-response-envelope-contract
:feature-frontend-env-runtime-config-contract
:feature-frontend-architecture-enforcement-lint-contract
:feature-frontend-test-taxonomy-contract
:feature-frontend-clean-architecture-layering-contract
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
donghyeon.kang (동현 강)
Clear assignees
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: donghyeon.kang/clean-architecture-frontend-template#39
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
자식 프로세스 시험의 timeout은 desktop에서 잰 가장 긴 실행으로
childProcessTimeout(<ms>)에 준다(docs/work/reference/testing.md2절). 그런데 기본값이 아니라서tests/setup.ts검사에 걸리지 않는 손 숫자가 남아 있었고, taxonomy는 옛 상수를 예로 들었다(round9 이월 1112/03-08 T-08, Low·P3). AST로 다시 세면 80곳이다(리뷰의 54곳 중 둘은evaluateSoak인자라 timeout이 아니고, 상수·hook·여러 줄 형태가 더 있었다).실측으로 보면 손 숫자가 모자란 곳이 있었다. system 시험의 provider 묶음(
candidate archive and provider upload boundaries) 30초는 desktop 시스템 컨테이너 여섯 번 중 두 번 넘겼다(30,051ms·30,037ms에서 시간 초과).고른 방법과 버린 대안
childProcessTimeout(<ms>)에 넘긴다. coverage 묶음(maxWorkers=4)·test:unit 각 9회, integration 3회, scale 3회, 시스템 컨테이너 tests/system 6회(JSON reporter). hook은 파일 시간에서 시험 합을 뺀 값(전용 reporter), 시간 초과로 끝난 실행은 그 시간을 하한으로 넣었다.PROCESS_HEAVY_TIMEOUT_MS넷,PROVIDER_BASE_FIXTURE_TIMEOUT_MS)은 지운다. 한 파일에서 여럿이 쓰는 값만const VERIFY_TIMEOUT = childProcessTimeout(15_807)처럼 둔다. guardian 시험의 lease는 시험 timeout이 아니라childProcessTimeout(0)(helper 최소 30초)이다.tests/unit/test-timeout-declarations.test.ts: tests/의 Vitest 파일을 Babel로 읽어 시험·describe·hook의 timeout 인자가 helper 호출(또는 그것을 담은 파일 상수)이 아니면 파일:줄로 실패한다. 프로세스 안에서 도는 긴 시험(scale tier)도 같은 helper를 쓴다..claude/rules/tests.md9번, helper 머리 주석.tests/setup.ts검사를 「helper가 만든 값이 아닌 timeout」으로 넓히기(helper 값이 30초 단위라 손으로 쓴60_000과 못 가리고, hook·프로세스 안 시험은 못 봄), 프로세스 안 시험의 손 숫자 남기기(근거 없는 숫자와 검사 예외가 남음).위험과 영향
it("x", run, 30_000))은 못 찾는다.sandboxed external provider failed: exit=125로 연달아 실패했다. 메시지에 sandbox stderr가 없어 원인 단계를 모른다(공유 노트에 기록, 후속 후보).바뀐 값
tests/integration/http-scenario-catalog.test.tstests/integration/security-followup-archive.test.tstests/integration/vitest-collection.test.tstests/scale/composition-scale.test.tstests/scale/global-local-independence.test.tstests/scale/session/long-session.test.tstests/scale/traffic/failure-scenarios.test.tstests/system/ci-runner/ci-artifact-contract.test.tstests/system/ci-runner/ci-evidence-freshness.test.tstests/unit/architecture-lint-fixtures.test.tstests/unit/build-environment-bundle.test.tstests/unit/design-system-initial-chunk.test.tstests/unit/documentation-readiness.test.tsVERIFY_TIMEOUT하나)tests/unit/feature-shape-growth.test.tstests/unit/fixture-node-modules.test.tstests/unit/lab-performance.test.tstests/unit/manual-code-blocks.test.tstests/unit/manual-paired-backend-settings.test.tstests/unit/product-extension-typecheck.test.tstests/unit/product-feature-selection-build.test.tstests/unit/risk-coverage.test.tstests/unit/run-output-root-build.test.tstests/unit/second-api-feature-registries.test.tstests/unit/security-promotion-staging.test.tstests/unit/service-worker-build-output.test.tstests/unit/sub-path-deployment.test.tstests/unit/task3-selective-integration.test.tstests/unit/template-feature-removal-documents.test.tstests/unit/test-evidence-source-rules.test.tstests/unit/two-feature-install-typecheck.test.ts검증
scripts/verify.sh docsOK.CI=true scripts/verify.sh gate, 트리29fd3d21): FE-GATE-005 rc=0 192초, FE-GATE-007 rc=0 29초, FE-GATE-013 rc=0 195초(시스템 컨테이너), FE-GATE-020 rc=0 403초, 넷 다 status-after 0줄. 로그/tmp/claude-gates/w2fe2-t08-FE-GATE-0xx/./tmp/claude-gates/w2fe2-t08m/,-t08m2/,-t08m3/.리뷰어가 볼 곳
tests/unit/test-timeout-declarations.test.ts의timeoutArgument(시험은 콜백 뒤 인자 또는 옵션 객체, hook은 콜백 뒤 인자).tests/system/ci-runner/ci-artifact-contract.test.tsprovider 묶음 머리 주석과 값.tests/integration/provider-guardian-transaction.test.ts의LEASE_NOT_UNDER_TEST_MS.관련
91962e24.문제: 자식 프로세스 시험의 timeout은 `childProcessTimeout(<잰 ms>)`로 정한다(docs/work/reference/testing.md 2절). 그런데 기본값이 아니라서 `tests/setup.ts` 검사에 걸리지 않는 손 숫자가 남았다. 리뷰가 센 54곳 중 둘(`browser-soak.contract.test.ts`의 `evaluateSoak` 인자)은 timeout이 아니고, AST로 다시 세면 80곳이다: 시험·describe·hook에 쓴 숫자, `VERIFY_TIMEOUT`· `PROCESS_HEAVY_TIMEOUT_MS`(파일 넷에 따로)·`PROVIDER_BASE_FIXTURE_TIMEOUT_MS` 같은 상수, `PROCESS_WATCHDOG_MS * 3` 같은 식. taxonomy는 옛 상수를 예로 들었다. 실측으로 보면 손 숫자 하나가 모자랐다: system 시험의 provider 묶음 30초는 desktop 여섯 번 중 두 번 넘겼다. 고친 것: - 80곳을 desktop에서 잰 가장 긴 실행으로 `childProcessTimeout(<ms>)`에 넘긴다. coverage 묶음(maxWorkers=4)·test:unit 각 9회, integration 3회, scale(traffic·session·composition·global-local) 3회, 시스템 컨테이너의 tests/system 6회, JSON reporter로 받았다. hook은 파일 시간에서 시험 합을 뺀 값이다. 시간 초과로 끝난 실행은 그 시간을 하한으로 넣었다. - 상수 사본은 지운다. 한 파일 안에서 여럿이 쓰는 값만 `const X = childProcessTimeout(...)`로 둔다(`VERIFY_TIMEOUT`). guardian 시험의 lease는 시험 timeout이 아니라 `childProcessTimeout(0)`(helper의 최소 30초)로 둔다. - `tests/unit/test-timeout-declarations.test.ts`가 tests/의 Vitest 파일을 Babel로 읽어 시험·describe·hook의 timeout 인자가 helper 호출(또는 그것을 담은 파일 상수)이 아니면 파일과 줄로 실패한다. 프로세스 안에서 도는 긴 시험(scale tier)도 같은 helper를 쓴다. - taxonomy 예시, testing.md 2절, `.claude/rules/tests.md` 9번, helper 머리 주석을 같은 방법으로 맞춘다. 버린 대안: - `tests/setup.ts` 검사를 「helper가 만든 값이 아닌 timeout」까지 넓히기. helper 값은 30초 단위 숫자라 손으로 쓴 60_000과 가릴 수 없고, hook과 프로세스 안 시험은 보지 못한다. - 프로세스 안 시험은 손 숫자 그대로 두기. 근거 없는 숫자가 남고 검사가 예외를 가져야 한다. 위험·한계: - 값이 커진 곳이 있다(15배 규칙): `manual-code-blocks` 300초 → 900초, provider 묶음 30초 → 480초 등. hang을 늦게 잡는다. 줄어든 곳도 있다 (scale traffic 60초 → 30초 등, 잰 값의 15배 안). - 측정은 desktop 부하 6~35에서 했다. runner가 더 느리면 다시 잰다. - 검사 시험은 Vitest 파일 전부를 파싱해 coverage 묶음에서 최대 13.5초 걸렸고, 그 값으로 자기 timeout을 준다. 이름 있는 함수를 콜백으로 넘긴 시험(`it("x", run, 30_000)`)은 못 찾는다. - 다운스트림: 손 숫자 timeout이 있는 제품 시험은 test:unit에서 이 검사에 걸린다. 메시지가 helper를 알린다. 검증(desktop): - RED: 검사 시험이 고치기 전 80곳을 파일·줄로 내고 실패. GREEN: 검사· child-process-timeout 6개 통과. check:types·eslint(바뀐 34파일) rc=0, verify:documentation PASS_SCOPED, 노트북 `scripts/verify.sh docs` OK. - 측정 원자료: /tmp/claude-gates/w2fe2-t08m, -t08m2, -t08m3. - 게이트 결과는 PR 본문에 적는다. Refs: 1112/03-08donghyeon.kang referenced this pull request2026-11-12 22:16:55 +00:00
#40으로 병합됐다(main
ee47480c). 이 PR의 headceaf316f가 #40 브랜치에 merge 커밋으로 들어 있고, #40의 runner merge job 셋이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).Pull request closed