gitea-agent-testbed/docs/requirements/req-002_conversation-interaction.md

schema, id, title, revision, status, depends_on, applies_to, language

schema	id	title	revision	status	depends_on	applies_to	language
proofline.requirement/v1	REQ-002	대화 입력과 고정 응답 상호작용	0.1	draft	REQ-001	Textual 대화형 TUI 입력 정규화와 메시지 누적 고정 응답 선택과 표시 빈 입력 처리와 종료 동작	ko

REQ-002 — 대화 입력과 고정 응답 상호작용

1. 목적

이 요구사항은 Textual 기반 대화형 TUI에서 사용자가 제출한 입력을 정규화하고, 유효한 사용자 메시지와 고정 응답을 세션 내 대화 영역에 제출 순서대로 누적 표시하는 동작을 정의한다. 입력의 양끝 공백은 제거하고, 빈 문자열이나 공백만 포함한 입력은 응답 선택과 대화 상태 변경 없이 무시한다. 유효하거나 무효인 제출이 끝나면 입력창을 비운다.

사용자 메시지와 에이전트 응답은 명시적인 역할, 라벨 및 구조적 스타일로 구분한다. 유효한 입력마다 정본으로 정의된 고정 응답 목록에서 하나를 표준 난수 방식으로 선택하며, 사용자 메시지 바로 뒤에 에이전트 응답을 표시한다. Escape와 Ctrl+Q는 동일한 애플리케이션 종료 동작을 요청한다. 프로젝트 설치와 실행 진입점은 선행 프로젝트 스캐폴드 요구사항을 따르며, 이 문서는 대화 상호작용의 의미와 검증 기준만 관리한다.

2. 배경

애플리케이션은 Python 3.11 이상과 Textual 런타임을 사용하는 로컬 TUI로 제공된다. 사용자는 입력창에 문자열을 작성하고 Enter로 제출한다. 시스템은 제출된 문자열의 양끝 공백을 제거한 뒤 유효성을 판단하고, 유효한 입력에 대해서만 사용자 메시지와 고정 응답을 생성하여 표시한다.

메시지와 응답은 실행 중인 세션의 메모리 상태로만 관리한다. 외부 API, LLM, 네트워크 서비스, 데이터베이스 또는 영속 저장소는 사용하지 않는다. 프로젝트 패키징과 실행 진입점은 선행 프로젝트 스캐폴드 요구사항에서 관리하며, 입력 정규화, 메시지 누적, 고정 응답 선택과 표시, 빈 입력 처리, 입력창 초기화 및 종료 동작은 이 문서에서 단일 정본으로 관리한다. 근거는 원본 Gitea 이슈 8의 요구사항 재작업 요청이다.

3. 범위

포함 범위는 다음과 같다.

• 입력 양끝의 공백 제거와 정규화 결과에 따른 유효 입력 판정
• 유효한 사용자 메시지와 고정 응답의 세션 내 누적 및 표시
• 정본 고정 응답 목록을 대상으로 하는 표준 난수 선택
• 사용자 메시지 뒤에 에이전트 응답을 배치하는 순서 보장
• 사용자와 에이전트의 역할, 라벨 및 구조적 스타일 구분
• 빈 문자열, 공백, 탭 또는 줄바꿈만 포함한 입력의 무시
• 유효하거나 무효인 제출 후 입력창 초기화
• Escape와 Ctrl+Q에 의한 동일한 종료 요청
• 선행 프로젝트 스캐폴드 요구사항과의 의존 관계 및 원본 이슈 8 추적성

제외 범위는 다음과 같다.

• 프로젝트 패키징, 설치 설정 및 실행 진입점 자체의 변경
• 외부 API, LLM, 네트워크 서비스, 데이터베이스 또는 영속 저장소 연동
• 사용자 인증, 권한 관리, 다중 세션, 메시지 복원 또는 대화 저장
• 고정 응답 문구, 입력 처리 순서와 기존 사용자 인터페이스 의미의 변경
• 새로운 의존성, 배포 방식 또는 실행 환경의 추가

프로젝트 구조, 패키징 메타데이터와 실행 기반은 선행 프로젝트 스캐폴드 요구사항을 정본으로 사용하며 이 문서에서 중복 정의하지 않는다.

포함

사용자 입력의 양끝 공백 제거와 유효성 판정, 유효 메시지와 고정 응답의 세션 내 누적 및 표시, 표준 난수 방식의 응답 선택, 사용자와 에이전트의 역할별 표시, 빈 입력 무시, 제출 후 입력창 초기화, Escape와 Ctrl+Q 종료 요청 및 선행 프로젝트 스캐폴드와의 의존 관계와 원본 이슈 추적성을 포함한다.

제외

프로젝트 패키징, 설치 설정 및 실행 진입점의 변경, 외부 API·LLM·네트워크 서비스·데이터베이스·영속 저장소 연동, 사용자 인증과 다중 세션 관리, 메시지 복원, 새로운 의존성·배포 방식·실행 환경 추가는 포함하지 않는다.

4. 용어와 기준

입력은 사용자가 입력창에서 제출한 문자열이다. 정규화는 문자열 양끝의 공백을 제거하는 처리이며 문자열 내부의 공백은 변경하지 않는다. 정규화 결과가 빈 문자열이면 유효하지 않은 입력으로 판단한다.

유효한 제출은 정규화된 사용자 메시지와 고정 응답 목록에서 선택된 에이전트 응답으로 구성된다. 사용자 메시지는 사용자 역할과 사용자 라벨을 갖고, 응답은 에이전트 역할과 에이전트 라벨을 갖는다. 역할과 본문은 세션 메시지의 정본 상태이며, 라벨과 구조적 스타일은 이 역할에서 파생한다.

고정 응답 목록은 다음 다섯 문구로 구성한다.

• 안녕하세요! 무엇을 도와드릴까요?
• 그것은 제가 처리하기 불가능합니다.
• 맡겨만 주세요.
• 지금 처리 중입니다.
• 작업을 완료하였습니다.

유효한 입력마다 목록 전체를 대상으로 표준 난수 선택을 한 번 수행한다. 선택된 응답은 대응하는 사용자 메시지 바로 뒤에 배치한다. 종료 요청은 Escape 또는 Ctrl+Q 입력으로 발생하며, 종료 과정에서 외부 상태나 영속 데이터를 생성하지 않는다.

선행 프로젝트 스캐폴드 요구사항은 프로젝트 구조, 패키징 및 실행 진입점의 정본이다. 이 문서는 해당 실행 기반에 의존하지만 그 계약을 재정의하거나 대화 기능과 패키징 기능을 하나의 요구사항 정체성으로 합치지 않는다.

5. 요구사항

시스템은 입력 제출 시 입력 양끝의 공백을 제거한 값을 처리 대상으로 사용해야 한다. 정규화 결과가 비어 있지 않을 때만 사용자 메시지를 세션 상태와 화면에 기록해야 하며, 빈 문자열이나 공백·탭·줄바꿈만 포함한 입력은 응답 선택과 메시지 추가 없이 무시해야 한다. 이 동작은 입력 위젯의 제출 이벤트, 대화 표시 흐름 및 관련 경계 테스트에 영향을 준다.

유효한 입력마다 정본으로 정의된 다섯 개 응답 목록 전체에서 표준 난수 방식으로 응답 하나를 선택해야 한다. 정규화된 사용자 메시지를 사용자 역할로 먼저 추가하고 선택된 응답을 에이전트 역할로 바로 뒤에 추가해야 하며, 여러 입력을 제출해도 기존 항목을 삭제하거나 재배열하지 않고 제출 순서대로 누적해야 한다. 이 동작은 세션 대화 상태, 대화 영역의 표시 순서, 응답 선택 기록 및 회귀 테스트에 영향을 준다.

유효하거나 무효인 제출이 발생하면 입력창을 빈 문자열로 초기화해야 한다. 입력창 초기화는 메시지 처리의 성공 여부와 독립적으로 수행되어야 하며, 초기화 뒤 다음 입력을 받을 수 있어야 한다. 이미 기록된 메시지와 응답은 입력창 초기화로 삭제되거나 변경되지 않아야 한다.

각 대화 메시지는 사용자 또는 에이전트 역할을 명시적으로 보유해야 한다. 사용자 메시지는 사용자 라벨과 사용자용 구조적 스타일로, 고정 응답은 에이전트 라벨과 에이전트용 구조적 스타일로 표시해야 한다. 라벨과 스타일은 본문 문자열이나 색상만으로 결정하지 않고 메시지 역할에서 일관되게 파생해야 한다.

사용자가 Escape 또는 Ctrl+Q를 입력하면 현재 Textual 애플리케이션의 동일한 종료 동작을 요청해야 한다. 종료 입력은 메시지 제출이나 응답 선택으로 해석되어서는 안 되며, 종료 과정에서 외부 API, 네트워크 서비스, 데이터베이스 또는 영속 저장소를 호출하지 않아야 한다.

대화 처리는 선행 프로젝트 스캐폴드 요구사항이 제공하는 설치 및 실행 환경에서 동작해야 한다. 프로젝트 구조, 패키징 메타데이터와 실행 진입점은 선행 요구사항에서만 관리하고, 입력 정규화와 대화 누적, 고정 응답 선택과 표시, 빈 입력 처리, 입력창 초기화 및 종료 동작은 이 문서에서만 정본으로 관리하여 두 문서 사이의 기능 규칙과 인수 기준 중복을 방지해야 한다.

REQ-002.01 — 입력 정규화와 유효 입력 판정

시스템은 입력창에 제출된 문자열의 양끝 공백을 제거한 값을 정규화된 입력으로 사용해야 한다. 정규화 결과가 비어 있지 않으면 이를 유효한 사용자 메시지로 처리하고, 빈 문자열이나 공백·탭·줄바꿈만 포함한 입력은 유효한 메시지로 처리하지 않아야 한다. 무효 입력에서는 응답을 선택하거나 대화 항목을 추가하지 않아야 하며, 문자열 내부의 공백은 변경하지 않아야 한다.

