Skip to content

chore: 계약 경계 정리 + AGENTS 산출물 최신화#8

Merged
ArcSolver merged 1 commit into
mainfrom
chore/tidy-contract-and-agents
Jun 1, 2026
Merged

chore: 계약 경계 정리 + AGENTS 산출물 최신화#8
ArcSolver merged 1 commit into
mainfrom
chore/tidy-contract-and-agents

Conversation

@ArcSolver

Copy link
Copy Markdown
Owner

"처음 계약대로 클린한가" 감사에서 발견한 드리프트 2건 교정.

1. contract/tools 경계 (순수성 복원)

  • telegram/contract.pyis_local_file(파일시스템 os.path.isfile 사용)를 tools.py로 이동. contract.py는 "엔드포인트 상수 + pydantic 모델(네트워크/MCP 무의존)"만 유지.
  • 업로드 헬퍼 테스트를 test_telegram_contract.pytest_telegram_tools.py로 이동(레이어 일치).

2. AGENTS.md 단일 출처 최신화

PR #7에서 추가된 tests/test_<name>_tools.py(도구 런타임 검증) + tests/conftest.py가 AGENTS.md 산출물·DoD에 누락돼 있던 것을 반영. docs/adding-a-service.md도 동일 갱신.

검증

  • 동작 변경 없음(순수 이동 + 문서). 카탈로그/체인지로그 불변.
  • ruff check . clean. 로컬 pytest는 환경 메모리 포화로 미실행 — CI 전체 검증.

🤖 Generated with Claude Code

원래 설계 계약("contract=순수 진실 / tools=얇은 글루", "AGENTS=단일 출처")과의
드리프트 2건을 교정.

1. telegram: 파일시스템을 만지는 is_local_file를 contract.py → tools.py로 이동.
   contract.py는 엔드포인트 상수 + pydantic 모델(네트워크/MCP 무의존)만 유지.
   업로드 헬퍼 테스트도 test_telegram_contract → test_telegram_tools로 이동.
2. AGENTS.md / docs/adding-a-service.md: 서비스 산출물·DoD에
   tests/test_<name>_tools.py(도구 런타임 검증, conftest의 FakeMCP/RecordingHTTP) 반영.
   (PR #7에서 추가됐으나 계약 문서에 누락돼 있던 것.)

ruff clean. (로컬 pytest는 환경 메모리 포화로 미실행 — CI에서 검증.)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@ArcSolver ArcSolver merged commit 152e08a into main Jun 1, 2026
2 checks passed
@ArcSolver ArcSolver deleted the chore/tidy-contract-and-agents branch June 1, 2026 11:16
ArcSolver added a commit that referenced this pull request Jun 4, 2026
원래 설계 계약("contract=순수 진실 / tools=얇은 글루", "AGENTS=단일 출처")과의
드리프트 2건을 교정.

1. telegram: 파일시스템을 만지는 is_local_file를 contract.py → tools.py로 이동.
   contract.py는 엔드포인트 상수 + pydantic 모델(네트워크/MCP 무의존)만 유지.
   업로드 헬퍼 테스트도 test_telegram_contract → test_telegram_tools로 이동.
2. AGENTS.md / docs/adding-a-service.md: 서비스 산출물·DoD에
   tests/test_<name>_tools.py(도구 런타임 검증, conftest의 FakeMCP/RecordingHTTP) 반영.
   (PR #7에서 추가됐으나 계약 문서에 누락돼 있던 것.)

ruff clean. (로컬 pytest는 환경 메모리 포화로 미실행 — CI에서 검증.)

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant