[SonAIengine]

문제

xgeny.fs/read-text는 64 KiB를 넘는 파일을 거절한다(ADR-0022). ADR-0052 이후 요청 전체가 거절되지는 않지만, 큰 파일을 읽을 방법이 없어 모델이 같은 실패 읽기를 반복하다 턴 예산을 소진했다.

변경

• xgeny.fs/read-text-lines@1.0.0
  • 입력: {path, startLine, lineCount ≤ 2000}
  • 출력: {content, startLine, endLine, totalLines, truncated, digest}
• 줄 종결자를 보존하므로, 이어지는 범위를 붙이면 원본과 같다.
• 상한:
  • 파일 8 MiB
  • 파일 전체가 UTF-8이어야 한다.
  • content는 JSON escape 기준 64 KiB
• 기존 조회 adapter의 네 번째 QueryOperation으로 넣었다. symlink 비추적, 고정 실패 분류, verifier 재검사를 그대로 쓴다.
• allow_path는 read-text와 같은 범위 규칙으로 승인한다.
• workspace discovery의 capability가 6개에서 7개가 된다.
  • profile digest가 바뀌므로, 이전 binary로 멈춘 workspace Run은 재개가 거절된다.
  • 이 내용은 ADR에 기록했다.

검증

• cargo fmt --check, cargo clippy --workspace --all-targets -D warnings, cargo test --workspace 통과
• adapter 단위 테스트:
  • 범위를 이어 붙이면 원본과 같음, CRLF 보존
  • 파일 끝을 넘는 범위, 빈 파일
  • escape 기준 절단, 첫 줄 절단
  • 8 MiB 초과, 비 UTF-8, directory, symlink 거절
  • 입력 shape 거절, 출력 변조 거절
• e2e: 64 KiB를 넘는 파일의 끝 범위를 public xgen run으로 읽는다.
• 실사용(대화형 xgen):
  • 설계 사례(75 KB 파일): 턴 예산 소진이던 것이 18 Step·51초에 완료됐다. 모델의 README 수정과 요약 품질 문제는 별도로 다룬다.
  • 검증 사례(설계에 쓰지 않은 113 KB 파일): 6 Step·11초에 줄 번호까지 정확히 답했다.

🤖 Generated with Claude Code