영향 범위

입력 위젯의 제출 이벤트, 대화 상태와 화면 표시 흐름에 영향을 준다. 영속성은 없으며 메시지는 실행 중인 세션 메모리에만 유지한다. 후속 사용 주체는 TUI 사용자와 대화 상태를 검증하는 자동 테스트다. 마이그레이션은 필요하지 않으며, REQ-001이 제공하는 Textual 실행 환경을 전제로 한다.

REQ-002.02 — 유효 메시지와 고정 응답을 제출 순서대로 누적한다

유효한 입력이 제출되면 시스템은 정규화된 사용자 메시지를 사용자 역할로 먼저 대화 상태와 화면에 추가해야 한다. 이어서 다음 다섯 개의 고정 응답 목록 전체를 대상으로 표준 난수 선택을 한 번 수행하고, 선택된 응답을 에이전트 역할로 사용자 메시지 바로 뒤에 추가해야 한다: 안녕하세요! 무엇을 도와드릴까요?, 그것은 제가 처리하기 불가능합니다., 맡겨만 주세요., 지금 처리 중입니다., 작업을 완료하였습니다. 여러 입력을 제출하면 기존 항목을 삭제하거나 재배열하지 않고 각 메시지 쌍을 제출 순서대로 누적해야 한다.

영향 범위

세션 대화 상태, 대화 영역의 메시지 본문·역할·순서와 고정 응답 선택 흐름에 영향을 준다. 영속성은 없으며 사용자, Textual 렌더링 계층과 회귀 테스트가 후속 사용 주체다. 마이그레이션은 필요하지 않고 기존 고정 응답 문구와 표준 난수 선택 방식을 유지한다.

REQ-002.03 — 제출 후 입력창을 초기화한다

입력 제출 이벤트가 발생하면 시스템은 제출된 값의 유효성이나 처리 결과와 관계없이 입력 위젯의 값을 빈 문자열로 초기화해야 한다. 입력창 초기화는 유효한 메시지 처리와 독립적으로 수행되어야 하며, 초기화가 끝난 뒤 사용자가 다음 입력을 제출할 수 있어야 한다.

영향 범위

Textual 입력 위젯의 값과 연속 입력 흐름에 영향을 준다. 영속성은 없으며 TUI 사용자와 입력 이벤트 테스트가 후속 사용 주체다. 마이그레이션은 필요하지 않고 유효·무효 입력 제출 후 입력창을 비우는 기존 동작을 유지한다.

REQ-002.04 — 메시지 역할에 따라 라벨과 구조적 스타일을 표시한다

시스템은 각 대화 메시지에 사용자 또는 에이전트의 명시적인 역할을 보유하게 해야 한다. 사용자 메시지는 사용자 라벨과 사용자용 구조적 스타일로 표시하고, 고정 응답은 에이전트 라벨과 에이전트용 구조적 스타일로 표시해야 한다. 라벨과 스타일은 본문 문자열이나 색상만으로 결정하지 않고 메시지 역할에서 일관되게 파생해야 한다.

영향 범위

대화 영역의 메시지 모델, 표시 문자열, 역할별 식별자와 구조적 스타일에 영향을 준다. 영속성은 없으며 사용자, 화면 검수자와 렌더링 테스트가 후속 사용 주체다. 마이그레이션은 필요하지 않고 기존 사용자·에이전트 표시 순서와 역할 구분 의미를 유지한다.

REQ-002.05 — 종료 단축키로 동일한 애플리케이션 종료를 요청한다

사용자가 Escape 또는 Ctrl+Q를 입력하면 시스템은 현재 Textual 애플리케이션의 종료 동작을 요청해야 한다. 두 단축키는 동일한 종료 경로를 사용해야 하며, 종료 입력은 메시지 제출이나 응답 선택으로 해석되어서는 안 된다. 종료 과정에서 외부 API, 네트워크 서비스, 데이터베이스 또는 영속 저장소를 호출하지 않아야 한다.

영향 범위

Textual 키 바인딩과 애플리케이션 생명 주기에 영향을 준다. 영속성은 없으며 사용자, 운영자와 종료 회귀 테스트가 후속 사용 주체다. 마이그레이션은 필요하지 않고 기존 Escape 및 Ctrl+Q 종료 방식을 유지한다. REQ-001의 선행 실행 계약이 충족되어야 한다.

6. 제약과 불변조건

