Context Pack이 외부로 전송되기 전에 게이트를 거쳐야 하는 이유

호스팅된 모델 호출은 로컬 게이트가 context pack을 깨끗하다고 표시할 때까지 거부해야 합니다. 무료 서버 역시 관리하지 않는 기계이기 때문에, 마스킹(redaction) 작업은 노트북에서 완료되어야 합니다. 패키지(pack)는 실제로 전송되는 것이며, 마지막에 상자에 입력하는 짧은 질문이 아닙니다. 만약 이 패키지에 비밀 정보, 고객 추적 정보 또는 내부 호스트 이름이 포함되어 있다면, 질문을 하는 시점은 이미 너무 늦습니다.

패키지를 비서가 라벨을 읽기 전에 채워 넣는 택배 봉투라고 생각해보세요. 여러분의 노트북이 첫 번째 구역이고, 호스팅된 서버가 두 번째 구역이며, 모델 경로는 세 번째 구역입니다. 원시 파일(raw files)에 대해서는 첫 번째 구역을 신뢰할 수 있습니다. 왜냐하면 그 파일들은 이미 여러분이 통제하는 디스크에 존재하기 때문입니다. 하지만 두 번째 구역과 세 번째 구역은 요청 즉시 삭제할 수 없는 사본을 유지한다고 가정해야 합니다.

현대의 코딩 어시스턴트는 채팅 상자에 작성한 문장만 보내지 않습니다. 종종 git diff, 열려 있는 버퍼(open buffers), 터미널 스크롤백의 일부, 그리고 파일 트리 요약 등을 첨부합니다. 각 첨부 파일은 단독으로는 무해해 보이지만, 함께 모이면 여러분이 공개하려 하지 않았던 사적인 변경 사항을 재구성할 수 있습니다. 바로 이 재구성이 깔끔한 채팅 라인이라도 공용 gist에 올리지 않을 변경 사항을 유출시킬 수 있는 이유입니다.

10월에는 많은 분들이 자신이 작성하지 않은 낯선 저장소(repositories), 샘플 앱, 그리고 절반만 완성된 브랜치로 끌려 들어갑니다. 유혹은 전체 트리를 호스팅 모델에 맡기고 이력을 이해하기도 전에 검토를 요청하는 것입니다. 하지만 그 트리가 잊힌 env 파일, vendor 토큰 또는 내부 호스트 이름을 명시한 주석을 포함하고 있다면 이러한 습관은 실패합니다. 어시스턴트가 해당 트리를 가지고 첫 번째 구역을 떠나기 전에 실행되는 로컬 게이트가 필요합니다.

워크플로우는 어시스턴트를 열기 전에 여유 터미널에서 실행할 만큼 작습니다. 신뢰하는 명령어로 구성된 컨텍스트 팩(context pack)을 내보낸 다음, 로컬 스크립트로 해당 디렉토리를 스캔합니다. 스크립트가 깨끗하게 종료될 때만 디렉토리를 전송할 수 있으며, 편집할 때마다 다시 스캔해야 합니다. 플래그가 지정된 구절(flagged span)을 채팅에 붙여넣어 의미를 묻는 방식으로 게이트와 협상하지 않습니다.

삭제해도 저장소의 작업 트리에 영향을 주지 않는 임시 디렉토리에서 시작하세요. 아래 명령어들은 diff, 이름만 포함된 상태 목록, 그리고 짧은 로그를 해당 디렉토리에 복사합니다. 이 과정에서는 셸 히스토리, SSH 에이전트, 전체 환경 덤프는 건너뛰는데, 이러한 출처들은 첫 번째 게이트를 통과하기에는 너무 광범위하기 때문입니다. 나중에 파일을 추가할 수는 있지만, 홈 디렉터리 전체에 대한 와일드카드를 사용하는 대신 이름으로 추가해야 합니다.

