sap-session-start

/sap-session-start — 새 Evidence Loop 세션 시작

입력: $ARGUMENTS

이 커맨드는 Evidence Loop의 Turn 1 INTAKE를 수행합니다. 라이브 SAP 접근 없이 운영자가 가져온 증거를 기반으로 진단을 시작하는 엔트리 포인트입니다.

🧭 동작 단계

1. 인자 파싱

• 포지셔널 인자: 증상 설명 (최대 2000자). 자유 텍스트.
• 옵션 플래그:
  • --country {iso} — ISO 3166-1 alpha-2 (kr, de, us, jp, ...). config.yaml에 기본값 있으면 생략 가능.
  • --release {code} — ECC6_EhP7, S4_2022 등. 스키마의 enum 참조.
  • --deployment {on_premise|private_cloud|public_cloud}
  • --language {ko|en|...} — 세션 전체 언어
  • --intake-files <path>... — 초기 Evidence Bundle 파일들 (선택적)
  • --reporter-role {end_user|operator|consultant}

2. 세션 ID 생성

sess-{YYYYMMDD}-{6자리 영숫자}

예: sess-20260412-m2p9xt

3. 파일 시스템 준비

.sapstack/sessions/{session_id}/
├── state.yaml           ← 새로 생성
├── bundles/             ← 빈 디렉토리
├── hypotheses/          ← 빈 디렉토리
├── requests/            ← 빈 디렉토리
├── verdicts/            ← 빈 디렉토리
└── files/               ← 빈 디렉토리

4. state.yaml 초기화

schemas/session-state.schema.yaml에 따라 다음 필드를 채워 새 파일 작성:

• session_id, schema_version: "1.0.0", created_at, last_updated_at
• created_by.role (기본값: operator)
• originating_surface: cli
• status: intake
• initial_symptom:
  • description: 파싱된 포지셔널 인자
  • reporter_role: 플래그 or 기본값
  • language: 플래그 or 기본값 (config.yaml → ko)
  • country_iso: 플래그 or config.yaml 기본값
  • matched_symptom_index_entry: data/symptom-index.yaml과 fuzzy 매칭된 ID (매칭 없으면 null)
• sap_context: 플래그와 config.yaml 병합
• turns:
  • 첫 엔트리: turn_number: 1, turn_type: intake, status: active, surface: cli
• current_turn_number: 1
• audit_trail:
  • 첫 엔트리: session_created

5. 초기 Bundle 처리 (선택적)

--intake-files가 제공되면 즉시 Bundle 1개를 생성해 bundles/evb-*.yaml로 저장하고, 각 파일을 files/ 아래로 복사하며 SHA-256 해시를 계산해 evidence-bundle.schema.yaml에 맞는 메타데이터를 작성합니다.

자동 감지:

• .txt, .log → kind: transaction_log 또는 message_text
• .csv, .xlsx → kind: table_export
• .png, .jpg → kind: screenshot
• .html → kind: fiori_page_html