• 입력은 제출 시 문자열의 양끝 공백을 제거한 값으로 정규화하며, 문자열 내부의 공백은 변경하지 않는다.
• 정규화 결과가 빈 문자열이면 사용자 메시지와 에이전트 응답을 추가하지 않고 고정 응답 선택도 수행하지 않는다.
• 유효한 입력 하나는 정규화된 사용자 메시지와 고정 응답 하나로 구성되며, 사용자 메시지가 먼저 기록되고 응답이 바로 뒤따라야 한다.
• 여러 입력의 메시지 쌍은 기존 항목을 삭제하거나 재배열하지 않고 제출 순서대로 누적한다.
• 고정 응답은 정본으로 정의된 다섯 문구 중 표준 난수 선택으로 하나를 결정한다.
• 유효 입력과 무효 입력 모두 제출이 끝나면 입력창을 빈 문자열로 초기화한다.
• 메시지의 역할, 라벨 및 구조적 스타일은 명시적인 역할 값에서 파생하며 본문 내용이나 색상만으로 역할을 판정하지 않는다.
• 사용자 메시지와 에이전트 응답은 각각 사용자 또는 에이전트 역할과 비어 있지 않은 본문을 함께 보유한다.
• Escape와 Ctrl+Q는 동일한 종료 요청 경로를 사용하며, 종료 입력은 메시지 제출이나 응답 선택으로 처리하지 않는다.
• 메시지와 응답은 현재 실행 세션의 메모리에만 보관하고 외부 API, 네트워크 서비스, 데이터베이스 또는 영속 저장소를 사용하지 않는다.
• 프로젝트의 설치, 패키징 및 실행 기반은 선행 프로젝트 스캐폴드 요구사항을 따르며 이 문서에서 그 계약을 재정의하지 않는다.
• 새로운 외부 연동, 의존성, 배포 방식 또는 실행 환경을 추가하지 않는다.

7. 인수 기준

• 양끝에 공백이 포함된 유효한 문자열을 제출하면 대화 상태와 화면에는 공백이 제거된 본문만 사용자 메시지로 기록되어야 한다. 검증은 Textual 테스트 앱에서 입력값과 저장된 메시지 및 표시값을 비교하는 방식으로 수행하며, 원본 양끝 공백이 후속 처리에 사용되지 않는지 확인한다.
• 빈 문자열과 공백, 탭, 줄바꿈만 포함한 값을 제출하면 메시지 목록, 응답 선택 기록 및 대화 영역 항목 수가 변하지 않아야 한다. 각 경계 입력을 제출하고 선택 함수가 호출되지 않았는지와 부분 메시지가 남지 않았는지를 확인한다.
• 유효한 입력마다 사용자 메시지 하나와 고정 응답 하나가 생성되고 두 항목이 인접한 순서로 표시되어야 한다. 선택 결과를 고정한 뒤 세션 메시지 목록과 화면의 전체 순서를 비교하여 사용자 역할과 에이전트 역할이 뒤바뀌지 않았는지 검증한다.
• 고정 응답 선택은 정본으로 정의된 다섯 문구 전체를 대상으로 유효 입력마다 한 번 수행되어야 한다. 선택 함수의 호출 인자와 호출 횟수를 감시하고, 반환된 값이 상태와 화면에 동일하게 반영되는지 확인한다.
• 두 개 이상의 유효 입력을 순서대로 제출하면 각 사용자 메시지와 응답 쌍이 기존 대화 뒤에 누적되어야 한다. 이전 항목의 삭제, 재배열, 중복 추가가 없는지 제출 기록과 메시지 목록을 함께 비교한다.
• 유효한 입력을 제출한 뒤 입력창 값은 빈 문자열이어야 하며 이미 기록된 메시지와 응답은 변경되지 않아야 한다. 양끝 공백을 포함한 입력을 사용하여 입력 위젯과 세션 상태를 함께 확인한다.
• 무효 입력을 제출한 뒤에도 입력창은 빈 문자열이어야 하며 기존 대화 상태와 화면은 그대로 유지되어야 한다. 빈 입력과 공백 입력을 각각 제출하여 입력창 초기화와 변경 없음 조건을 함께 검증한다.
• 사용자 메시지는 사용자 라벨과 사용자용 구조적 스타일을, 에이전트 응답은 에이전트 라벨과 에이전트용 구조적 스타일을 사용해야 한다. 렌더링 문자열, 역할 값, 스타일 식별자 및 역할별 구조 규칙을 서로 대조한다.
• Escape와 Ctrl+Q는 각각 애플리케이션 종료를 정확히 한 번 요청하고 메시지 제출이나 응답 선택을 발생시키지 않아야 한다. 두 키를 별도로 입력하여 동일한 종료 경로와 상태 불변조건을 확인한다.
• 대화 기능은 선행 프로젝트 스캐폴드의 설치 및 실행 환경에서 동작해야 하며, 패키징과 실행 진입점의 상세 기준을 중복 판정하지 않는다. 설치 환경을 준비한 뒤 대화 회귀 검증을 수행한다.
• 실행하지 않은 검증은 성공 결과나 특정 커밋의 실행 증거로 기록하지 않으며, 테스트 정의와 실제 실행 결과를 별도로 관리한다.

REQ-002.01-AC01 — 양끝 공백이 제거된 입력을 처리한다

판정 기준

양끝에 공백이 포함된 유효한 입력을 제출했을 때 대화 상태와 화면에 공백이 제거된 본문만 사용자 메시지로 기록되면 통과로 판정한다.

검증

Textual 테스트 앱에서 양끝 공백이 포함된 입력을 제출하고 제출 기록, 메시지 본문과 화면 표시값을 비교한다. 문자열 내부 공백은 그대로 유지되는지도 확인한다.