mkdir -p /tmp/context-pack
git diff -- . ':!*.env' ':!.env*' > /tmp/context-pack/diff.patch
git status --short > /tmp/context-pack/status.txt
...

이 내보내기 라인들을 시작 레시피로 간주하고, git 빌드가 제외 구문(exclusion syntax)을 거부하면 pathspec을 조정하세요. 중요한 제약 조건은 모든 버전에서 동일합니다. 즉, 파일은 이름으로 선택하며 환경을 팩에 절대 덤프하지 않는다는 것입니다. 명령어가 실패하면 중단하고 호스팅된 채팅에 오류를 붙여넣는 대신 로컬에서 오류를 읽어야 합니다. 실패한 내보내기도 여전히 존 원(zone one)이며, 도구가 출력한 내용을 이해할 때까지 그곳에 머물러야 합니다.

스캐너는 인증된 데이터 손실 방지 제품이 아니며 호스팅된 실험의 결과도 아닌, 로컬에서 실행할 수 있는 제안입니다. 이 스캐너는 팩을 순회하며 짧은 패턴 세트를 적용하고, 셸이 읽을 수 있는 종료 코드 옆에 JSON 결정을 작성합니다. 일치하는 항목은 주석이나 피처(fixture), 또는 커밋 제목 안에 있더라도 전송을 차단합니다. 침묵은 안전의 증거가 아닙니다. 왜냐하면 정규 표현식(regex)은 여러분이 설명하는 것을 잊어버린 형식을 사용하는 비밀을 볼 수 없기 때문입니다.

#!/usr/bin/env python3
"""Context pack을 위한 로컬 게이트. 예시일 뿐이며, 조직에 맞게 패턴을 확장하세요."""

...

이 스크립트를 gate_context_pack.py로 저장하고, 서버로 어떤 것도 복사하기 전에 임시 팩(temporary pack)을 가리키도록 지정하세요. 깨끗한 팩은 종료 코드 0을 반환하며 허용(allow) 결정을 출력하는데, 이것이 노트북에서 나갈 수 있는 유일한 결과입니다. 게시된 문서화 키 접두사를 포함하는 폐기용 파일로 차단 경로를 증명할 수 있습니다. 그런 다음 그 파일을 삭제하고 다시 스캔하세요. 가짜 값을 명확하게 유지하고, 실제였던 토큰으로 테스트에 절대 시드(seed)하지 마세요.

python3 gate_context_pack.py /tmp/context-pack
echo $?

...

JSON을 통과할 수 있는 점수처럼 읽지 말고, 탑승권(boarding pass)처럼 읽으세요. 허용 결정은 나열된 패턴이 발동되지 않았다는 의미이지, 팩을 공유하기에 현명하다는 뜻은 아닙니다. 차단 결정은 파일과 줄을 명시하며, 의도적으로 일치하는 텍스트를 생략합니다. 소스를 수정하고, 팩을 재구축한 다음, 네트워크 호출 전에 새로운 허용(allow)을 받아야 합니다.

전체 과정을 폐기용 git 저장소에서 연습할 수 있습니다. 이 저장소는 README와 한 줄의 변경 사항만 포함해야 합니다. /tmp 아래에 이를 생성하고, 내보내기 명령을 실행한 다음, 문서화 샘플 키를 추가하기 전에 허용(allow)이 발생하는지 확인하세요. 나쁜 파일을 제거하고, 허용(allow)이 반환되는지 확인한 후에야 그 장난감 트리(toy tree)에서 호스팅 호출을 고려해 보세요. 이 루프가 아티팩트이며, 먼저 브랜치를 어디에도 보내지 않고도 모든 브랜치에 대해 반복할 수 있습니다.

