docs: #129 완화 뒤 남은 https 강제 전제 사본 둘과 밀린 좌표 둘을 정정한다

[dlddu-k3s-homelab-k3s-mcp]

무엇을 고치나

#129(2026-09-12)가 validateFetchTarget 을 평문 http 까지 받도록 넓히면서 가만히 있는 채 거짓이 된 전제 사본 둘을 걷는다. 둘 다 #133 이 충실도 절(218·243행)을 고칠 때 그 hunk 밖이라 남은 자리다. 문서 2파일 3줄(+3/−2), 코드·매니페스트·집계는 건드리지 않는다.

자리	현재 문면	실측 반증
doc-tracker.md:56 ③	「도구는 대상 URL에 https를 강제하는데(session_mcp_tools.go:184 — url must be https) … http.DefaultClient다(:208)」	⑴ 강제하지 않는다 — validateFetchTarget 본문은 parsed.Scheme != "https" && parsed.Scheme != "http" ⑵ 리터럴 url must be https 는 코드 전수 0건 ⑶ 좌표 :184→실제 :219(함수)·:228(스킴 검사), :208→실제 :253
test/e2e.md:770 §「남은 미검증 분기」	「도구는 https 만 받는데(validateFetchTarget) … 사설 발급자를 넣을 자리가 없다」 — 현재형	〃 ⑴⑵. 이 논증은 https 원본을 고를 때만 성립한다

재현:

git grep -c 'url must be https' -- data-plane control-plane web   # -> 0
grep -n 'func validateFetchTarget' -A 12 data-plane/cmd/agent/session_mcp_tools.go
grep -n 'http.DefaultClient' data-plane/cmd/agent/session_mcp_tools.go   # -> :253

왜 지금, 왜 이 형태인가