검증 분류

integration

상태 불변조건

성공 후 사용자 메시지에는 정규화된 본문만 존재해야 하며 원본 양끝 공백은 화면이나 후속 응답 처리에 사용되지 않아야 한다.

REQ-002.01-AC02 — 빈 입력과 공백 입력을 무시한다

판정 기준

빈 문자열 또는 공백·탭·줄바꿈만 포함한 입력을 제출해도 응답 선택, 메시지 추가와 새 화면 항목 생성이 발생하지 않으면 통과로 판정한다.

검증

경계 입력을 각각 제출하고 메시지 목록, 응답 선택 기록과 대화 영역 항목 수를 비교한다. 응답 선택 함수가 호출되지 않았는지도 확인한다.

검증 분류

integration

상태 불변조건

무효 입력 처리 후 기존 대화 상태와 화면은 변경되지 않아야 하며 부분적인 사용자 메시지나 응답이 남아서는 안 된다.

REQ-002.02-AC01 — 사용자 메시지 뒤에 고정 응답을 표시한다

판정 기준

유효한 입력 하나를 제출했을 때 정규화된 사용자 메시지와 고정 목록에서 선택된 응답이 인접한 순서로 표시되고 각각 사용자와 에이전트 역할을 가지면 통과로 판정한다.

검증

응답 선택 결과를 고정한 Textual 테스트에서 입력을 제출하고 내부 메시지 목록과 대화 영역의 순서를 확인한다. 두 항목의 본문과 역할이 서로 바뀌거나 합쳐지지 않았는지도 검증한다.

검증 분류

integration

상태 불변조건

사용자 메시지는 대응하는 응답보다 먼저 존재해야 하며 각 메시지의 역할과 본문은 독립적으로 보존되어야 한다.

REQ-002.02-AC02 — 고정 목록에서 한 번 응답을 선택한다

판정 기준

유효한 입력마다 선언된 다섯 개 응답 전체를 대상으로 표준 난수 선택이 한 번 수행되고 선택 결과가 상태와 화면에 동일하게 반영되면 통과로 판정한다.

검증

난수 선택 함수를 감시하거나 결과를 고정하여 유효 입력을 제출하고 호출 인자와 표시된 응답을 비교한다. 무효 입력에서 선택이 발생하지 않는지도 확인한다.

검증 분류

unit

상태 불변조건

응답은 정본 고정 목록 밖의 값이 될 수 없으며, 무효 입력에서는 선택 상태가 변경되지 않아야 한다.

REQ-002.02-AC03 — 여러 제출을 기존 순서 뒤에 누적한다

판정 기준

서로 다른 유효 입력을 두 번 이상 제출했을 때 각 입력과 대응 응답 쌍이 제출 순서와 동일하게 상태와 화면에 누적되면 통과로 판정한다.

검증

두 개 이상의 입력을 순서대로 제출하고 제출 기록, 선택 응답, 메시지 목록과 렌더링 순서를 비교한다.

검증 분류

integration

상태 불변조건

새 제출은 기존 메시지를 삭제하거나 재정렬하지 않아야 하며 유효한 입력마다 사용자 메시지 하나와 응답 하나만 추가되어야 한다.

REQ-002.03-AC01 — 유효 입력 제출 후 입력창을 비운다

판정 기준

양끝 공백을 포함한 유효한 입력을 제출한 직후 입력 위젯의 값이 빈 문자열이고 정규화된 메시지와 응답은 정상적으로 보존되면 통과로 판정한다.

검증

입력 위젯에 유효값을 설정하고 Enter를 누른 뒤 위젯 값, 메시지 목록과 대화 영역을 확인한다.

검증 분류

integration

상태 불변조건

입력창 초기화는 이미 기록된 사용자 메시지와 응답을 삭제하거나 변경해서는 안 된다.

REQ-002.03-AC02 — 무효 입력 제출 후에도 입력창을 비운다

판정 기준

빈 값 또는 공백만 포함한 값을 제출한 뒤 입력 위젯의 값이 빈 문자열이고 대화 상태와 응답 선택 상태가 변경되지 않으면 통과로 판정한다.

검증

빈 입력과 공백 입력을 각각 제출하고 제출 후 입력 위젯 값, 메시지 목록, 응답 선택 기록과 화면 항목 수를 비교한다.

검증 분류

integration

상태 불변조건

입력창은 비워져야 하지만 기존 대화 상태와 표시 영역은 그대로 유지되어야 하며 새 항목이 추가되어서는 안 된다.

REQ-002.04-AC01 — 역할에 맞는 라벨을 표시한다

판정 기준

사용자 메시지가 사용자 라벨을 사용하고 에이전트 응답이 에이전트 라벨을 사용하며 각 라벨이 해당 메시지 역할과 일치하면 통과로 판정한다.

검증

유효한 입력을 제출한 뒤 대화 영역의 두 표시 항목을 조회하여 렌더링 문자열과 내부 역할을 비교한다.

검증 분류

integration

상태 불변조건

