Files
trex-core/docs/srs/Configuration/req-060_max-active-slots-config.md
T
genichinandClaude Opus 4.8 5330f32247 docs(batch): BAT-030 verification 승인 + REQ-056~065 Implemented (dcy-020 delivery 완료)
draft/confirm-batch-verification: BAT-030 AC 매핑(REQ-056·057·062·064·065) +
evidence(단위 367/PG 29/MQ 21, cutover 리허설 8건, run-the-app e2e) 기록,
Ready for Release: true → release-candidate 승격.
BAT-027/028/029 의 보류 사유(dcy-020 전체 delivery 미완)가 BAT-030 완성으로
해소되어 함께 release-candidate 승격.
confirm-req-implemented: REQ-056~065 전부 Approved → Implemented
(각 REQ Change Log CHG-20260610-IMPL + srs index 갱신).
실 운영 cutover(REQ-064)는 REL 단계 운영자 실행으로 위임.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-10 15:20:52 +09:00

3.8 KiB

req-060: 동시 활성 최대치(max_active_slots) per-instance TOML 설정

  • Status: Implemented
  • Type: Configuration
  • Priority: High
  • Owner: project maintainers

Intent

  • 동시 활성(holding) 슬롯 최대치 M 을 인스턴스별로 독립 제어하기 위해 per-instance TOML 설정 키로 노출한다. 영구 슬롯 전환으로 폐기되는 TREX_TOTAL_SLOTS(풀 크기)를 대체한다. (dcy-020 FR-2/OQ-6)

Requirement

  • DaemonInstanceConfig(REQ-048 per-instance TOML)에 max_active_slots(정수, M) 키를 추가하고 config/*.toml 에서 읽는다. admission(REQ-059)이 이 값을 capacity 게이트로 사용한다. env(TREX_*)·하드코딩 기본값은 채택하지 않으며, 기존 TREX_TOTAL_SLOTS 는 폐기한다. 미설정 시 부팅 실패 또는 명시적 검증 오류로 처리한다(암묵 기본값 금지).

Acceptance Criteria

  1. Given config/inst.toml 에 max_active_slots = N, When 데몬 기동, Then DaemonInstanceConfig.max_active_slots == N 이고 admission 이 N 을 M 으로 사용한다.
  2. Given max_active_slots 미설정, When 기동, Then 명시적 오류로 거부된다(암묵 기본값 사용 안 함).
  3. Given 두 인스턴스가 서로 다른 max_active_slots, When 각자 기동, Then 인스턴스별 독립 M 으로 동작한다.

Impacted Area

  • Docs: docs/data-model.md/docs/runtime-flows.md(설정), config/instance.example.toml
  • Modules: trex_core/runtime/config.py(DaemonInstanceConfig)
  • Tests: tests/runtime/test_config*.py

Notes

  • REQ-048(per-instance TOML 로더) 계열. TREX_TOTAL_SLOTS 폐기는 REQ-005/REQ-010 영향(change-req 검토).
  • 출처: dcy-020 FR-2, OQ-6.

Change Log

CHG-20260610-01

  • Date: 2026-06-10
  • Author: Justin Ko

Change Summary

  • dcy-020 FR-2/OQ-6 로부터 최초 생성(Proposed). max_active_slots per-instance TOML + TREX_TOTAL_SLOTS 폐기.

Intent

  • 동시 활성 최대치 M 을 인스턴스별 TOML 로 제어하도록 backlog 정규화.

Acceptance Criteria Delta

  • Added: TOML 로딩/미설정 거부/인스턴스별 독립 3개 기준
  • Updated: 없음
  • Removed: 없음

Impacted Area Delta

  • Docs: config/instance.example.toml, baseline 문서
  • Modules: runtime/config.py(DaemonInstanceConfig)
  • Tests: test_config*.py

Delivery Trace Delta

  • Batches: none
  • Releases: none

Revalidation Impact

  • Reverification Needed: no
  • Existing Implementation Invalidated: no
  • Status Recommendation: keep-current
  • Follow-up Action: confirm-req. REQ-048 계열, REQ-005/010(TREX_TOTAL_SLOTS) change-req 검토.

Validation Plan

  • TOML 키 로딩 + 미설정 거부 단위테스트 green.

CHG-20260610-02

  • Date: 2026-06-10
  • Author: Justin Ko

Change Summary

  • Status Proposed → Approved (confirm-req). 필수 필드·구체 AC 충족, source dcy-020(confirmed, handoff 승인)과 모순 없음.

Intent

  • delivery input 으로 승격.

Acceptance Criteria Delta

  • Added: 없음 / Updated: 없음 / Removed: 없음

Impacted Area Delta

  • Docs: docs/srs/index.md (Register Approved) / Modules: 없음 / Tests: 없음

Delivery Trace Delta

  • Batches: none / Releases: none

Revalidation Impact

  • Reverification Needed: no / Existing Implementation Invalidated: no / Status Recommendation: keep-current / Follow-up Action: suggest-batch-reqs / draft-batch.

Validation Plan

  • 승인 후 batch planning 에서 본 REQ AC 를 검증 기준으로 사용.

CHG-20260610-IMPL

  • Date: 2026-06-10
  • Author: Justin Ko
  • Type: status
  • Summary: Approved → Implemented (confirm-req-implemented). 근거: BAT-028(+BAT-030 M=용량 캡 의미 확정·e2e M=1) — 모든 AC 가 release-candidate 배치 verification 의 evidence 와 연결됨(단위 367/PG 29/MQ 21 passed + run-the-app 자산 중심 e2e). Blocking Issues 없음.