RepoProof
저장소를 신규 사용자의 관점에서 증명합니다. README를 제안이 아닌 계약으로 취급합니다.
기본 워크플로
node scripts/repoproof.mjs audit . --output repoproof-output실행.- 결론을 내리기 전에
repoproof-output/repoproof-report.json을 읽습니다. - 사용자가 명시적으로 실행을 허가한 경우
node scripts/repoproof.mjs prove . --allow-exec --output repoproof-output실행. - 수정이 요청된 경우
node scripts/repoproof.mjs fix . --dry-run --output repoproof-output을 실행하고repoproof-fixes.patch를 검사합니다. - 증거가 뒷받침하는 내용만 보고합니다. 입증되지 않은 주장은 입증되지 않음으로 표시합니다.
안전 규칙
- 감사 모드가 기본이며 저장소 코드를 실행해서는 안 됩니다.
- 증명 모드에는
--allow-exec또는 CI 실행기를 통한 명시적인 사용자 승인이 필요합니다. - 절대 게시, 배포, 푸시, 병합하거나 사용자 비밀을 읽지 마십시오.
- 실제 컨테이너, VM 또는 OS 샌드박스 없이 강력한 샌드박싱을 주장하지 마십시오.
- 증거 수집 및 편집에는 결정론적 스크립트를 사용하십시오.
참고 자료
- 전체 감사/증명/수정 워크플로는
references/workflow.md를 읽으십시오. - 저장소 코드를 실행하기 전에
references/safety-model.md를 읽으십시오. - README 단계 추출이 모호한 경우
references/extraction-rules.md를 읽으십시오. - 편집을 제안하기 전에
references/fix-policy.md를 읽으십시오. - 보고서를 해석할 때
references/evidence-schema.md를 읽으십시오. - CI를 추가하기 전에
references/github-action.md를 읽으십시오. - Windows, macOS 및 Linux 차이점은
references/platform-notes.md를 읽으십시오.