메시지 역할과 표시 라벨은 항상 일치해야 하며 한 역할의 라벨이 다른 역할에 적용되어서는 안 된다.

REQ-002.04-AC02 — 역할별 구조적 스타일을 유지한다

판정 기준

사용자와 에이전트 표시 항목이 서로 구별되는 구조적 식별자와 스타일을 사용하고 역할 구분이 색상에만 의존하지 않으면 통과로 판정한다.

검증

대화 영역의 표시 항목과 애플리케이션 스타일 규칙을 확인하여 역할별 식별자와 테두리 또는 정렬 차이가 존재하고 각 역할에 올바르게 적용되는지 검증한다.

검증 분류

integration

상태 불변조건

메시지 역할과 구조적 스타일은 서로 불일치해서는 안 되며 본문 내용만으로 스타일이 임의 변경되어서는 안 된다.

REQ-002.05-AC01 — Escape 입력으로 종료를 요청한다

판정 기준

실행 중인 애플리케이션에서 Escape를 입력했을 때 종료 동작이 한 번 요청되고 메시지 제출이나 응답 선택이 발생하지 않으면 통과로 판정한다.

검증

종료 동작을 감시하는 Textual 테스트에서 Escape를 입력하고 종료 요청 횟수와 메시지·응답 상태의 변경 여부를 확인한다.

검증 분류

end-to-end

상태 불변조건

Escape 입력은 새 메시지나 응답을 생성하거나 입력 제출로 처리되어서는 안 된다.

REQ-002.05-AC02 — Ctrl+Q 입력으로 동일한 종료를 요청한다

판정 기준

실행 중인 애플리케이션에서 Ctrl+Q를 입력했을 때 Escape와 동일한 종료 경로가 한 번 요청되면 통과로 판정한다.

검증

Ctrl+Q를 입력하고 Escape 검증과 동일한 종료 요청 횟수, 호출 경로와 상태 불변조건을 비교한다.

검증 분류

end-to-end

상태 불변조건

Ctrl+Q는 Escape와 다른 메시지 처리 경로를 사용해서는 안 되며 종료 시 대화 상태와 입력 처리 기록을 변경해서는 안 된다.

8. 오류 및 충돌 계약

• 입력 위젯이나 제출 이벤트를 사용할 수 없는 초기화 실패는 정상적인 대화 처리로 판정하지 않으며, 부분적으로 생성된 메시지를 성공 결과로 남기지 않는다.
• 빈 문자열 또는 공백만 포함한 입력은 오류가 아니라 무시 가능한 입력으로 처리하고, 응답 선택과 메시지 추가를 수행하지 않는다.
• 응답 선택에 실패하면 해당 제출의 사용자 메시지와 에이전트 응답을 모두 완전한 쌍으로 기록하지 않으며, 앞서 성공한 세션 메시지는 변경하지 않는다.
• 고정 응답 목록이 비어 있거나 정본과 다르면 응답을 생성하지 않고 처리 실패로 식별한다.
• 메시지 렌더링에 실패하면 화면에 일부 항목만 남은 상태를 완전한 처리 성공으로 간주하지 않는다.
• 입력창 초기화에 실패하면 제출을 완전한 성공으로 판정하지 않으며, 이전 입력이 다음 제출에 재사용되지 않도록 실패 원인을 확인할 수 있어야 한다.
• 동일한 제출 이벤트를 자동으로 중복 처리하지 않으며, 단일 Textual 이벤트 루프의 처리 순서에 따라 한 번만 반영한다.
• 이미 종료된 애플리케이션에 대한 종료 요청은 새 메시지나 응답을 추가하거나 오류 상태를 정상 처리로 바꾸지 않는다.
• 외부 API, 네트워크, 파일 저장소 또는 데이터베이스 오류를 대화 처리를 위한 대체 경로로 사용하지 않는다.
• 선행 프로젝트 스캐폴드의 설치 또는 실행 조건을 충족하지 못한 상태에서는 대화 기능이 정상 제공된 것으로 판정하지 않는다.
• 프로젝트 구조와 실행 기반에 관한 충돌은 선행 스캐폴드 요구사항을 따르고, 입력·응답·표시·입력창·종료 동작에 관한 충돌은 이 문서의 대화 상호작용 계약을 따른다.
• 두 요구사항 문서는 서로의 범위를 임의로 확장하지 않으며 동일한 기능 규칙과 인수 조건을 중복 정의하지 않는다.

9. 데이터 및 인터페이스 계약