게이트가 팩을 허용하더라도, 바이트가 어디로 갈지는 여전히 사용자가 선택하며, 그 선택이 나머지 신뢰 모델입니다. 공개 정보: 이 문서는 MonkeyCode의 제품 아웃리치(product outreach)의 일환으로 작성되었습니다. MonkeyCode는 오픈 소스 코딩 어시스턴트이며, 명시된 혜택에는 무료 모델 액세스에 대한 천만 토큰 할당량이 포함됩니다. 동일한 혜택에는 서버 옵션이 포함되는데, 이는 사용자가 관리하는 하드웨어에서 프로젝트를 실행하지 않는 한 여전히 존 투(zone two)입니다.

패키지가 공개 저장소에서 오거나, 직접 작성한 튜토리얼이거나, 게이트가 허용한 두 번의 수정된 diff에서 온 경우 무료 서버를 사용하세요. 작업 내용에 고객 이름, 미공개 수정 사항 또는 공개 이슈에 올리지 않을 호스트명이 포함되어 있다면 자체 호스팅 체크아웃을 사용해야 합니다. 무료 토큰 할당량은 깨끗한 패키지에 대한 긴 검토는 커버할 수 있지만, 이 할당량이 프라이버시 통제 수단은 아닙니다. 주간 계획을 세우기 전에 현재 약관을 확인하세요. 왜냐하면 제공되는 혜택이 변하며 이 문서는 실시간으로 할당량을 측정하지 않기 때문입니다.

환경 덤프, 셸 히스토리, 충돌 덤프, 고객 티켓 또는 원시 터미널 스크롤백은 잘라내더라도 보내지 마세요. 이름이 지루해 보여서 파일을 보내지 마세요. 상태 파일이나 커밋 제목에는 종종 내부 URL이 포함되어 있기 때문입니다. 경로와 줄 번호가 비밀로 다시 이어질 수 있으므로 차단된 실행의 게이트 보고서를 보내지 마세요. 기여 스프린트 동안 호스팅 모델이 편리하게 느껴진다고 해서 다른 사람의 비공개 저장소를 보내지 마세요.

이러한 접근 방식은 작성한 패턴에 대해서만 폐쇄적으로 실패(fails closed)하며, 그 외 모든 것에는 개방적으로 실패(fails open)합니다. 이름이 바뀐 토큰, 분할된 비밀, 일반 문구로 된 비즈니스 규칙 또는 패치되지 않은 결함 모두 행복한 정규 표현식(happy regex)을 통과시킬 것입니다. 이 스크립트는 패키지를 암호화하지 않으며, 에디터 교체 파일(editor swap files)을 지우지 않고, 다른 플러그인 채널의 작동을 막지도 않습니다. 자동 첨부되는 열린 파일을 가진 플러그인은 비활성화하기 전까지는 이 게이트 외부로 간주해야 합니다.

이 워크플로우를 사고 대응(incident response), 규제 기록, 결제 데이터 또는 법적 보류 상태에 있는 저장소에는 사용해서는 안 됩니다. 심지어 스캐너가 조용히 작동하더라도 고용주가 내부로 표시한 코드는 무료 서버를 사용해서는 안 됩니다. 공개 샘플을 사용하는 학생은 이 게이트를 습관으로 받아들일 수 있지만, 규제 팀은 법률 자문팀이 이미 승인한 통제가 필요합니다. 만약 'zone two'가 프롬프트를 저장하는 곳이 어디인지 설명할 수 없다면, 패키지를 보낼 준비가 전혀 되지 않은 것입니다.

만약 패키지가 이미 깨끗하다면, 언급된 무료 서버만으로 하드웨어를 먼저 구축하지 않고도 공개 검토(public review)를 연습하기에 충분합니다. 만약 보이는 약관이 이 기사와 일치하지 않는다면 중단하고, 토큰 할당량을 유지 보장 약속으로 취급하지 마십시오. 유용한 결과는 택배 기사가 떠나기 전에 봉투를 확인하는 반사 작용이지, 모델과의 더 긴 채팅이 아닙니다. 사설 트리는 직접 관리할 수 있는 영역 안에서 오픈 소스 스택을 실행할 때까지 노트북에 보관하십시오.