[ooMia]

로컬 개발이 오래된 gitlink 콘텐츠로 시작하고 환경변수 사용 맥락이 여러 파일에 흩어지는 문제를 정리합니다. dev는 공개 publication marker의 Docs SHA를 한 번 선택해 준비하며, 다른 콘텐츠는 명시적으로 선택합니다.

• 순수 환경변수 parser와 Astro 서버 schema를 구성했습니다. Node 설정은 config 경계에서 읽고, 서버 필터는 astro:env/server로 소비합니다. .env보다 외부 입력이 우선하며 env.d.ts·.env.example에 목적과 예시를 적었습니다.
• DOCS_REVISION은 실제 Git HEAD에서만 결정합니다. 같은 이름의 환경변수로 provenance를 위조하려는 입력은 거부합니다.
• published/current/pinned/cached 선택은 로컬 변경을 덮어쓰지 않고 저장된 gitlink를 바꾸지 않습니다. 준비 후 기존 readiness와 native content sync를 실행하며 실패 시 revision을 바꾸어 재시도하지 않습니다. Astro dev CLI 옵션을 전달합니다.
• 수동 native .md/.mdx 번역을 hash artifact와 manifest로 패키징하고 검증·Docs 준비·발행으로 연결하는 예제를 추가했습니다. 현재 상대 media/heading fragment 제한과 영문 fallback을 설명합니다. 자동 번역·유료 provider는 추가하지 않습니다.

검증: unit 150개, 위조 revision 거부를 포함한 network-blocked snapshot fixture, native translation 2 routes, Astro typecheck 및 24페이지 전체 빌드 통과. 실제 published marker(Site cf48a2c, Docs 5a2eaff)와 cached 준비, dev help 전달을 확인했습니다. 가이드의 패키징 명령을 임시 Docs 저장소에서 실행해 hash/file/원문 보존을 확인했습니다.

변경 파일 검사 통과. 전체 vp check의 기존 파일 11개 포맷 차이는 수정하지 않았으며 CI의 --no-fmt 검사는 별도로 실행됩니다. 로컬 콘텐츠 SHA 선택은 Pages 배포나 번역 producer 가동을 뜻하지 않습니다. 기존 homepage Gravatar 네트워크 의존성 제거는 PR #81에서 진행합니다.

추가 통합 검사에서 BASE_PATH=/를 늦은 config hook에 빈 문자열로 전달해 nested 페이지 CSS/JS URL이 상대 경로가 되는 회귀를 발견했습니다. 8db23da에서 항상 / 또는 /nested/site/로 정규화했으며, 기존 offline snapshot fixture가 root/non-root의 Home·EN Home·Article 자산 URL과 실제 파일을 확인합니다. 현재 head CI도 통과했습니다.

Refs #86
Refs #87
Refs #88