• 입력 인터페이스는 대화 입력 위젯에서 Enter로 제출되는 문자열 값이며, 제출 시 양끝 공백을 제거한다. 문자열 내부의 공백은 보존한다.
• 정규화된 입력이 비어 있지 않으면 사용자 메시지의 본문으로 사용하고, 비어 있으면 메시지 본문으로 저장하지 않는다.
• 고정 응답 목록은 다음 다섯 문구를 정본으로 사용한다: "안녕하세요! 무엇을 도와드릴까요?", "그것은 제가 처리하기 불가능합니다.", "맡겨만 주세요.", "지금 처리 중입니다.", "작업을 완료하였습니다.".
• 응답 선택은 정본 고정 응답 목록 전체를 표준 난수 선택 기능에 전달하여 수행하며, 유효한 입력마다 한 번만 실행한다.
• 세션 메시지는 사용자 또는 에이전트 역할과 비어 있지 않은 본문을 함께 보유한다. 유효한 제출 하나는 사용자 메시지와 대응하는 에이전트 응답의 두 항목으로 구성된다.
• 사용자 메시지는 사용자 라벨과 사용자용 구조적 스타일로, 에이전트 응답은 에이전트 라벨과 에이전트용 구조적 스타일로 표시한다. 표시 정보는 메시지 역할에서 파생한다.
• 메시지 쌍은 사용자 메시지 다음에 에이전트 응답이 오는 인접 순서를 가지며, 여러 제출의 쌍은 세션 메모리에서 제출 순서대로 유지한다.
• 무효 입력은 입력창을 빈 값으로 만들지만 메시지, 응답 선택 기록 및 대화 영역 항목을 생성하지 않는다.
• 유효하거나 무효인 제출 이후 입력창은 다시 입력 가능한 빈 상태가 된다.
• Escape와 Ctrl+Q는 별도의 데이터 값을 만들지 않고 동일한 애플리케이션 종료 동작을 요청하는 키 입력이다.
• 메시지와 선택된 응답은 현재 프로세스의 세션 메모리에만 보관하며 종료 후 재조회하거나 복구하는 인터페이스는 제공하지 않는다.
• 외부 API, LLM, 네트워크 서비스, 데이터베이스 및 영속 저장소 인터페이스는 제공하지 않는다.
• 프로젝트 패키지 위치, 패키징 메타데이터 및 실행 진입점은 선행 프로젝트 스캐폴드 요구사항을 참조하며 이 문서에서 상세 계약을 재정의하지 않는다.

10. 하위 호환성

• 선행 프로젝트 스캐폴드 요구사항에 정의된 설치 방법, Python 지원 조건, 패키지 이름, Textual 런타임 의존성 및 실행 진입점은 변경하지 않는다.
• 기존 Textual 화면 진입과 입력 위젯의 역할을 유지하며, 대화 기능을 분리해도 사용자는 동일한 입력 방식과 키 조작으로 대화를 시작할 수 있어야 한다.
• 입력 양끝 공백 제거, 유효 입력 판정, 메시지 누적, 고정 응답 선택과 표시, 빈 입력 무시, 입력창 초기화 및 종료 동작의 의미는 유지한다.
• 공백이 포함된 유효 입력은 정규화된 값만 대화에 기록하고, 공백만 포함한 입력은 대화 항목과 응답을 추가하지 않는다.
• 고정 응답 문구와 사용자 및 에이전트 표시 라벨은 기존 관찰 결과와 호환되도록 유지한다.
• 사용자 메시지와 에이전트 응답의 순서, 세션 내 누적 방식 및 역할 구분을 변경하지 않는다.
• Escape와 Ctrl+Q는 계속 사용할 수 있어야 하며 두 키는 동일한 종료 동작을 요청해야 한다.
• 제출 후 입력창을 비우는 동작은 유효 입력과 무효 입력 모두에서 유지한다.
• 세션 내 메모리 기반 메시지 관리는 유지하되 영속성, 외부 서비스 연동, 인증, 다중 세션 또는 메시지 복원을 새로 도입하지 않는다.
• 대화 기능을 사용하는 기존 호출자는 추가 마이그레이션 없이 동일한 입력과 키 조작으로 동일한 관찰 결과를 얻어야 한다.
• 이 문서는 대화 상호작용의 상세 규칙을 정본으로 관리하고, 선행 프로젝트 스캐폴드 요구사항의 프로젝트 구조·패키징·실행 진입점 계약을 복제하거나 변경하지 않는다.
• 테스트와 문서는 실제 애플리케이션이 제공하는 입력, 응답, 표시, 입력창 및 종료 동작과 일치해야 하며, 실행되지 않은 검증을 성공 결과로 기록하지 않는다.
• 새로운 외부 의존성, 배포 방식, 실행 환경 변경 또는 데이터 마이그레이션은 필요하지 않다.

11. 검증 계획

Python 3.11 이상 환경에서 프로젝트 설치와 실행 기반이 선행 조건을 충족하는지 확인한 뒤 대화 상호작용을 검증한다. 정상 입력에서는 양끝 공백이 제거된 사용자 메시지와 고정 응답이 제출 순서대로 대화 영역에 표시되는지 확인한다. 여러 입력을 연속 제출하여 각 사용자 메시지와 에이전트 응답이 인접한 쌍으로 기존 순서 뒤에 누적되는지 검증한다.

빈 문자열과 공백·탭·줄바꿈만 포함한 입력에서는 응답 선택, 메시지 누적 및 새 화면 항목 추가가 발생하지 않고 입력창만 초기화되는지 확인한다. 응답 선택은 정본으로 정의된 고정 응답 목록에서 표준 난수 방식으로 수행되는지 확인하고, 선택된 값이 에이전트 메시지로 표시되는지 검증한다. 사용자와 에이전트의 라벨 및 구조적 스타일이 메시지 역할과 일치하는지도 확인한다.