• 방향은 「문서를 코드에 맞춘다」. feat(session-mcp): web_fetch_get 이 평문 http 대상을 받는다 #129(2026-09-12)는 PR 제목·전용 테스트로 완화의 의도성을 명시한다 — 완화를 되돌리는 판단이 아니다.
• 같은 전제를 test/e2e.md 충실도 절에서는 docs(e2e): web_fetch_get 이 https 만 받는다는 전제를 정정한다 (#129 완화) #133 이 이미 정정했다(218·243행). 이 문서의 사본은 그 hunk 밖이라 그대로 남아 있었고, 이 PR 은 docs(e2e): web_fetch_get 이 https 만 받는다는 전제를 정정한다 (#129 완화) #133 과 같은 형태를 쓴다 — 전제만 걷고 ⚠️ 정정 문단을 붙이되 판정은 하지 않는다.
• 좌표를 심볼 이름으로 옮긴 것은 이 파일 자신의 규범이다. 2026-09-08 행: 「줄 번호는 다음 편집이 조용히 밀어 버리는데 doc-tracker.md를 읽는 CI 게이트는 0개라 영영 잡히지 않는다 — 그래서 재측정이 필요 없는 심볼 이름으로 옮겼다.」 ③ 의 이 세 좌표는 그 정리에서 빠져 있었다.
• 변경 이력 표에 | 2026-09-13 | 문서 정정 — … | 행을 붙였다(2026-09-12 (3)·(4) 가 세운 같은 성격의 형식).

범위 밖 — 명시적으로 하지 않은 것

1. FETCH-ORIGIN 행의 판정(없음→EXT) 전환과 「해소 방향 재판정」. 2026-09-07 행이 자매 모델 tbm_session-platform-e2e-mock-policy 에 인계한 몫이다. 이 PR 은 그 재판정의 입력만 바꾼다.
2. test/e2e.md:771 — 770 의 「〃 의 뒷면」 행. 그 행의 논지(「닿을 수 있는 upstream 이 애초에 없으므로 음성 단언이 vacuous 하다」)는 스킴과 무관하게 여전히 참이라 건드리지 않았다.
3. 변경 이력 행 129·130·133 의 같은 문자열 — 날짜 붙은 과거 기록이라 글자 그대로 보존했다(comment-policy/ledger.md:35 와 같은 성격).
4. 같은 줄의 k8s/deployment.yaml:52·62·75·70-73 좌표 — 실측으로 여전히 참이라 건드리지 않았다.

검증

레포 게이트 4종을 이 브랜치에서 실행 — 전부 rc=0, 충실도 회계는 main(ba67081) 과 바이트 동일:

python3 scripts/check-fidelity-allowlist.py   # 등재 7 · 회계 20 · 차단 요인 1 · 착수 가능 0
python3 scripts/check-render-fidelity.py
python3 scripts/check_comment_policy.py
bash scripts/e2e/check-scenario-mapping.sh    # 시나리오 37 = 0 + 3 + 34 + 0

⚠️ 초록은 이 축을 보지 않는다 — doc-tracker.md 를 읽는 게이트는 0개다. 그래서 범위 검증은 기계적으로 따로 했다:

• git diff --stat = 2파일 +3/−2, 바뀐 줄은 doc-tracker.md 56행 · 새 이력 행 · test/e2e.md 770행 셋뿐
• doc-tracker.md 56행과 e2e.md 770행 각각의 살아 있는 절(⚠️ 정정 문단 앞)에 url must be https · session_mcp_tools.go:184 · `:208` · 「https를 강제」 전부 0건 (문자열은 정정 문단 안에 인용으로만 남는다 — docs(e2e): web_fetch_get 이 https 만 받는다는 전제를 정정한다 (#129 완화) #133 이 218행에서 한 것과 같다)
• 129·130·133행 sha256 불변
• ③ 의 결론(「해소는 대역 · 소관은 자매 모델」)과 770행의 FETCH-ORIGIN 포인터·:771 한 글자도 불변

왜 770행까지 여기서 닫는가 — 두 자매가 서로에게 미루던 자리

test/e2e.md:770 은 양쪽 모델이 서로에게 넘긴 채 아무도 들지 않은 자리였다:

• 자매 tbm_session-platform-e2e-mock-policy 의 판정은 「같은 슬라이스에 실을 것」이라 적었지만, 그 계획은 최종적으로 「자매 docs-impl 의 열린 task 가 그 축을 들고 있다」로 범위 밖에 두었다(PR docs(e2e): 차단 요인 FETCH-ORIGIN 의 해소 방향을 재판정해 착수 가능으로 세운다 #137 은 770 을 건드리지 않는다 — 실측 hunk 188·215·257).
• 그리고 770 은 그 모델의 to-be 발췌(test/e2e.md 7~278행) 밖이라 그쪽 재감지가 영영 닿지 않는다.
• 이 모델의 to-be 는 docs/ 전체라 두 자리가 모두 보인다. ⇒ 여기서 함께 닫는 것이 맞다.

자매의 baseline 을 흔들지 않는다(실측): 이 PR 적용 뒤에도 그 모델의 toBe.versionScript 가 잘라내는 충실도 절 지문은 f777763799185e6df1abddc4a1920bbb… 로 바이트 불변이다. PR #137 과 겹치는 줄도 없다.

선후 제약 — 머지 전에 읽을 것

PR #127 이 같은 56행을 통째로 다시 쓴다(항목 ② AC-F5 쪽). e2e.md:770 쪽은 #127 이 컨텍스트로 통과시키므로 충돌하지 않는다(실측 — 그 hunk @@ -769,8 +776,6 @@ 는 아래 두 행만 지운다). 실측:

• feat(approval-gated): AC-F5 후반 — 공유 볼륨을 파일시스템 아카이브에 실어 동결·복원을 건너 나른다 #127 은 이 거짓을 고쳐 주지 않는다 — 그 브랜치에 url must be https 1건, session_mcp_tools.go:184 3건 잔존. 기다림은 해소가 아니다.
• feat(approval-gated): AC-F5 후반 — 공유 볼륨을 파일시스템 아카이브에 실어 동결·복원을 건너 나른다 #127 은 현재 CONFLICTING/DIRTY(원인은 comment-policy/ledger.md 에서 docs(comment-policy): 15차 판정 패스 — 승인 경로 e2e 파일 105줄 판정 (제거 84 · 유지 21) #131 과 충돌) 이고, 그 PR 을 스테이징한 task 는 사람 승인 대기다.
• 이 PR 이 먼저 머지되면 feat(approval-gated): AC-F5 후반 — 공유 볼륨을 파일시스템 아카이브에 실어 동결·복원을 건너 나른다 #127 의 rebase 가 56행을 손으로 합치게 되고, 그때 feat(approval-gated): AC-F5 후반 — 공유 볼륨을 파일시스템 아카이브에 실어 동결·복원을 건너 나른다 #127 쪽 문면을 그대로 취하면 이 정정이 조용히 되돌아간다(그 파일을 읽는 CI 가 0개라 아무도 모른다). → feat(approval-gated): AC-F5 후반 — 공유 볼륨을 파일시스템 아카이브에 실어 동결·복원을 건너 나른다 #127 을 rebase 하는 사람은 항목 ③ 의 ⚠️ 전제 정정 문단을 반드시 보존해야 한다.
• 변경 이력 표 끝에 행을 더하는 것도 feat(approval-gated): AC-F5 후반 — 공유 볼륨을 파일시스템 아카이브에 실어 동결·복원을 건너 나른다 #127 과 겹친다(feat(approval-gated): AC-F5 후반 — 공유 볼륨을 파일시스템 아카이브에 실어 동결·복원을 건너 나른다 #127 은 2026-09-12 (5) 를 붙인다) — 날짜 순으로 둘 다 남기면 된다.

---

• reconciliation task: rct_20260913-0002 (tbm_session-platform-docs-impl)
• base: ba67081