notParsec / 문서전체 문서

설명·설계 문서

빌드 소스 추적과 설치본 출처 대조

design/BUILD_SOURCE_PROVENANCE.ko.md

출처: 현재 작업 폴더 · 원문 다운로드

이 문서의 목차

현재 Ubuntu 실측·앱 통합·남은 조건은 VDD_HOST_INTEGRATION.ko.md와 소스 확인 기록을 따른다. 요청한 소스 5개는 main에 있고 보관 EXE의 SHA-256도 설치본 보고와 일치한다. 아래 내용은 해당 확인 전 Windows 작업 당시의 조사·검증 기록으로 보존한다.

2026-10-02 · F01/E03 빌드 검증과 F39/F48/F49의 출처 조사. 제품 기능·원본 프로토콜을 추가하거나 VDD 설치 성공을 의미하지 않는다.

해결할 문제

설치된 EXE의 커밋 문자열은 9aa8b73이지만 EXE의 일부 소스 경로는 현재 Git에서 확인되지 않는다. 이 차이의 원인은 미확인이다. 커밋 문자열만으로 실제 빌드 입력을 확정할 수 없어 향후 소스 해시와 변경 상태를 함께 기록하도록 보강했다.

사용자가 로컬 내용을 모두 커밋했다고 알려 재검사했다. Windows 작업 폴더는 깨끗하고 로컬·원격 main은 일치한다. Ubuntu에 별도 최신 미커밋 소스가 있다고 단정한 이전 판단은 철회한다. 아래 Ubuntu 점검은 그 빌드 환경을 실제로 조사할 때 사용할 선택적 절차이며 개발을 중단시키는 선행 조건이 아니다. 재검사 기록.

구현

source_snapshot.py는 Git commit/tree, 파일별 SHA-256·크기·경로, 미커밋 상태를 기록한다. 파일 본문과 환경 변수·인증 정보는 보고서에 넣지 않는다. 범위는 apps/crates/scripts/deploy, Cargo 파일과 빌드 설정, 의존성 고지 입력이다. 분석용 대용량 바이너리와 도구·빌드 출력은 대상이 아니다.

python scripts/ci/source_snapshot.py inspect --output dist/ci/source-inspection.json
# 소스를 커밋한 후:
python scripts/ci/source_snapshot.py record --output dist/ci/source-snapshot.json
python scripts/ci/source_snapshot.py verify --output dist/ci/source-snapshot.json

이 기록은 소스 인계·변경 탐지를 위한 근거다. 서명된 빌드 증명, 모든 외부 SDK/캐시/환경 입력을 고정하는 hermetic build, 이미 배포된 EXE의 소스 복구를 대신하지 않는다. API 실행 중 다른 프로세스가 파일을 변경했다가 복원하는 상황까지 원자적으로 차단하는 잠금도 아니다. 기존 EXE에는 이 새 기록이 없다.

별도 빌드 환경을 조사할 경우의 점검 절차

바이너리에 /home/ahn/notparsec 경로가 있으나 해당 폴더의 현재 내용은 확인하지 못했다. 그 환경을 조사할 경우 다음 명령으로 저장소를 reset/clean/pull하거나 운영 서비스를 바꾸지 않고 상태를 읽을 수 있다. 검사 스크립트만 원격 main에서 읽어 /tmp에 둔다.

cd /home/ahn/notparsec
git fetch origin
git show origin/main:scripts/ci/source_snapshot.py > /tmp/notparsec-source-snapshot.py
python3 /tmp/notparsec-source-snapshot.py inspect --repo "$PWD" --output /tmp/notparsec-source-inspection.json
git status --short

보고서의 gitStatusEntries와 tracked: false는 그 환경의 현재 변경 여부를 보여 준다. 결과를 보기 전에 VDD·GPU·업데이터 소스가 미커밋 상태라고 추정하지 않는다. 현재 환경이 깨끗하더라도 과거 EXE가 무엇으로 빌드됐는지는 별도 기록이 필요하다. 비밀번호·개인키를 전송할 필요가 없다.

개발은 현재 main을 기준으로 계속한다. 같은 소스로 빌드하는 앱·드라이버의 계약을 검토하고 화면 조회·VDD 사전 검사를 연결한다. 기존 설치본과 직접 호환한다고 주장하려면 그 설치본의 실제 인터페이스 근거가 추가로 필요하다. 보관한 Parsec 150-104a와의 대조는 별도로 유지한다.

검증과 남은 범위