Escape와 Ctrl+Q 입력은 동일한 애플리케이션 종료 동작을 요청하며, 종료 입력이 메시지 제출이나 응답 선택으로 처리되지 않는지 검증한다. 검증 정의와 실행 결과는 별도 테스트 카탈로그와 증거 산출물에서 관리한다. 실행되지 않은 검증은 성공으로 기록하지 않으며, 현재 문서 작성 시점에는 실행 커밋과 실행 시각을 미기록 상태로 둔다.

테스트 추적성 계약

테스트 정의:

Test ID: TC-002-001
Verifies:
- REQ-002.01-AC01
- REQ-002.01-AC02
- REQ-002.02-AC01
- REQ-002.02-AC02
- REQ-002.02-AC03
- REQ-002.03-AC01
- REQ-002.03-AC02
- REQ-002.04-AC01
- REQ-002.04-AC02
- REQ-002.05-AC01
- REQ-002.05-AC02
Test reference: tests/test_app.py 및 python -m unittest discover -s tests -v
Automated: 저장소의 기존 unittest 기반 Textual 애플리케이션 테스트로 입력 정규화, 응답 선택, 메시지 순서, 빈 입력, 역할별 표시, 입력창 초기화 및 종료 동작을 자동 검증한다.

실행 증거:

Test ID: TC-002-001
Requirement revision: REQ-002@0.1
Commit: 검증 커밋 미기록
Environment: Python 3.11 이상 및 선언된 Textual 런타임 의존성이 설치된 환경
Result: 미실행
Executed at: 검증 실행 시각 미기록

12. 추적성

근거는 원본 Gitea 이슈 #8인 요구사항명세서 재작업 요청, 기존 프로젝트 스캐폴드 요구사항 문서, 저장소의 사용자 동작 설명, 애플리케이션 구현 및 대화 동작 테스트다. 이 문서는 프로젝트 스캐폴드와 실행 진입점을 선행 조건으로 사용하며, 그 패키징과 실행 계약을 변경하거나 다시 정의하지 않는다.

입력 양끝 공백 제거, 유효 입력 판정, 세션 내 메시지 누적, 고정 응답 선택과 표시, 빈 입력 무시, 입력창 초기화 및 종료 동작은 이 문서에서 추적한다. 프로젝트 구조, 패키징 메타데이터와 실행 진입점은 선행 요구사항 문서에서 추적하므로 이 문서에서는 상세 규칙과 인수 기준을 중복 정의하지 않는다.

두 요구사항 문서는 설치 및 실행 기반과 대화 동작의 선행 관계를 공유하되 동일한 기능 규칙이나 인수 기준을 중복 기록하지 않는다. 대화 동작의 검증 결과는 실제 실행된 검증 기록이 있을 때만 별도 증거에 연결한다. 기존 프로젝트 스캐폴드 요구사항의 제목, 적용 범위, 승인 상태와 승인 이력은 이 문서의 작성으로 변경하지 않는다.

13. 확정된 결정

원본 이슈 #8의 분리 범위에 따라 기존 구현과 테스트가 정의한 대화 동작을 독립된 요구사항 문서에서 관리한다. 입력은 제출 시 양끝 공백을 제거하고, 정규화 결과가 비어 있으면 대화 상태와 응답 선택을 변경하지 않는다.

유효한 입력마다 사용자 메시지를 먼저 누적하고, 정본으로 정의된 고정 응답 목록에서 하나를 표준 난수 방식으로 선택하여 에이전트 메시지로 바로 뒤에 누적한다. 여러 제출은 기존 메시지를 삭제하거나 재배열하지 않고 제출 순서대로 유지한다.

사용자와 에이전트 메시지는 명시적인 역할에서 파생되는 라벨과 구조적 스타일로 구분한다. 유효 입력과 무효 입력 모두 제출 후 입력창을 비우며, Escape와 Ctrl+Q는 동일한 애플리케이션 종료 동작을 요청한다. 외부 API, LLM, 데이터베이스, 영속 저장소, 새 의존성 및 사용자 동작 변경은 도입하지 않는다. 실행되지 않은 검증은 특정 커밋의 실행 증거나 성공 결과로 기록하지 않는다.

14. 미결 사항

없음

15. 승인 기록

상태는 draft이며 아직 최종 승인되지 않았다. 승인 주체와 승인 근거는 확정되지 않았다.

이 문서는 원본 이슈 #8의 디스커버리 결과에 따라 대화 상호작용을 독립적으로 추적하기 위해 작성되었다. 최종 승인 전에는 입력 정규화, 메시지 누적, 고정 응답 선택과 표시, 빈 입력 처리, 입력창 초기화, 종료 동작 및 선행 프로젝트 스캐폴드와의 의존 관계를 검토해야 한다. 실제로 실행되지 않은 검증은 승인 근거나 실행 증거로 기록하지 않는다.