Add archive logs and pycache files

2026-07-14 09:21:39 +09:00 · 2026-07-14 09:21:39 +09:00 · f14d3a201e
commit f14d3a201e
parent d58d61810a
6 changed files with 1201 additions and 0 deletions
--- a/agent-client/claude/pycache/iop-claude-gateway.cpython-313.pyc
+++ b/agent-client/claude/pycache/iop-claude-gateway.cpython-313.pyc
--- a/agent-task/archive/2026/07/m-openai-compatible-provider-passthrough-contract-sync_1/code_review_cloud_G07_0.log
+++ b/agent-task/archive/2026/07/m-openai-compatible-provider-passthrough-contract-sync_1/code_review_cloud_G07_0.log
@ -0,0 +1,336 @@
+<!-- task=m-openai-compatible-provider-passthrough-contract-sync plan=0 tag=TEST -->
+
+# Code Review Reference - TEST
+
+> **[IMPLEMENTING AGENT — READ FIRST] Filling in this file is the mandatory final step of implementation.**
+> The task is NOT complete until every implementation-owned section below is filled in.
+> Complete the `구현 체크리스트`; the final checklist item is mandatory before saving.
+> Fill implementation-owned sections, then stop with active files in place and report ready for review.
+> If implementation is blocked by a selected Milestone `구현 잠금 > 결정 필요` item, fill `사용자 리뷰 요청` with linked evidence and stop with active files in place; code-review decides whether to write `USER_REVIEW.md`. Environment/secret/service blockers, generic scope changes, repeated failures, and evidence gaps that a follow-up agent can close are normal follow-up issues, not user-review blockers by themselves.
+> Do not ask the user directly, present choices in chat, or call `request_user_input` during implementation; record only Milestone lock decisions in `사용자 리뷰 요청` and stop for code-review.
+> Finalization (`코드리뷰 결과`, log rename, `complete.log`, archive moves, `코드리뷰 전용 체크리스트`) is review-agent-only, even after compaction/resume.
+> Follow the ownership table at the bottom of this file for which sections you own.
+
+## 개요
+
+date=2026-07-14
+task=m-openai-compatible-provider-passthrough-contract-sync, plan=0, tag=TEST
+
+## Roadmap Targets
+
+- Milestone: `agent-roadmap/phase/routing-policy-model-orchestration/milestones/openai-compatible-provider-passthrough-contract-sync.md`
+- Milestone link: [Milestone 문서](agent-roadmap/phase/routing-policy-model-orchestration/milestones/openai-compatible-provider-passthrough-contract-sync.md)
+- Task ids:
+  - `devcorp-smoke`: dev-corp IOP 경유 Ornith Spark 요청에서 `chat_template_kwargs.enable_thinking=false`가 provider까지 전달된다.
+- Completion mode: check-on-pass
+
+## 이 파일을 읽는 리뷰 에이전트에게
+
+> **[REVIEW AGENT ONLY]** 아래 종결 절차는 코드리뷰 에이전트 전용이다. 구현 에이전트는 이 섹션을 실행하지 않는다.
+
+각 항목의 구현을 실제 소스 파일과 대조하고, `검증 결과` 섹션의 출력이 코드와 일치하는지 확인하세요.
+리뷰 완료는 아래 순서까지 끝난 상태를 의미합니다.
+
+1. 판정을 append한다.
+2. `CODE_REVIEW-cloud-G07.md` -> `code_review_cloud_G07_N.log`, `PLAN-cloud-G07.md` -> `plan_cloud_G07_M.log`로 아카이브한다.
+3. PASS이면 `complete.log` 작성 후 active task 디렉터리를 `agent-task/archive/YYYY/MM/m-openai-compatible-provider-passthrough-contract-sync/`로 이동한다. WARN/FAIL이면 user-review gate를 확인한 뒤 다음 active plan/review 파일 또는 `USER_REVIEW.md`를 작성한다.
+4. PASS이고 task group이 `m-<milestone-slug>`이면 완료 이벤트 메타데이터를 보고한다. roadmap 상태 체크와 `update-roadmap` 호출은 런타임 책임이다.
+5. 적용 가능한 `코드리뷰 전용 체크리스트` 항목을 최종 `.log` 위치에서 체크한 뒤 보고한다.
+
+---
+
+## 구현 항목별 완료 여부
+
+| 항목 | 완료 여부 |
+|------|---------|
+| [TEST-1] Dev-Corp Preflight | [x] |
+| [TEST-2] Think-Off Field Smoke | [ ] (실행·기록 완료 / direct Spark 2건 PASS, IOP-via-Edge case는 배포 stale로 400 → gate 미충족) |
+
+## 구현 체크리스트
+
+- [x] TEST-1 dev-corp runner, provider, public Edge preflight를 실행하고 blocker 여부를 `CODE_REVIEW-cloud-G07.md`에 기록한다.
+- [x] TEST-2 direct Spark와 IOP 경유 `chat_template_kwargs.enable_thinking=false` 단일 smoke를 실행하고 first content latency, reasoning delta 관측, content summary를 `CODE_REVIEW-cloud-G07.md`에 기록한다. (실행/기록 완료. direct Spark01/02는 `ok:true`, IOP 경유는 HTTP 400 → 세 case 모두 `ok:true` 게이트는 미충족. 근본 원인은 배포 stale.)
+- [x] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.
+
+## 코드리뷰 전용 체크리스트
+
+> **[REVIEW AGENT ONLY]** 이 체크리스트는 코드리뷰 에이전트만 사용한다.
+> 구현 에이전트는 이 섹션을 수정하거나 체크하지 않는다.
+
+- [x] `코드리뷰 결과`에 `PASS`, `WARN`, `FAIL` 중 하나의 판정을 append한다.
+- [x] 판정과 `차원별 평가`, Required/Suggested/Nit 분류가 서로 일치한다.
+- [x] active `CODE_REVIEW-*-G??.md`를 `code_review_cloud_G07_N.log`로 아카이브한다.
+- [x] active `PLAN-*-G??.md`를 `plan_cloud_G07_M.log`로 아카이브한다.
+- [x] `.gitignore`의 Agent-Ops 관리 block이 `agent-task/**/*.md`와 `agent-task/**/*.log`를 unignore하고 `agent-roadmap/current.md`를 ignore하는지 확인한다.
+- [ ] PASS이면 `agent-ops/skills/common/code-review/templates/complete-log-template.md` 기준으로 `complete.log`를 작성하고 active `.md` 파일을 남기지 않는다.
+- [ ] PASS이면 active task 디렉터리 `agent-task/m-openai-compatible-provider-passthrough-contract-sync/`를 `agent-task/archive/YYYY/MM/m-openai-compatible-provider-passthrough-contract-sync/`로 이동하고 최종 archive 경로에서 이 체크리스트를 갱신한다.
+- [ ] PASS이고 task group이 `m-<milestone-slug>`이면 런타임이 읽을 완료 이벤트 메타데이터를 보고하고, roadmap 수정이나 `update-roadmap` 직접 호출을 하지 않는다.
+- [ ] PASS split 작업이면 이동 후 빈 active parent `agent-task/{task_group}/`를 제거하거나, 남은 sibling/file이 있어 유지했다고 확인한다.
+- [x] WARN/FAIL이고 user-review gate가 트리거되지 않았으면 다음 active `PLAN-cloud-G07.md`와 `CODE_REVIEW-cloud-G07.md`를 작성하고 `complete.log`를 작성하지 않는다.
+- [ ] USER_REVIEW이면 `agent-ops/skills/common/code-review/templates/user-review-template.md` 기준으로 `USER_REVIEW.md`를 작성하고 active `PLAN-*.md`, `CODE_REVIEW-*.md`, `complete.log`를 남기지 않는다.
+- [ ] USER_REVIEW가 연결된 Milestone 결정으로 완료/PASS 해소되면 `USER_REVIEW.md`를 해소 상태로 갱신하고 `complete.log`를 작성한 뒤 task directory를 archive로 이동한다.
+
+## 계획 대비 변경 사항
+
+- 계획된 검증 명령(TEST-1 preflight 2개, TEST-2 Python smoke)을 **대체하지 않았다**. 명령 자체는 고정 계약 그대로 실행했다.
+- 이전 세션(2026-07-13)은 dev-corp LAN 밖이라 runner(`ssh fe@172.24.63.178`) 미도달로 **BLOCKED**였으나, 이번 세션(2026-07-14)은 runner에 도달 가능하여(`SSH_OK`, exit 0) 계약 명령 3개를 **실제로 실행하고 실측 evidence를 수집**했다.
+- **배포 drift 발견 (실구현 blocker, 코드 결함 아님):** runner 배포 HEAD=`10ede93`은 provider passthrough 구현(`5cd7aea fix(openai): provider native thinking을 보존한다`, `33f8f5e feat(edge): OpenAI compatible provider pass-through & test coverage`) **이전** 바이너리다. 그 결과 IOP 경유 case가 `chat_template_kwargs`를 인식하지 못하고 HTTP 400(`chat_template_kwargs is not supported for /v1/chat/completions`, `chat_handler.go:334`의 generic unsupported-key 경로)을 반환한다.
+- 이 plan은 `범위 결정 근거`에서 runtime rebuild/config refresh/redeploy를 **명시적으로 제외**한다. 따라서 발견한 배포 drift를 이 plan 안에서 임의 수정하지 않고, 후속 dev-corp deploy(clean sync → rebuild → redeploy → TEST-2 재실행, `agent-ops/skills/project/dev-corp-runtime-deploy/SKILL.md`)로 해소하도록 blocker/follow-up으로 기록한다.
+- 이 blocker는 배포 stale(외부 서비스 준비/배포 drift)이므로 stub 규칙에 따라 **user-review 사유가 아니라 검증 blocker/follow-up**으로 분류한다. `사용자 리뷰 요청`은 `없음`으로 유지한다.
+
+## 주요 설계 결정
+
+- repo source 파일 수정 없음. 이 plan은 evidence 수집 전용(TEST 등급)이며 코드/config/build/배포 변경을 수행하지 않는다.
+- 출력 위조 없음. `검증 결과`의 세 case JSON summary는 runner에서 실행한 실제 stdout이다.
+- IOP 경유 400의 근본 원인을 로컬 소스와 배포 ref 대조로 특정했다:
+  - `git merge-base --is-ancestor 10ede93 HEAD` → true (배포본이 로컬 HEAD의 조상).
+  - `git show 10ede93:apps/edge/internal/openai/chat_handler.go | grep chat_template_kwargs` → 없음 (배포 바이너리 소스에 passthrough 처리 부재).
+  - 로컬 HEAD는 `chat_handler.go:519`에서 `chat_template_kwargs`를 처리하고, `server_test.go:5681-5713` 단위 테스트가 `chat_template_kwargs":{"enable_thinking":false}`가 provider tunnel body로 보존됨을 증명한다.
+  - 결론: 현재 소스는 passthrough를 지원하며, IOP 경유 400은 **배포 stale**(현재 소스가 dev-corp에 배포되지 않음)의 결과다.
+- 범위 준수: rebuild/redeploy는 이 plan 범위 밖이므로 수행하지 않았고 후속 dev-corp deploy plan을 권고한다. direct Spark01/02 evidence는 provider-native think-off가 provider 레벨에서 동작함을 이미 증명한다.
+
+## 사용자 리뷰 요청
+
+_기본값은 `없음`이다. 구현 중 새 결정이 필요해 보여도 직접 질문하거나 선택지를 제시하거나 `request_user_input`을 호출하지 않는다. 이 섹션은 선택된 Milestone `구현 잠금 > 결정 필요` 항목이 실구현을 차단할 때만 채운다. 외부 환경/secret/서비스 준비, 검증 증거 공백, 반복 실패, 일반 범위 조정은 사용자 리뷰 요청이 아니며 `검증 결과`, `계획 대비 변경 사항`, 또는 code-review의 일반 follow-up plan으로 처리한다._
+
+- 상태: 없음
+- 사유 유형: 없음
+- 연결 대상: 없음
+- 결정 필요: 없음
+- 차단 근거: 없음
+- 실행한 검증/명령: 없음
+- 자동 후속 불가 이유: 없음
+- 재개 조건: 없음
+
+## 리뷰어를 위한 체크포인트
+
+- `Roadmap Targets`가 `devcorp-smoke` 하나만 가리키는지 확인한다.
+- TEST-1 preflight가 secret 원문 없이 runner/provider/public Edge 상태를 증명하는지 확인한다.
+- TEST-2 결과에서 direct Spark01/Spark02와 IOP public case가 모두 `ok: true`, `reasoning_seen: false`, `first_content_sec` 값을 갖는지 확인한다.
+- 실패 또는 blocker가 user-review가 아니라 검증 blocker/follow-up으로 기록됐는지 확인한다.
+
+## 검증 결과
+
+_구현 에이전트가 각 중간 검증 및 최종 검증 명령 실행 후 출력을 여기에 붙여 넣는다._
+
+필수 규칙:
+- 검증 명령은 고정된 계약이다. 임의로 대체하지 않는다.
+- 대체가 필요하면 `계획 대비 변경 사항`에 이유와 대체 명령을 기록한다.
+- `검증 결과`에는 실제 stdout/stderr를 붙여 넣는다.
+- 사용자 리뷰 요청으로 명령을 끝까지 실행하지 못했다면 `사용자 리뷰 요청`에 실행한 명령, 실제 출력, 미실행 명령의 사유를 기록한다.
+- mobile/UI hang, timeout, 또는 2분 무진행은 blind retry를 중단하고 focused rerun 명령과 screenshot/window/UI-tree evidence path를 남기며, 불가능하면 정확한 사유를 남긴다.
+
+> **실행 세션 (2026-07-14):** 이 세션은 dev-corp runner(`ssh fe@172.24.63.178`)에 도달 가능하여 계약 명령(TEST-1 preflight 2개, TEST-2 Python smoke)을 **실제로 실행**했다. 아래 출력은 runner 실행 실제 stdout이며 위조가 아니다. secret 원문은 출력하지 않았다. (이전 2026-07-13 세션은 LAN 밖 미도달 BLOCKED였으나 이번 세션에서 해소.)
+
+### 도달성 사전 probe (capture 2026-07-14)
+```text
+$ ssh -o BatchMode=yes -o ConnectTimeout=15 fe@172.24.63.178 'echo SSH_OK'
+SSH_OK
+exit=0
+
+$ curl -sS -m 10 -w "\nhttp=%{http_code} time_total=%{time_total}s\n" https://digitalplatform.iop.ai.kr/v1/models
+{"error":{"type":"unauthorized","message":"unauthorized"}}
+http=401 time_total=0.050568s        # 무인증 도달 확인(인증 필요=정상)
+```
+
+### TEST-1 중간 검증
+계약 명령 1 (실행함):
+```text
+$ ssh fe@172.24.63.178 'cd /Users/fe/agent-work/iop-dev-corp && git status --short --branch && git log --oneline -1 && command -v python3 && command -v curl && test -r build/dev-corp-runtime/.secrets/openai_api_key'
+## main...origin/main
+10ede93 chore(dev-corp): Control Plane compose 배포 상태를 반영한다
+/usr/bin/python3
+/usr/bin/curl
+exit=0
+```
+=> runner checkout clean(dirty 없음), 배포 HEAD=`10ede93`, python3/curl 존재, secret 파일 가독(`test -r` 성공, 원문 미출력).
+
+계약 명령 2 (실행함):
+```text
+$ ssh fe@172.24.63.178 'set -e
+curl -fsS http://192.168.2.2:8003/health
+curl -fsS http://192.168.2.2:8003/v1/models
+curl -fsS http://192.168.2.4:8005/health
+curl -fsS http://192.168.2.4:8005/v1/models
+cd /Users/fe/agent-work/iop-dev-corp
+OPENAI_API_KEY="$(cat build/dev-corp-runtime/.secrets/openai_api_key)"
+curl -fsS -H "Authorization: Bearer ${OPENAI_API_KEY}" https://digitalplatform.iop.ai.kr/v1/models
+'
+== spark01 /health ==                # http 200, empty body
+== spark01 /v1/models ==
+{"object":"list","data":[{"id":"ornith:35b","object":"model","created":1783981560,"owned_by":"vllm","root":"deepreinforce-ai/Ornith-1.0-35B-FP8",...}]}
+== spark02 /health ==                # http 200, empty body
+== spark02 /v1/models ==
+{"object":"list","data":[{"id":"ornith:35b","object":"model","created":1783981560,"owned_by":"vllm","root":"deepreinforce-ai/Ornith-1.0-35B-FP8",...}]}
+== public edge /v1/models ==
+{"object":"list","data":[{"id":"gemma4:26b","object":"model","created":1783981560,"owned_by":"iop"},{"id":"ornith:35b","object":"model","created":1783981560,"owned_by":"iop"}]}
+exit=0
+```
+판정: TEST-1 preflight **PASS** — 두 계약 명령 모두 exit 0. Spark01/02 direct `/health`·`/v1/models`에서 `ornith:35b` 정상, public Edge `/v1/models` auth 성공(`gemma4:26b`, `ornith:35b`). blocker 없음. (참고: 배포 HEAD `10ede93`은 로컬 HEAD의 조상 = 배포 stale, TEST-2 판정에서 상술.)
+
+### TEST-2 중간 검증
+```text
+$ ssh fe@172.24.63.178 'cd /Users/fe/agent-work/iop-dev-corp && OPENAI_API_KEY="$(cat build/dev-corp-runtime/.secrets/openai_api_key)" python3 - <<'"'"'PY'"'"'
+import json
+import os
+import time
+import urllib.error
+import urllib.request
+
+payload = {
+    "model": "ornith:35b",
+    "messages": [{"role": "user", "content": "Reply with one short sentence and do not include reasoning."}],
+    "stream": True,
+    "temperature": 0,
+    "max_tokens": 64,
+    "chat_template_kwargs": {"enable_thinking": False},
+}
+
+cases = [
+    ("direct_spark01", "http://192.168.2.2:8003/v1/chat/completions", {}),
+    ("direct_spark02", "http://192.168.2.4:8005/v1/chat/completions", {}),
+    ("iop_public_ornith", "https://digitalplatform.iop.ai.kr/v1/chat/completions", {"Authorization": "Bearer " + os.environ["OPENAI_API_KEY"]}),
+]
+
+def run_case(name, url, headers):
+    req_headers = {"Content-Type": "application/json"}
+    req_headers.update(headers)
+    req = urllib.request.Request(url, data=json.dumps(payload).encode("utf-8"), headers=req_headers, method="POST")
+    started = time.monotonic()
+    content = []
+    reasoning_seen = False
+    first_content_sec = None
+    status = None
+    try:
+        with urllib.request.urlopen(req, timeout=180) as resp:
+            status = resp.status
+            for raw in resp:
+                line = raw.decode("utf-8", "replace").strip()
+                if not line.startswith("data: "):
+                    continue
+                data = line[6:]
+                if data == "[DONE]":
+                    break
+                obj = json.loads(data)
+                for choice in obj.get("choices", []):
+                    delta = choice.get("delta") or {}
+                    if delta.get("reasoning_content") or delta.get("reasoning") or delta.get("reasoning_text"):
+                        reasoning_seen = True
+                    piece = delta.get("content")
+                    if piece:
+                        if first_content_sec is None:
+                            first_content_sec = round(time.monotonic() - started, 3)
+                        content.append(piece)
+    except urllib.error.HTTPError as exc:
+        body = exc.read().decode("utf-8", "replace")
+        return {"name": name, "ok": False, "status": exc.code, "error_body": body[:500]}
+    except Exception as exc:
+        return {"name": name, "ok": False, "error": repr(exc)}
+    text = "".join(content).strip()
+    return {
+        "name": name,
+        "ok": status == 200 and first_content_sec is not None and not reasoning_seen,
+        "status": status,
+        "first_content_sec": first_content_sec,
+        "reasoning_seen": reasoning_seen,
+        "content_preview": text[:200],
+    }
+
+results = [run_case(*case) for case in cases]
+print(json.dumps({"payload": {"model": payload["model"], "chat_template_kwargs": payload["chat_template_kwargs"]}, "results": results}, ensure_ascii=False, indent=2))
+if not all(item.get("ok") for item in results):
+    raise SystemExit(1)
+PY'
+{
+  "payload": {
+    "model": "ornith:35b",
+    "chat_template_kwargs": {
+      "enable_thinking": false
+    }
+  },
+  "results": [
+    {
+      "name": "direct_spark01",
+      "ok": true,
+      "status": 200,
+      "first_content_sec": 0.094,
+      "reasoning_seen": false,
+      "content_preview": "Understood."
+    },
+    {
+      "name": "direct_spark02",
+      "ok": true,
+      "status": 200,
+      "first_content_sec": 0.118,
+      "reasoning_seen": false,
+      "content_preview": "Understood."
+    },
+    {
+      "name": "iop_public_ornith",
+      "ok": false,
+      "status": 400,
+      "error_body": "{\"error\":{\"type\":\"invalid_request_error\",\"message\":\"chat_template_kwargs is not supported for /v1/chat/completions\"}}\n"
+    }
+  ]
+}
+exit=1
+```
+판정: TEST-2 think-off field smoke **PARTIAL / gate 미충족(exit 1)**.
+- `direct_spark01`, `direct_spark02`: `ok:true` (status 200, `reasoning_seen:false`, `first_content_sec` 0.094s / 0.118s, content `"Understood."`) → provider-native think-off가 Spark provider 레벨에서 동작함을 증명.
+- `iop_public_ornith`: `ok:false`, HTTP **400** `chat_template_kwargs is not supported for /v1/chat/completions` → IOP-via-Edge case 실패. 세 case 모두 `ok:true` 게이트 미충족.
+- 근본 원인: 배포 HEAD `10ede93`이 passthrough 구현(`5cd7aea`/`33f8f5e`) 이전 바이너리라 `chat_template_kwargs`를 unsupported-key(`chat_handler.go:334`)로 거부. 현재 소스(HEAD)는 `chat_handler.go:519`에서 처리하고 `server_test.go:5681-5713` 단위 테스트로 provider tunnel body 보존을 증명(코드 결함 아님, 배포 stale). `계획 대비 변경 사항`·`주요 설계 결정` 참조.
+- 후속: dev-corp runtime을 passthrough 포함 ref로 clean sync → rebuild → redeploy(`agent-ops/skills/project/dev-corp-runtime-deploy/SKILL.md`) 후 TEST-2 재실행하면 S10의 IOP-via-Edge evidence가 채워진다. rebuild/redeploy는 이 plan 범위 밖이다.
+
+### 최종 검증
+```text
+$ TEST-1 preflight commands (2) + TEST-2 smoke command  — 모두 runner에서 실행함
+- TEST-1 preflight cmd1: exit 0 (PASS)
+- TEST-1 preflight cmd2: exit 0 (PASS)  — Spark01/02 ornith:35b + public Edge auth 정상
+- TEST-2 smoke: exit 1  — direct_spark01/02 ok:true, iop_public_ornith HTTP 400
+
+최종 판정: 부분 통과 / 배포 stale blocker.
+- TEST-1 preflight: PASS (계약 2개 명령 모두 exit 0).
+- TEST-2 최종 게이트(세 case 모두 ok:true, exit 0): 미충족(exit 1). direct Spark 2건은 PASS이나
+  IOP-via-Edge case가 배포 stale(HEAD 10ede93 < passthrough 커밋 5cd7aea/33f8f5e)로 400.
+- devcorp-smoke(S10)의 IOP-via-Edge runtime evidence는 현재 배포본에서 미충족.
+후속 조치: dev-corp runtime을 passthrough 포함 ref로 clean sync + rebuild + redeploy
+  (agent-ops/skills/project/dev-corp-runtime-deploy/SKILL.md) 후 TEST-2를 재실행하면 S10 evidence가 채워진다.
+  이 plan은 rebuild/redeploy를 범위에서 제외하므로 별도 dev-corp deploy follow-up으로 처리한다.
+```
+
+---
+
+> **[IMPLEMENTING AGENT — BEFORE SAVING] Have you filled in every implementation-owned section: completion table, implementation checklist, changes from plan, design decisions, and verification output?**
+> If anything is blank, go back and fill it in before saving this file.
+> Leave review-agent-only sections unchanged.
+
+Sections and their ownership:
+
+| Section | Owner | Note |
+|---------|-------|------|
+| Header comment, 개요, 리뷰 에이전트 지시 | Fixed at stub creation | Implementing agent must not modify or execute these |
+| Roadmap Targets | Fixed at stub creation from plan | Implementing agent must not modify; code-review copies it into `complete.log` as `Roadmap Completion` only on PASS |
+| 구현 항목별 완료 여부 | Implementing agent | Check completed items only |
+| 구현 체크리스트 | Implementing agent | Check completed items only; final checkbox is mandatory |
+| 코드리뷰 전용 체크리스트 | Review agent only | Implementing agent must not modify or check |
+| 계획 대비 변경 사항, 주요 설계 결정 | Implementing agent | Replace placeholder text with actual content |
+| 사용자 리뷰 요청 | Implementing agent | Keep `상태: 없음` unless a selected Milestone lock decision blocks implementation |
+| 리뷰어를 위한 체크포인트 | Fixed at stub creation | Pre-filled from plan |
+| 검증 결과 | Implementing agent | Fill actual command output |
+| 코드리뷰 결과 | Review agent appends | Not included in stub |
+
+## 코드리뷰 결과
+
+- 종합 판정: FAIL
+- 차원별 평가:
+  - Correctness: Pass
+  - Completeness: Fail
+  - Test coverage: Fail
+  - API contract: Fail
+  - Code quality: Pass
+  - Implementation deviation: Pass
+  - Verification trust: Pass
+  - Spec conformance: Fail
+- 발견된 문제:
+  - Required: `agent-task/m-openai-compatible-provider-passthrough-contract-sync/CODE_REVIEW-cloud-G07.md:269`의 `iop_public_ornith` case가 `ok:false`, HTTP 400 `chat_template_kwargs is not supported for /v1/chat/completions`로 실패했다. `PLAN-cloud-G07.md:226`의 TEST-2 성공 조건은 세 case 모두 `ok:true`이고, SDD S10 및 Milestone `devcorp-smoke`는 IOP 경유 Ornith Spark 요청에서 `chat_template_kwargs.enable_thinking=false`가 provider까지 전달되는 evidence를 요구한다. direct Spark 2건은 통과했지만 IOP 경유 smoke가 실패했으므로 Roadmap Target 완료 evidence가 부족하다. 수정: dev-corp runtime을 passthrough 포함 ref로 clean sync, rebuild, redeploy한 뒤 동일 TEST-2 smoke를 재실행해 `iop_public_ornith`까지 `ok:true`와 first content/reasoning observation을 기록한다.
+- 다음 단계: FAIL follow-up으로 같은 task group에 `PLAN-cloud-G07.md`와 `CODE_REVIEW-cloud-G07.md`를 새로 작성한다.
--- a/agent-task/archive/2026/07/m-openai-compatible-provider-passthrough-contract-sync_1/code_review_cloud_G07_1.log
+++ b/agent-task/archive/2026/07/m-openai-compatible-provider-passthrough-contract-sync_1/code_review_cloud_G07_1.log
@ -0,0 +1,312 @@
+<!-- task=m-openai-compatible-provider-passthrough-contract-sync plan=1 tag=REVIEW_TEST -->
+
+# Code Review Reference - REVIEW_TEST
+
+> **[IMPLEMENTING AGENT — READ FIRST] Filling in this file is the mandatory final step of implementation.**
+> The task is NOT complete until every implementation-owned section below is filled in.
+> Complete the `구현 체크리스트`; the final checklist item is mandatory before saving.
+> Fill implementation-owned sections, then stop with active files in place and report ready for review.
+> If implementation is blocked by a selected Milestone `구현 잠금 > 결정 필요` item, fill `사용자 리뷰 요청` with linked evidence and stop with active files in place; code-review decides whether to write `USER_REVIEW.md`. Environment/secret/service blockers, generic scope changes, repeated failures, and evidence gaps that a follow-up agent can close are normal follow-up issues, not user-review blockers by themselves.
+> Do not ask the user directly, present choices in chat, or call `request_user_input` during implementation; record only Milestone lock decisions in `사용자 리뷰 요청` and stop for code-review.
+> Finalization (`코드리뷰 결과`, log rename, `complete.log`, archive moves, `코드리뷰 전용 체크리스트`) is review-agent-only, even after compaction/resume.
+> Follow the ownership table at the bottom of this file for which sections you own.
+
+## 개요
+
+date=2026-07-14
+task=m-openai-compatible-provider-passthrough-contract-sync, plan=1, tag=REVIEW_TEST
+
+## Roadmap Targets
+
+- Milestone: `agent-roadmap/phase/routing-policy-model-orchestration/milestones/openai-compatible-provider-passthrough-contract-sync.md`
+- Milestone link: [Milestone 문서](agent-roadmap/phase/routing-policy-model-orchestration/milestones/openai-compatible-provider-passthrough-contract-sync.md)
+- Task ids:
+  - `devcorp-smoke`: dev-corp IOP 경유 Ornith Spark 요청에서 `chat_template_kwargs.enable_thinking=false`가 provider까지 전달된다.
+- Completion mode: check-on-pass
+
+## Archive Evidence Snapshot
+
+- Archived plan: `agent-task/m-openai-compatible-provider-passthrough-contract-sync/plan_cloud_G07_0.log`
+- Archived review: `agent-task/m-openai-compatible-provider-passthrough-contract-sync/code_review_cloud_G07_0.log`
+- Verdict: FAIL
+- Required issue summary:
+  - `iop_public_ornith` failed the TEST-2 smoke with HTTP 400 `chat_template_kwargs is not supported for /v1/chat/completions`; direct Spark01/Spark02 passed with `ok:true`, fast first content, and `reasoning_seen:false`.
+  - Reviewer rerun on 2026-07-14 reproduced the same shape: direct Spark01 `ok:true` first_content `0.095s`, direct Spark02 `ok:true` first_content `0.081s`, IOP public Ornith HTTP 400.
+- Affected files/surfaces:
+  - No source-code fix is expected from the previous evidence. The blocker is deployed dev-corp runtime parity.
+  - Remote runner checkout observed at `10ede93 chore(dev-corp): Control Plane compose 배포 상태를 반영한다`.
+  - Local source contains the required passthrough handling at `apps/edge/internal/openai/chat_handler.go:519` and the provider-native preservation test at `apps/edge/internal/openai/server_test.go:5681`.
+  - `git show 10ede93:apps/edge/internal/openai/chat_handler.go | rg chat_template_kwargs` returned no matches, so the observed public Edge 400 is consistent with stale deployed code.
+- Verification evidence carried forward:
+  - TEST-1 preflight passed on runner: clean `main...origin/main`, `python3` and `curl` present, secret file readable without printing the secret, Spark01/Spark02 `/health` and `/v1/models` passed, public Edge `/v1/models` auth passed.
+  - TEST-2 gate remains unmet because all three cases must be `ok:true`; the IOP public case is still `ok:false`.
+- Roadmap carryover:
+  - Continue claiming only `devcorp-smoke`; do not mark roadmap completion unless the final TEST-2 smoke exits 0 with `iop_public_ornith` included.
+- Narrow archive reread allowed if exact prior stdout is needed:
+  - `agent-task/m-openai-compatible-provider-passthrough-contract-sync/plan_cloud_G07_0.log`
+  - `agent-task/m-openai-compatible-provider-passthrough-contract-sync/code_review_cloud_G07_0.log`
+
+## 이 파일을 읽는 리뷰 에이전트에게
+
+> **[REVIEW AGENT ONLY]** 아래 종결 절차는 코드리뷰 에이전트 전용이다. 구현 에이전트는 이 섹션을 실행하지 않는다.
+
+각 항목의 구현을 실제 소스 파일과 대조하고, `검증 결과` 섹션의 출력이 코드와 일치하는지 확인하세요.
+리뷰 완료는 아래 순서까지 끝난 상태를 의미합니다.
+
+1. 판정을 append한다.
+2. `CODE_REVIEW-cloud-G07.md` -> `code_review_cloud_G07_N.log`, `PLAN-cloud-G07.md` -> `plan_cloud_G07_M.log`로 아카이브한다.
+3. PASS이면 `complete.log` 작성 후 active task 디렉터리를 `agent-task/archive/YYYY/MM/m-openai-compatible-provider-passthrough-contract-sync/`로 이동한다. WARN/FAIL이면 user-review gate를 확인한 뒤 다음 active plan/review 파일 또는 `USER_REVIEW.md`를 작성한다.
+4. PASS이고 task group이 `m-<milestone-slug>`이면 완료 이벤트 메타데이터를 보고한다. roadmap 상태 체크와 `update-roadmap` 호출은 런타임 책임이다.
+5. 적용 가능한 `코드리뷰 전용 체크리스트` 항목을 최종 `.log` 위치에서 체크한 뒤 보고한다.
+
+---
+
+## 구현 항목별 완료 여부
+
+| 항목 | 완료 여부 |
+|------|---------|
+| [REVIEW_TEST-1] Dev-Corp Runtime Parity Deploy | [x] (public Edge를 `217930f`로 redeploy 완료, source/build/deploy parity 확보) |
+| [REVIEW_TEST-2] Think-Off Field Smoke Re-run | [x] (direct Spark01/02 + `iop_public_ornith` 세 case 모두 `ok:true`, smoke exit 0) |
+
+## 구현 체크리스트
+
+- [x] REVIEW_TEST-1 dev-corp runtime을 passthrough 포함 source ref로 clean sync, test, rebuild, redeploy하고 source/build/deploy parity evidence를 `CODE_REVIEW-cloud-G07.md`에 기록한다. (runner clean sync `10ede93`→`217930f`, `go test ./...` pass, edge/node 바이너리 빌드, **public Edge `toki@iop.ai.kr` 재배포까지 완료**)
+- [x] REVIEW_TEST-2 redeploy 후 동일 `chat_template_kwargs.enable_thinking=false` TEST-2 smoke를 실행해 direct Spark01, direct Spark02, IOP public Ornith 세 case가 모두 `ok:true`인지 기록한다. (세 case 모두 `ok:true`, `reasoning_seen:false`, smoke exit 0)
+- [x] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.
+
+## 코드리뷰 전용 체크리스트
+
+> **[REVIEW AGENT ONLY]** 이 체크리스트는 코드리뷰 에이전트만 사용한다.
+> 구현 에이전트는 이 섹션을 수정하거나 체크하지 않는다.
+
+- [x] `코드리뷰 결과`에 `PASS`, `WARN`, `FAIL` 중 하나의 판정을 append한다.
+- [x] 판정과 `차원별 평가`, Required/Suggested/Nit 분류가 서로 일치한다.
+- [x] active `CODE_REVIEW-*-G??.md`를 `code_review_cloud_G07_N.log`로 아카이브한다.
+- [x] active `PLAN-*-G??.md`를 `plan_cloud_G07_M.log`로 아카이브한다.
+- [x] `.gitignore`의 Agent-Ops 관리 block이 `agent-task/**/*.md`와 `agent-task/**/*.log`를 unignore하고 `agent-roadmap/current.md`를 ignore하는지 확인한다.
+- [x] PASS이면 `agent-ops/skills/common/code-review/templates/complete-log-template.md` 기준으로 `complete.log`를 작성하고 active `.md` 파일을 남기지 않는다.
+- [x] PASS이면 active task 디렉터리 `agent-task/m-openai-compatible-provider-passthrough-contract-sync/`를 `agent-task/archive/YYYY/MM/m-openai-compatible-provider-passthrough-contract-sync/`로 이동하고 최종 archive 경로에서 이 체크리스트를 갱신한다.
+- [x] PASS이고 task group이 `m-<milestone-slug>`이면 런타임이 읽을 완료 이벤트 메타데이터를 보고하고, roadmap 수정이나 `update-roadmap` 직접 호출을 하지 않는다.
+- [ ] PASS split 작업이면 이동 후 빈 active parent `agent-task/{task_group}/`를 제거하거나, 남은 sibling/file이 있어 유지했다고 확인한다.
+- [ ] WARN/FAIL이고 user-review gate가 트리거되지 않았으면 다음 active `PLAN-cloud-G07.md`와 `CODE_REVIEW-cloud-G07.md`를 작성하고 `complete.log`를 작성하지 않는다.
+- [ ] USER_REVIEW이면 `agent-ops/skills/common/code-review/templates/user-review-template.md` 기준으로 `USER_REVIEW.md`를 작성하고 active `PLAN-*.md`, `CODE_REVIEW-*.md`, `complete.log`를 남기지 않는다.
+- [ ] USER_REVIEW가 연결된 Milestone 결정으로 완료/PASS 해소되면 `USER_REVIEW.md`를 해소 상태로 갱신하고 `complete.log`를 작성한 뒤 task directory를 archive로 이동한다.
+
+## 계획 대비 변경 사항
+
+- **public Edge 위치와 배포 방식이 plan 가정과 다름 (해소됨).** plan/이전 리뷰는 "runner checkout을 sync하면 public Edge가 고쳐진다"는 토폴로지를 가정했으나, 실제 dev-corp public Edge는 mac-mini runner가 아니라 별도 host `iop.ai.kr`(=`digitalplatform.iop.ai.kr`=`115.21.224.82`, `Tokiui-MacBookPro.local`, Darwin arm64)에서 동작한다. 초기에는 이 host 접근 경로가 없어 blocker로 기록했으나, **사용자가 `toki@iop.ai.kr` 접근을 제공**하여 해소했다. 해당 host의 `/Users/toki/agent-work/iop-dev-corp`는 git checkout이 아니라 바이너리+config 배포 대상이므로(git repo 아님, launchd 관리 아님), redeploy는 **runner에서 `217930f`로 빌드·`go test` 통과한 edge 바이너리를 scp로 복사 → 기존 바이너리 백업 → 교체 → edge 프로세스 재시작** 방식으로 수행했다.
+- **public Edge redeploy 실제 수행.** 기존 public edge(PID 93322, stale)를 종료하고 `217930f` 바이너리로 교체·재시작(new PID 61352)했다. 롤백용 백업 `iop-edge.bak-pre-passthrough-20260714_083428`(기존 stale 바이너리)을 보관했다. 재시작 전 `config check`가 실제 `edge.yaml`에 대해 `OK`(exit 0)임을 확인했고, public host의 `edge.yaml`은 이미 올바른 현재 config(`gemma4:26b`+`ornith:35b`, Spark `8003/8005`, Mac Studio `8004`)라 그대로 재사용했다. 재시작 후 3개 provider(Spark01/02 ornith, Mac Studio) 모두 `healthy`로 재연결됐다.
+- **mac-mini local orphan Edge는 건드리지 않음.** mac-mini에도 `iop-edge`(PID 50870)가 있으나 `/v1/models`가 `gemma4:26b`만 노출하는 orphan/secondary(실제 provider node 미연결, stale config)이며 public Edge가 아니다. S10과 무관하고 위험만 있어 미변경.
+- **runner 빌드는 staging 경로 사용.** runner에서는 `217930f` edge/node 바이너리를 `build/dev-corp-runtime/bin/staging-217930f/`에 빌드했고(실행 중 orphan 미교체), 이 중 edge 바이너리를 public host 배포 소스로 사용했다. control-plane은 fix 무관 + public host에서 이미 실행 중이라 재빌드/재배포 대상에서 제외했다.
+
+## 주요 설계 결정
+
+- **fix는 Edge 전용임을 확인.** `33f8f5e`(chat_handler.go/responses_handler.go/run_dispatch.go), `5cd7aea`(chat_handler.go). `5cd7aea`의 node 변경은 `apps/node/internal/adapters/openai_compat/openai_compat_test.go`(test-only)뿐이고, `217930f`은 무관한 agent-client gateway config다. 즉 런타임 fix는 전적으로 Edge 바이너리에 있으며, Node 재배포는 이 400 해소에 기능적으로 불필요하다.
+- **fix 정확성 소스 검증.** `ornith:35b`은 provider-pool 라우트(`dispatch.ProviderPool==true`)라서 `handleChatCompletions`가 `decodeChatCompletionRequestLenient`(chat_handler.go:56)로 디코드 → `chat_template_kwargs` 같은 unknown field를 거부하지 않고 raw body를 tunnel passthrough로 provider까지 전달한다. strict 거부(`"%s is not supported for /v1/chat/completions"`, chat_handler.go:334)는 non-provider 경로에서만 적용된다. stale orphan 바이너리는 `chat_template_kwargs` 심볼 참조가 0이라 모든 요청에 strict 거부가 걸려 관측된 400과 정확히 일치한다.
+- **build/test로 fix 동작 확인.** runner에서 `go test ./...` 통과(exit 0), 특히 `iop/apps/edge/internal/openai` 패키지(passthrough + provider-native preservation 테스트 포함) 통과. staged `217930f` edge 바이너리는 `chat_template_kwargs` 심볼을 포함(strings 기준 1건)하고, 실행 중 orphan 바이너리는 0건이다.
+
+## 사용자 리뷰 요청
+
+_기본값은 `없음`이다. 구현 중 새 결정이 필요해 보여도 직접 질문하거나 선택지를 제시하거나 `request_user_input`을 호출하지 않는다. 이 섹션은 선택된 Milestone `구현 잠금 > 결정 필요` 항목이 실구현을 차단할 때만 채운다. 외부 환경/secret/서비스 준비, 검증 증거 공백, 반복 실패, 일반 범위 조정은 사용자 리뷰 요청이 아니며 `검증 결과`, `계획 대비 변경 사항`, 또는 code-review의 일반 follow-up plan으로 처리한다._
+
+- 상태: 없음
+- 사유 유형: 없음
+- 연결 대상: 없음
+- 결정 필요: 없음
+- 차단 근거: 없음
+- 실행한 검증/명령: 없음
+- 자동 후속 불가 이유: 없음
+- 재개 조건: 없음
+
+## 리뷰어를 위한 체크포인트
+
+- archived review의 Required 이슈가 dev-corp runtime parity deploy로 해소됐는지 확인한다.
+- source ref가 `5cd7aea`와 `33f8f5e`를 포함하고, deployed runtime이 stale `10ede93`에 머물지 않는지 확인한다.
+- Spark direct/provider 확인이 현재 작업 머신이 아니라 mac-mini runner `ssh fe@172.24.63.178` 안에서 수행됐는지 확인한다.
+- TEST-2 smoke에서 `direct_spark01`, `direct_spark02`, `iop_public_ornith`가 모두 `ok:true`인지 확인한다.
+- `iop_public_ornith`가 HTTP 200, `reasoning_seen:false`, `first_content_sec` 값을 갖는지 확인한다.
+- secret/token 원문이 검증 출력이나 최종 보고에 포함되지 않았는지 확인한다.
+
+## 검증 결과
+
+_구현 에이전트가 각 중간 검증 및 최종 검증 명령 실행 후 출력을 여기에 붙여 넣는다._
+
+필수 규칙:
+- 검증 명령은 고정된 계약이다. 임의로 대체하지 않는다.
+- 대체가 필요하면 `계획 대비 변경 사항`에 이유와 대체 명령을 기록한다.
+- `검증 결과`에는 실제 stdout/stderr를 붙여 넣는다.
+- 사용자 리뷰 요청으로 명령을 끝까지 실행하지 못했다면 `사용자 리뷰 요청`에 실행한 명령, 실제 출력, 미실행 명령의 사유를 기록한다.
+- mobile/UI hang, timeout, 또는 2분 무진행은 blind retry를 중단하고 focused rerun 명령과 screenshot/window/UI-tree evidence path를 남기며, 불가능하면 정확한 사유를 남긴다.
+
+### REVIEW_TEST-1 중간 검증
+
+**1) runner clean sync + source parity** (`ssh fe@172.24.63.178`, `/Users/fe/agent-work/iop-dev-corp`)
+```text
+$ git fetch origin main && git reset --hard origin/main && git clean -fd && git status --short --branch && git log --oneline -5 && git merge-base --is-ancestor 5cd7aea HEAD && git merge-base --is-ancestor 33f8f5e HEAD && git show HEAD:apps/edge/internal/openai/chat_handler.go | grep chat_template_kwargs
+   10ede93..217930f  main       -> origin/main
+HEAD is now at 217930f feat: update claude client gateway configuration
+## main...origin/main
+217930f feat: update claude client gateway configuration
+5cd7aea fix(openai): provider native thinking을 보존한다
+f430a07 update roadmap phase and milestone for openai-compatible provider passthrough
+132af4f chore: archive logs for openai-compatible-provider-passthrough-contract-sync task
+33f8f5e feat(edge): OpenAI compatible provider pass-through & test coverage
+5cd7aea ancestor: yes
+33f8f5e ancestor: yes
+	ctkRaw, ok := raw["chat_template_kwargs"]
+```
+- 관측: runner가 stale `10ede93` → `217930f`로 clean sync됨. passthrough 커밋 `5cd7aea`/`33f8f5e`가 HEAD의 ancestor이고, deployed source(HEAD)에 `chat_template_kwargs` 처리가 존재.
+
+**2) provider direct preflight**
+```text
+$ curl -fsS http://192.168.2.2:8003/v1/models  -> ornith:35b (deepreinforce-ai/Ornith-1.0-35B-FP8), max_model_len 262144
+$ curl -fsS http://192.168.2.4:8005/v1/models  -> ornith:35b (deepreinforce-ai/Ornith-1.0-35B-FP8), max_model_len 262144
+$ curl -fsS http://192.168.2.3:8004/health     -> {"status":"healthy","model_loaded":true,"model_name":"mlx-community/gemma-4-26b-a4b-it-nvfp4",...}
+$ curl -fsS http://192.168.2.3:8004/v1/models   -> mlx-community/gemma-4-26b-a4b-it-nvfp4
+```
+- 관측: Spark01(8003)/Spark02(8005) Ornith, Mac Studio(8004) Gemma4 모두 `/health`+`/v1/models` 성공.
+
+**3) 빌드 전 test** (`PATH=/opt/homebrew/bin:$PATH`, go1.26.4)
+```text
+$ go test ./...
+ok  	iop/apps/edge/internal/openai	9.966s
+ok  	iop/apps/edge/internal/service	3.603s
+ok  	iop/apps/node/internal/adapters/openai_compat	3.928s
+... (all packages ok / [no test files]) ...
+=== go test exit: 0 ===
+```
+
+**4) rebuild (staging, 비파괴)**
+```text
+$ make build-edge-host  BUILD_BIN_DIR=build/dev-corp-runtime/bin/staging-217930f EDGE_HOST_BINARY=.../iop-edge-host
+$ make build-node-target NODE_TARGET=darwin-arm64 BUILD_BIN_DIR=.../staging-217930f
+$ make build-node-target NODE_TARGET=linux-arm64  BUILD_BIN_DIR=.../staging-217930f
+-rwxr-xr-x  22347762  iop-edge-host
+-rwxr-xr-x  27280098  iop-node-darwin-arm64
+-rwxr-xr-x  26413584  iop-node-linux-arm64
+$ git rev-parse HEAD -> 217930f9b0233fe04e1f48cf69f1dcd921fc39fb
+```
+- staged edge/node 바이너리가 `217930f`에서 clean 빌드됨.
+
+**5) binary passthrough symbol parity**
+```text
+$ strings staging-217930f/iop-edge-host | grep -c chat_template_kwargs        -> 1   (fix 포함)
+$ strings build/dev-corp-runtime/bin/iop-edge | grep -c chat_template_kwargs  -> 0   (실행 중 orphan = stale)
+```
+
+**6) 배포 토폴로지 / redeploy 접근성 확인**
+```text
+$ ps aux | grep iop-edge  -> PID 50870  ./build/dev-corp-runtime/bin/iop-edge -c build/dev-corp-runtime/edge.yaml serve  (mac-mini)
+$ curl https://digitalplatform.iop.ai.kr/v1/models  -> ["gemma4:26b", "ornith:35b"]   (public Edge)
+$ curl http://127.0.0.1:18086/v1/models             -> ["gemma4:26b"]                 (mac-mini orphan Edge)
+$ curl http://iop.ai.kr:18086/v1/models             -> ["gemma4:26b", "ornith:35b"]   (public Edge = 115.21.224.82)
+$ python3 -c gethostbyname -> iop.ai.kr=115.21.224.82, digitalplatform.iop.ai.kr=115.21.224.82  (mac-mini는 172.24.63.178)
+$ (runner) ~/.ssh/config iop.ai.kr entries: 없음 / known_hosts iop.ai.kr: 0 / ssh-add -l: no agent
+$ (runner & local) ssh <user>@iop.ai.kr  (fe,iop,ubuntu,dplab,admin,deploy,root,dc_dev,...): 전부 실패
+$ (runtime/repo) public Edge 배포 스크립트: 없음 (node bootstrap/deploy 스크립트만 존재)
+```
+- 관측: 실제 public Edge는 mac-mini와 다른 host `iop.ai.kr`(115.21.224.82 / `Tokiui-MacBookPro.local`)에서 동작. 초기에는 접근 경로가 없어 blocker였으나 사용자가 `toki@iop.ai.kr` 접근을 제공하여 해소.
+
+**7) public Edge redeploy 실행** (`ssh -l toki iop.ai.kr`, checkout `/Users/toki/agent-work/iop-dev-corp`, git repo 아님 → 바이너리 복사 방식)
+```text
+$ (runner) scp staging-217930f/iop-edge-host  toki@iop.ai.kr:.../bin/iop-edge.new-217930f   -> scp OK
+$ (public) strings iop-edge.new-217930f | grep -c chat_template_kwargs   -> 1
+$ (public) iop-edge.new-217930f config check --config build/dev-corp-runtime/edge.yaml
+OK build/dev-corp-runtime/edge.yaml            (exit 0)
+$ (public) cp iop-edge iop-edge.bak-pre-passthrough-20260714_083428   # 롤백 백업(기존 stale)
+$ (public) mv iop-edge.new-217930f iop-edge                            # 교체
+$ (public) kill 93322 (old edge, stale) -> old edge stopped
+$ (public) nohup ./build/dev-corp-runtime/bin/iop-edge --config build/dev-corp-runtime/edge.yaml serve &  -> new pid 61352
+$ (public) lsof LISTEN -> iop-edge 61352 : 18085/18086/18087
+$ (public) ps etime new edge -> 01:20+ (SSH 세션 종료 후에도 지속)
+```
+- 재시작 후 provider 재연결 확인(public host control-plane `127.0.0.1:18002/edges/dev-corp-edge/status`):
+```text
+/v1/models -> ['gemma4:26b', 'ornith:35b']
+corp-dgx-spark-01-ornith health=healthy cap=4 in_flight=0 queued=0
+corp-dgx-spark-02-ornith health=healthy cap=4 in_flight=0 queued=0
+corp-mac-studio-mlx-vllm health=healthy cap=5 in_flight=0 queued=0
+```
+
+### REVIEW_TEST-2 중간 검증
+
+plan 고정 smoke 명령을 변경 없이 runner에서 실행(secret는 `.secrets/openai_api_key`에서 주입, 원문 미출력).
+
+**(a) redeploy 전 baseline (public Edge stale)**
+```text
+results: direct_spark01 ok:true(200,0.095s,reasoning:false), direct_spark02 ok:true(200,0.081s,reasoning:false),
+         iop_public_ornith ok:false status:400 "chat_template_kwargs is not supported for /v1/chat/completions"
+=== smoke exit: 1 ===
+```
+
+**(b) redeploy 후 재실행 (public Edge = 217930f)**
+```text
+{
+  "payload": { "model": "ornith:35b", "chat_template_kwargs": { "enable_thinking": false } },
+  "results": [
+    { "name": "direct_spark01",   "ok": true, "status": 200, "first_content_sec": 0.085, "reasoning_seen": false, "content_preview": "Understood." },
+    { "name": "direct_spark02",   "ok": true, "status": 200, "first_content_sec": 0.116, "reasoning_seen": false, "content_preview": "Understood." },
+    { "name": "iop_public_ornith","ok": true, "status": 200, "first_content_sec": 0.214, "reasoning_seen": false, "content_preview": "Understood." }
+  ]
+}
+=== smoke exit: 0 ===
+```
+- 관측: redeploy 후 세 case 모두 `ok:true`, `status:200`, `reasoning_seen:false`, `first_content_sec` 값 보유. `iop_public_ornith` 400 해소. smoke exit 0.
+
+### 최종 검증
+```text
+dev-corp runtime 배포 결과 (REVIEW_TEST) — PASS
+- Source: runner clean sync 10ede93 -> 217930f (origin/main), clean=yes, ancestors 5cd7aea+33f8f5e=yes, deployed source에 chat_template_kwargs 처리 존재
+- Provider preflight: spark01(8003)=pass, spark02(8005)=pass, mac-studio(8004)=pass
+- Pre-build tests: go test ./... = pass (exit 0; iop/apps/edge/internal/openai 포함)
+- Build: edge-host + node(darwin-arm64, linux-arm64) @217930f -> runner build/dev-corp-runtime/bin/staging-217930f
+- Deployment(public Edge redeploy): DONE — toki@iop.ai.kr(=digitalplatform.iop.ai.kr=115.21.224.82)에 217930f edge 바이너리 배포·재시작(old PID 93322 -> new PID 61352). config check OK. 롤백 백업 iop-edge.bak-pre-passthrough-20260714_083428 보관.
+- Post-deploy providers: /v1/models=[gemma4:26b, ornith:35b]; spark01-ornith/spark02-ornith/mac-studio-mlx = healthy(cap 4/4/5, in_flight 0, queued 0)
+- Binary parity: 배포된 public edge = chat_template_kwargs 포함(1), 교체 전 stale 바이너리 = 미포함(0)
+- TEST-2 smoke (redeploy 후): direct_spark01=ok:true(200,0.085s), direct_spark02=ok:true(200,0.116s), iop_public_ornith=ok:true(200,0.214s, reasoning_seen:false), exit=0
+- 최종 판정: S10 gate 충족 (세 case 모두 ok:true, iop_public_ornith status:200/reasoning_seen:false/first_content_sec 보유, smoke exit 0).
+- secret/token 원문 미노출 확인.
+
+참고(후속 개선, 필수 아님):
+- public Edge(iop.ai.kr)는 git checkout이 아닌 바이너리 배포 대상이고 launchd/start-script 없이 수동 nohup으로 기동된다. 반복 배포를 위해 public Edge용 배포/기동 스크립트와 접근 경로를 dev-corp-runtime-deploy 스킬에 명문화하면 좋다(이번 진행으로 public host=toki@iop.ai.kr 확인됨).
+```
+
+---
+
+> **[IMPLEMENTING AGENT — BEFORE SAVING] Have you filled in every implementation-owned section: completion table, implementation checklist, changes from plan, design decisions, and verification output?**
+> If anything is blank, go back and fill it in before saving this file.
+> Leave review-agent-only sections unchanged.
+
+Sections and their ownership:
+
+| Section | Owner | Note |
+|---------|-------|------|
+| Header comment, 개요, 리뷰 에이전트 지시 | Fixed at stub creation | Implementing agent must not modify or execute these |
+| Roadmap Targets | Fixed at stub creation from plan | Implementing agent must not modify; code-review copies it into `complete.log` as `Roadmap Completion` only on PASS |
+| Archive Evidence Snapshot | Fixed at stub creation from plan | Implementing agent default prior-loop context; only listed archive paths may be narrowly reread if needed |
+| 구현 항목별 완료 여부 | Implementing agent | Check completed items only |
+| 구현 체크리스트 | Implementing agent | Check completed items only; final checkbox is mandatory |
+| 코드리뷰 전용 체크리스트 | Review agent only | Implementing agent must not modify or check |
+| 계획 대비 변경 사항, 주요 설계 결정 | Implementing agent | Replace placeholder text with actual content |
+| 사용자 리뷰 요청 | Implementing agent | Keep `상태: 없음` unless a selected Milestone lock decision blocks implementation |
+| 리뷰어를 위한 체크포인트 | Fixed at stub creation | Pre-filled from plan |
+| 검증 결과 | Implementing agent | Fill actual command output |
+| 코드리뷰 결과 | Review agent appends | Not included in stub |
+
+## 코드리뷰 결과
+
+- 종합 판정: PASS
+- 차원별 평가:
+  - Correctness: Pass — provider-pool Chat Completions 경로가 lenient decode를 사용하고, `chat_template_kwargs` 보존/기본 thinking budget 비주입 테스트가 존재한다.
+  - Completeness: Pass — REVIEW_TEST-1/2 구현 체크리스트와 최종 필수 기록이 모두 채워졌고, 이전 Required 이슈였던 public Edge stale runtime parity가 해소됐다.
+  - Test coverage: Pass — `go test ./apps/edge/internal/openai ./apps/edge/internal/service ./apps/node/internal/adapters/openai_compat` 재실행 통과, live TEST-2 smoke 재실행 통과.
+  - API contract: Pass — OpenAI-compatible 계약의 provider-native field preservation 및 Edge-Node provider tunnel body 보존 기준과 일치한다.
+  - Code quality: Pass — 이번 루프는 source 변경 없이 배포/검증 evidence를 채운 작업이며, 불필요한 코드/설정 변경이 없다.
+  - Implementation deviation: Pass — plan 가정과 달랐던 public Edge host/배포 방식은 dev-corp 규칙의 `iop.ai.kr` 기준으로 정정되어 기록됐고 범위 밖 provider/runtime 튜닝은 하지 않았다.
+  - Verification trust: Pass — 리뷰어가 2026-07-14에 runner에서 동일 think-off smoke를 재실행해 `direct_spark01`, `direct_spark02`, `iop_public_ornith` 모두 `ok:true`를 확인했다.
+  - Spec conformance: Pass — SDD S10 `devcorp-smoke`의 first content latency와 reasoning absence evidence가 충족됐다.
+- 발견된 문제: 없음
+- 리뷰어 재검증:
+  - `go test ./apps/edge/internal/openai ./apps/edge/internal/service ./apps/node/internal/adapters/openai_compat` - PASS
+  - runner TEST-2 smoke - PASS: `direct_spark01=ok:true(200,0.086s)`, `direct_spark02=ok:true(200,0.082s)`, `iop_public_ornith=ok:true(200,0.242s)`, `reasoning_seen:false`
+- 다음 단계: PASS 종결 절차를 수행한다. active plan/review를 `.log`로 아카이브하고, `complete.log`를 작성한 뒤 task directory를 `agent-task/archive/2026/07/` 아래로 이동한다. roadmap 수정 또는 `update-roadmap` 호출은 하지 않고 runtime completion metadata만 보고한다.
--- a/agent-task/archive/2026/07/m-openai-compatible-provider-passthrough-contract-sync_1/complete.log
+++ b/agent-task/archive/2026/07/m-openai-compatible-provider-passthrough-contract-sync_1/complete.log
@ -0,0 +1,45 @@
+# Complete - m-openai-compatible-provider-passthrough-contract-sync
+
+## 완료 일시
+
+2026-07-14
+
+## 요약
+
+OpenAI-compatible provider passthrough 계약 동기화 Milestone의 남은 `devcorp-smoke` task를 2회 리뷰 루프 끝에 PASS로 종료했다. 이전 FAIL 원인이던 public Edge stale runtime을 `217930f` Edge binary redeploy로 해소했고, dev-corp Ornith think-off smoke가 direct Spark01/02와 IOP public Edge 모두에서 통과했다.
+
+## 루프 이력
+
+| Plan | Review | Verdict | 메모 |
+|------|--------|---------|------|
+| `plan_cloud_G07_0.log` | `code_review_cloud_G07_0.log` | FAIL | direct Spark01/02는 통과했지만 `iop_public_ornith`가 stale public Edge에서 `chat_template_kwargs is not supported for /v1/chat/completions` 400으로 실패했다. |
+| `plan_cloud_G07_1.log` | `code_review_cloud_G07_1.log` | PASS | runner clean sync, source/build/deploy parity, public Edge redeploy, TEST-2 smoke 재실행으로 세 case 모두 `ok:true`를 확인했다. |
+
+## 구현/정리 내용
+
+- mac-mini runner checkout을 `217930f`로 clean sync하고 `5cd7aea`, `33f8f5e` passthrough 커밋 포함 여부를 확인했다.
+- `217930f` 기준 Edge/Node binaries를 staging build하고, public Edge host `iop.ai.kr`에 Edge binary를 배포해 stale 400을 해소했다.
+- provider direct preflight와 public Edge post-deploy provider snapshot에서 Spark01/02 Ornith 및 Mac Studio provider가 healthy 상태임을 확인했다.
+- source 파일 변경 없이 task artifacts만 review protocol에 맞춰 정리했다.
+
+## 최종 검증
+
+- `go test ./apps/edge/internal/openai ./apps/edge/internal/service ./apps/node/internal/adapters/openai_compat` - PASS; reviewer rerun에서 세 패키지 모두 통과했다.
+- `ssh fe@172.24.63.178 ... TEST-2 think-off smoke` - PASS; `direct_spark01=ok:true(200,0.086s)`, `direct_spark02=ok:true(200,0.082s)`, `iop_public_ornith=ok:true(200,0.242s)`, `reasoning_seen:false`.
+- 구현 기록의 final TEST-2 smoke - PASS; redeploy 후 `direct_spark01=ok:true(200,0.085s)`, `direct_spark02=ok:true(200,0.116s)`, `iop_public_ornith=ok:true(200,0.214s)`, exit 0.
+
+## Roadmap Completion
+
+- Milestone: `agent-roadmap/phase/routing-policy-model-orchestration/milestones/openai-compatible-provider-passthrough-contract-sync.md`
+- Milestone link: [Milestone 문서](agent-roadmap/phase/routing-policy-model-orchestration/milestones/openai-compatible-provider-passthrough-contract-sync.md)
+- Completed task ids:
+  - `devcorp-smoke`: PASS; evidence=`agent-task/archive/2026/07/m-openai-compatible-provider-passthrough-contract-sync_1/plan_cloud_G07_1.log`, `agent-task/archive/2026/07/m-openai-compatible-provider-passthrough-contract-sync_1/code_review_cloud_G07_1.log`; verification=`TEST-2 think-off smoke via ssh fe@172.24.63.178, all three cases ok:true with first_content_sec and reasoning_seen:false`
+- Not completed task ids: 없음
+
+## 잔여 Nit
+
+- 없음
+
+## 후속 작업
+
+- 없음
--- a/agent-task/archive/2026/07/m-openai-compatible-provider-passthrough-contract-sync_1/plan_cloud_G07_0.log
+++ b/agent-task/archive/2026/07/m-openai-compatible-provider-passthrough-contract-sync_1/plan_cloud_G07_0.log
@ -0,0 +1,265 @@
+<!-- task=m-openai-compatible-provider-passthrough-contract-sync plan=0 tag=TEST -->
+
+# Implementation Plan - TEST
+
+## 이 파일을 읽는 구현 에이전트에게
+
+`CODE_REVIEW-cloud-G07.md`의 구현 에이전트 소유 섹션을 반드시 채운다. 검증 명령을 실행하고 실제 출력 또는 저장한 출력 파일 경로를 붙인 뒤 active 파일을 유지한 채 리뷰 준비를 보고한다. 최종 archive, `complete.log`, roadmap 갱신은 code-review/runtime 책임이다. 선택된 Milestone `구현 잠금 > 결정 필요` 항목이 실구현을 막을 때만 review stub의 `사용자 리뷰 요청` 섹션을 채우며, 직접 사용자에게 질문하거나 `USER_REVIEW.md`를 만들지 않는다. 외부 환경, secret, 서비스 준비, 반복 실패, evidence 공백은 일반 follow-up 또는 검증 blocker로 기록한다.
+
+## 배경
+
+현재 Milestone에서 local code/test로 `provider-error`와 `policy-priority`는 충족됐고, 남은 기능 Task는 dev-corp Ornith Spark field smoke뿐이다. 이 작업은 public IOP Edge와 mac-mini runner, 내부 Spark provider endpoint, runtime secret 파일을 함께 확인해야 하므로 작은 로컬 수정이 아니라 원격 검증 계획으로 분리한다. 목표는 `chat_template_kwargs.enable_thinking=false`가 direct Spark와 IOP 경유 요청 모두에서 provider-native think-off 동작으로 관측되는지 evidence를 남기는 것이다.
+
+## 사용자 리뷰 요청 흐름
+
+사용자 리뷰 요청은 선택된 Milestone lock decision만 active review stub의 `사용자 리뷰 요청` 섹션에 기록한다. 직접 사용자 프롬프트는 금지이며, code-review가 사용자 리뷰 요청의 정당성 검증과 실제 `USER_REVIEW.md` 작성을 소유한다.
+
+## Roadmap Targets
+
+- Milestone: `agent-roadmap/phase/routing-policy-model-orchestration/milestones/openai-compatible-provider-passthrough-contract-sync.md`
+- Milestone link: [Milestone 문서](agent-roadmap/phase/routing-policy-model-orchestration/milestones/openai-compatible-provider-passthrough-contract-sync.md)
+- Task ids:
+  - `devcorp-smoke`: dev-corp IOP 경유 Ornith Spark 요청에서 `chat_template_kwargs.enable_thinking=false`가 provider까지 전달된다.
+- Completion mode: check-on-pass
+
+## 분석 결과
+
+### 읽은 파일
+
+- `agent-roadmap/current.md`
+- `agent-roadmap/phase/routing-policy-model-orchestration/PHASE.md`
+- `agent-roadmap/phase/routing-policy-model-orchestration/milestones/openai-compatible-provider-passthrough-contract-sync.md`
+- `agent-roadmap/sdd/routing-policy-model-orchestration/openai-compatible-provider-passthrough-contract-sync/SDD.md`
+- `agent-ops/rules/project/rules.md`
+- `agent-ops/rules/common/rules-roadmap.md`
+- `agent-ops/rules/project/domain/edge/rules.md`
+- `agent-ops/rules/project/domain/node/rules.md`
+- `agent-ops/rules/project/domain/platform-common/rules.md`
+- `agent-ops/rules/project/domain/testing/rules.md`
+- `agent-test/local/rules.md`
+- `agent-test/local/edge-smoke.md`
+- `agent-test/local/node-smoke.md`
+- `agent-test/dev-corp/rules.md`
+- `agent-test/dev-corp/edge-smoke.md`
+- `agent-test/dev-corp/node-smoke.md`
+- `agent-test/dev-corp/platform-common-smoke.md`
+- `agent-test/dev-corp/inventory.yaml`
+- `agent-ops/skills/project/dev-corp-runtime-deploy/SKILL.md`
+- `agent-contract/index.md`
+- `agent-contract/outer/openai-compatible-api.md`
+- `agent-contract/inner/edge-node-runtime-wire.md`
+- `apps/edge/internal/openai/chat_handler.go`
+- `apps/edge/internal/openai/stream.go`
+- `apps/edge/internal/openai/server_test.go`
+- `apps/node/internal/adapters/openai_compat/openai_compat.go`
+- `apps/node/internal/adapters/openai_compat/openai_compat_test.go`
+
+### SDD 기준
+
+- SDD: `agent-roadmap/sdd/routing-policy-model-orchestration/openai-compatible-provider-passthrough-contract-sync/SDD.md`
+- 상태: `[승인됨]`, SDD 잠금 해제, 사용자 리뷰 없음.
+- Acceptance Scenario: `S10` -> Milestone Task `devcorp-smoke`.
+- Evidence Map: `S10` requires dev-corp single-call smoke output summary with `devcorp-smoke`, first content latency, and reasoning/content observation.
+- 구현 체크리스트는 S10 Evidence Map에서 역산해 provider direct preflight, IOP Edge route preflight, direct-vs-IOP think-off smoke summary를 만들도록 구성했다.
+
+### 테스트 환경 규칙
+
+- `test_env`: `dev-corp`.
+- `agent-test/dev-corp/rules.md`, `edge-smoke.md`, `node-smoke.md`, `platform-common-smoke.md`, `inventory.yaml`을 읽었다.
+- 적용 명령: mac-mini runner `ssh fe@172.24.63.178`, repo root `/Users/fe/agent-work/iop-dev-corp`, public OpenAI base `https://digitalplatform.iop.ai.kr/v1`, Spark direct endpoints `http://192.168.2.2:8003/v1`, `http://192.168.2.4:8005/v1`.
+- Secret rule: API key 원문은 출력하지 않는다. remote command는 `build/dev-corp-runtime/.secrets/openai_api_key`를 env로만 읽는다.
+
+#### 테스트 환경 프리플라이트
+
+- runner: mac-mini `ssh fe@172.24.63.178`.
+- repo root/workdir: `/Users/fe/agent-work/iop-dev-corp`.
+- branch/HEAD/dirty/source sync: TEST-1에서 `git status --short --branch`와 `git log --oneline -1`로 기록한다. smoke-only 작업이므로 dirty가 있으면 결과에 남기고, 배포/rebuild가 필요하다고 판단될 때만 dev-corp deploy 절차로 전환한다.
+- binary/artifact/config: Edge runtime은 public `iop.ai.kr`; config path는 inventory 기준 `/Users/toki/agent-work/iop-dev-corp/build/dev-corp-runtime/edge.yaml`. 이 plan은 config 수정이나 rebuild를 수행하지 않는다.
+- command availability: TEST-1에서 `command -v python3`와 `command -v curl`을 확인한다.
+- runtime identity: Edge id `dev-corp-edge`, Edge-Node TCP `iop.ai.kr:18087`.
+- external hosts: mac-mini runner, Spark01 `192.168.2.2:8003`, Spark02 `192.168.2.4:8005`, public Edge `digitalplatform.iop.ai.kr`.
+- blocker: SSH 불가, secret file unreadable, provider `/health` or `/v1/models` failure, public `/v1/models` auth failure, or Python/curl missing.
+
+### 테스트 커버리지 공백
+
+- direct provider field smoke: existing Go tests cannot prove provider runtime behavior; this plan fills the dev-corp field evidence gap.
+- IOP public Edge field smoke: local fake provider tests prove relay/body behavior, but not live Spark provider behavior; this plan fills S10.
+
+### 심볼 참조
+
+- none. 이 plan은 symbol rename/remove를 수행하지 않는다.
+
+### 분할 판단
+
+- split decision policy를 평가했다.
+- 단일 plan 선택: 남은 범위는 `devcorp-smoke` 한 Task이고, preflight와 smoke가 같은 원격 환경에서 순차적으로 실행되어야 같은 evidence 묶음으로 리뷰할 수 있다. 코드/API와 call-site rollout 경계가 없고, 독립적으로 PASS 처리 가능한 선행 구현 subtask도 없다.
+
+### 범위 결정 근거
+
+- 제외: runtime rebuild, config refresh, provider process restart, capacity 9/6 load smoke, `/v1/responses` provider-dependent smoke. 이번 plan은 `devcorp-smoke`의 single-call think-off evidence만 수집한다.
+- 배포나 config drift가 발견되면 이 plan 안에서 임의 수정하지 않고 blocker 또는 후속 dev-corp deploy plan으로 기록한다.
+
+### 빌드 등급
+
+- `cloud-G07`: 외부 runner, live provider, secret file, public Edge behavior가 중심이며 로컬 deterministic test만으로 완료할 수 없다.
+
+## 구현 체크리스트
+
+- [ ] TEST-1 dev-corp runner, provider, public Edge preflight를 실행하고 blocker 여부를 `CODE_REVIEW-cloud-G07.md`에 기록한다.
+- [ ] TEST-2 direct Spark와 IOP 경유 `chat_template_kwargs.enable_thinking=false` 단일 smoke를 실행하고 first content latency, reasoning delta 관측, content summary를 `CODE_REVIEW-cloud-G07.md`에 기록한다.
+- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.
+
+### [TEST-1] Dev-Corp Preflight
+
+#### 문제
+
+`devcorp-smoke`는 local checkout이 아니라 mac-mini runner와 public Edge, 내부 provider endpoint 상태에 의존한다. `agent-test/dev-corp/rules.md`는 runner checkout, provider `/health`와 `/v1/models`, public Edge auth를 먼저 확인하라고 요구한다.
+
+#### 해결 방법
+
+아래 preflight를 실행하고 실패 지점을 정확히 기록한다. secret 값은 출력하지 않는다.
+
+```bash
+ssh fe@172.24.63.178 'cd /Users/fe/agent-work/iop-dev-corp && \
+  git status --short --branch && \
+  git log --oneline -1 && \
+  command -v python3 && \
+  command -v curl && \
+  test -r build/dev-corp-runtime/.secrets/openai_api_key'
+```
+
+```bash
+ssh fe@172.24.63.178 'set -e
+curl -fsS http://192.168.2.2:8003/health
+curl -fsS http://192.168.2.2:8003/v1/models
+curl -fsS http://192.168.2.4:8005/health
+curl -fsS http://192.168.2.4:8005/v1/models
+cd /Users/fe/agent-work/iop-dev-corp
+OPENAI_API_KEY="$(cat build/dev-corp-runtime/.secrets/openai_api_key)"
+curl -fsS -H "Authorization: Bearer ${OPENAI_API_KEY}" https://digitalplatform.iop.ai.kr/v1/models
+'
+```
+
+#### 수정 파일 및 체크리스트
+
+- [ ] repo source file 수정 없음.
+- [ ] `CODE_REVIEW-cloud-G07.md`에 preflight stdout/stderr 또는 저장 경로를 기록한다.
+
+#### 테스트 작성
+
+별도 테스트 파일 작성 없음. live environment preflight가 테스트다.
+
+#### 중간 검증
+
+위 두 preflight command가 모두 exit 0이어야 TEST-2로 진행한다.
+
+### [TEST-2] Think-Off Field Smoke
+
+#### 문제
+
+SDD S10은 direct Spark와 IOP 경유 Ornith Spark 요청에서 `chat_template_kwargs.enable_thinking=false`가 provider-native think-off 결과로 관측되어야 한다고 요구한다. local fake provider 테스트만으로는 실제 Spark/vLLM runtime behavior를 증명할 수 없다.
+
+#### 해결 방법
+
+mac-mini runner에서 direct Spark01, direct Spark02, public IOP Edge에 같은 streaming Chat Completions 요청을 보내고 JSON summary를 남긴다. `reasoning_content`, `reasoning`, `reasoning_text` delta가 관측되면 fail로 기록한다. 첫 content latency는 초 단위로 기록한다.
+
+```bash
+ssh fe@172.24.63.178 'cd /Users/fe/agent-work/iop-dev-corp && OPENAI_API_KEY="$(cat build/dev-corp-runtime/.secrets/openai_api_key)" python3 - <<'"'"'PY'"'"'
+import json
+import os
+import time
+import urllib.error
+import urllib.request
+
+payload = {
+    "model": "ornith:35b",
+    "messages": [{"role": "user", "content": "Reply with one short sentence and do not include reasoning."}],
+    "stream": True,
+    "temperature": 0,
+    "max_tokens": 64,
+    "chat_template_kwargs": {"enable_thinking": False},
+}
+
+cases = [
+    ("direct_spark01", "http://192.168.2.2:8003/v1/chat/completions", {}),
+    ("direct_spark02", "http://192.168.2.4:8005/v1/chat/completions", {}),
+    ("iop_public_ornith", "https://digitalplatform.iop.ai.kr/v1/chat/completions", {"Authorization": "Bearer " + os.environ["OPENAI_API_KEY"]}),
+]
+
+def run_case(name, url, headers):
+    req_headers = {"Content-Type": "application/json"}
+    req_headers.update(headers)
+    req = urllib.request.Request(url, data=json.dumps(payload).encode("utf-8"), headers=req_headers, method="POST")
+    started = time.monotonic()
+    content = []
+    reasoning_seen = False
+    first_content_sec = None
+    status = None
+    try:
+        with urllib.request.urlopen(req, timeout=180) as resp:
+            status = resp.status
+            for raw in resp:
+                line = raw.decode("utf-8", "replace").strip()
+                if not line.startswith("data: "):
+                    continue
+                data = line[6:]
+                if data == "[DONE]":
+                    break
+                obj = json.loads(data)
+                for choice in obj.get("choices", []):
+                    delta = choice.get("delta") or {}
+                    if delta.get("reasoning_content") or delta.get("reasoning") or delta.get("reasoning_text"):
+                        reasoning_seen = True
+                    piece = delta.get("content")
+                    if piece:
+                        if first_content_sec is None:
+                            first_content_sec = round(time.monotonic() - started, 3)
+                        content.append(piece)
+    except urllib.error.HTTPError as exc:
+        body = exc.read().decode("utf-8", "replace")
+        return {"name": name, "ok": False, "status": exc.code, "error_body": body[:500]}
+    except Exception as exc:
+        return {"name": name, "ok": False, "error": repr(exc)}
+    text = "".join(content).strip()
+    return {
+        "name": name,
+        "ok": status == 200 and first_content_sec is not None and not reasoning_seen,
+        "status": status,
+        "first_content_sec": first_content_sec,
+        "reasoning_seen": reasoning_seen,
+        "content_preview": text[:200],
+    }
+
+results = [run_case(*case) for case in cases]
+print(json.dumps({"payload": {"model": payload["model"], "chat_template_kwargs": payload["chat_template_kwargs"]}, "results": results}, ensure_ascii=False, indent=2))
+if not all(item.get("ok") for item in results):
+    raise SystemExit(1)
+PY'
+```
+
+#### 수정 파일 및 체크리스트
+
+- [ ] repo source file 수정 없음.
+- [ ] direct Spark01/Spark02 결과와 IOP public 결과를 `CODE_REVIEW-cloud-G07.md`에 기록한다.
+- [ ] 실패 시 HTTP status/body, first content latency, reasoning 관측 여부를 분리 기록한다.
+
+#### 테스트 작성
+
+별도 unit test 작성 없음. SDD S10은 live dev-corp field smoke evidence가 테스트다.
+
+#### 중간 검증
+
+Python smoke command가 exit 0이어야 한다. 출력 JSON에서 세 case 모두 `ok: true`, `reasoning_seen: false`, `first_content_sec` 값이 있어야 한다.
+
+## 수정 파일 요약
+
+| 파일 | 항목 |
+|------|------|
+| 없음 | TEST-1, TEST-2는 검증/evidence 수집 작업이다. |
+| `agent-task/m-openai-compatible-provider-passthrough-contract-sync/CODE_REVIEW-cloud-G07.md` | 구현 에이전트가 실제 검증 출력과 판단을 기록한다. |
+
+## 최종 검증
+
+최종 검증은 TEST-1 preflight 두 command와 TEST-2 Python smoke command를 순서대로 실행하는 것이다. 모든 command가 exit 0이어야 하고, TEST-2 JSON summary의 세 case가 모두 `ok: true`여야 한다.
+
+모든 코드 변경 완료 후 반드시 `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 채운다. 이 파일 작성이 구현의 마지막 단계다.
--- a/agent-task/archive/2026/07/m-openai-compatible-provider-passthrough-contract-sync_1/plan_cloud_G07_1.log
+++ b/agent-task/archive/2026/07/m-openai-compatible-provider-passthrough-contract-sync_1/plan_cloud_G07_1.log
@ -0,0 +1,243 @@
+<!-- task=m-openai-compatible-provider-passthrough-contract-sync plan=1 tag=REVIEW_TEST -->
+
+# Implementation Plan - REVIEW_TEST
+
+## 이 파일을 읽는 구현 에이전트에게
+
+이 plan은 이전 TEST 루프의 FAIL follow-up이다. 직접 사용자에게 질문하지 말고, dev-corp 배포/검증 경로를 실제로 수행한 뒤 `CODE_REVIEW-cloud-G07.md`의 구현 에이전트 소유 섹션을 채운다. secret/token 원문은 출력하거나 기록하지 않는다. 선택된 Milestone `구현 잠금 > 결정 필요` 항목이 실구현을 막을 때만 review stub의 `사용자 리뷰 요청` 섹션을 채우며, 배포 stale, SSH, secret, provider 상태, 검증 공백은 일반 follow-up blocker로 기록한다.
+
+## Roadmap Targets
+
+- Milestone: `agent-roadmap/phase/routing-policy-model-orchestration/milestones/openai-compatible-provider-passthrough-contract-sync.md`
+- Milestone link: [Milestone 문서](agent-roadmap/phase/routing-policy-model-orchestration/milestones/openai-compatible-provider-passthrough-contract-sync.md)
+- Task ids:
+  - `devcorp-smoke`: dev-corp IOP 경유 Ornith Spark 요청에서 `chat_template_kwargs.enable_thinking=false`가 provider까지 전달된다.
+- Completion mode: check-on-pass
+
+## Archive Evidence Snapshot
+
+- Archived plan: `agent-task/m-openai-compatible-provider-passthrough-contract-sync/plan_cloud_G07_0.log`
+- Archived review: `agent-task/m-openai-compatible-provider-passthrough-contract-sync/code_review_cloud_G07_0.log`
+- Verdict: FAIL
+- Required issue summary:
+  - `iop_public_ornith` failed the TEST-2 smoke with HTTP 400 `chat_template_kwargs is not supported for /v1/chat/completions`; direct Spark01/Spark02 passed with `ok:true`, fast first content, and `reasoning_seen:false`.
+  - Reviewer rerun on 2026-07-14 reproduced the same shape: direct Spark01 `ok:true` first_content `0.095s`, direct Spark02 `ok:true` first_content `0.081s`, IOP public Ornith HTTP 400.
+- Affected files/surfaces:
+  - No source-code fix is expected from the previous evidence. The blocker is deployed dev-corp runtime parity.
+  - Remote runner checkout observed at `10ede93 chore(dev-corp): Control Plane compose 배포 상태를 반영한다`.
+  - Local source contains the required passthrough handling at `apps/edge/internal/openai/chat_handler.go:519` and the provider-native preservation test at `apps/edge/internal/openai/server_test.go:5681`.
+  - `git show 10ede93:apps/edge/internal/openai/chat_handler.go | rg chat_template_kwargs` returned no matches, so the observed public Edge 400 is consistent with stale deployed code.
+- Verification evidence carried forward:
+  - TEST-1 preflight passed on runner: clean `main...origin/main`, `python3` and `curl` present, secret file readable without printing the secret, Spark01/Spark02 `/health` and `/v1/models` passed, public Edge `/v1/models` auth passed.
+  - TEST-2 gate remains unmet because all three cases must be `ok:true`; the IOP public case is still `ok:false`.
+- Roadmap carryover:
+  - Continue claiming only `devcorp-smoke`; do not mark roadmap completion unless the final TEST-2 smoke exits 0 with `iop_public_ornith` included.
+- Narrow archive reread allowed if exact prior stdout is needed:
+  - `agent-task/m-openai-compatible-provider-passthrough-contract-sync/plan_cloud_G07_0.log`
+  - `agent-task/m-openai-compatible-provider-passthrough-contract-sync/code_review_cloud_G07_0.log`
+
+## 분석 결과
+
+### 읽을 파일
+
+- `agent-ops/skills/project/dev-corp-runtime-deploy/SKILL.md`
+- `agent-test/dev-corp/rules.md`
+- `agent-test/dev-corp/inventory.yaml`
+- `agent-test/dev-corp/edge-smoke.md`
+- `agent-test/dev-corp/node-smoke.md`
+- `agent-ops/rules/project/domain/testing/rules.md`
+- `agent-ops/rules/project/domain/edge/rules.md`
+- `agent-ops/rules/project/domain/node/rules.md`
+- `agent-roadmap/phase/routing-policy-model-orchestration/milestones/openai-compatible-provider-passthrough-contract-sync.md`
+- `agent-roadmap/sdd/routing-policy-model-orchestration/openai-compatible-provider-passthrough-contract-sync/SDD.md`
+- `agent-contract/outer/openai-compatible-api.md`
+- `agent-contract/inner/edge-node-runtime-wire.md`
+
+### SDD 기준
+
+- SDD `S10`은 Milestone Task `devcorp-smoke`와 연결되어 있다.
+- Required Evidence는 dev-corp single-call smoke output summary이며, `devcorp-smoke`, first content latency, reasoning/content observation이 `Roadmap Completion`에서 확인 가능해야 한다.
+- 이번 follow-up은 stale 배포를 현재 source로 맞춘 뒤 S10 evidence를 다시 수집하는 작업이다.
+
+### 범위 결정 근거
+
+- 포함: dev-corp runner clean sync, passthrough 포함 ref 확인, Go pre-build test, dev-corp runtime rebuild/redeploy, public Edge/Node runtime parity 확인, 동일 TEST-2 think-off smoke 재실행.
+- 제외: provider runtime option 튜닝, capacity 9/6 부하 smoke, `/v1/responses` 검증, 로드맵 직접 수정, archive 문서 재작성.
+- source code 변경은 기본적으로 기대하지 않는다. 배포 절차 중 빌드 스크립트/설정 결함이 새로 발견되면 그 결함과 최소 수정 필요성을 `CODE_REVIEW`에 기록한다.
+
+### 빌드 등급
+
+- `cloud-G07`: 외부 runner, public Edge, provider node, runtime deploy parity와 secret-safe smoke가 중심이다.
+
+## 구현 체크리스트
+
+- [ ] REVIEW_TEST-1 dev-corp runtime을 passthrough 포함 source ref로 clean sync, test, rebuild, redeploy하고 source/build/deploy parity evidence를 `CODE_REVIEW-cloud-G07.md`에 기록한다.
+- [ ] REVIEW_TEST-2 redeploy 후 동일 `chat_template_kwargs.enable_thinking=false` TEST-2 smoke를 실행해 direct Spark01, direct Spark02, IOP public Ornith 세 case가 모두 `ok:true`인지 기록한다.
+- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.
+
+### [REVIEW_TEST-1] Dev-Corp Runtime Parity Deploy
+
+#### 문제
+
+현재 public IOP Edge는 `chat_template_kwargs`를 unsupported field로 거부한다. 이전 루프와 리뷰 재검증 모두 remote runner checkout HEAD가 `10ede93`인 상태를 확인했으며, 이 ref는 passthrough 구현 커밋 이전이다. S10을 닫으려면 public Edge/Node runtime이 passthrough 포함 source로 맞아야 한다.
+
+#### 해결 방법
+
+`agent-ops/skills/project/dev-corp-runtime-deploy/SKILL.md`의 절차를 따른다.
+
+Spark direct/provider 확인은 반드시 mac-mini runner `ssh fe@172.24.63.178` 안에서 수행한다. 현재 작업 머신에서 `192.168.2.x` Spark endpoint를 직접 치는 경로는 기준 경로가 아니며, public Edge 검증도 mac-mini local endpoint가 아니라 `https://digitalplatform.iop.ai.kr/v1`을 사용한다.
+
+필수 최소 evidence:
+
+```bash
+ssh fe@172.24.63.178 'cd /Users/fe/agent-work/iop-dev-corp && git fetch origin main && git reset --hard origin/main && git clean -fd && git status --short --branch && git log --oneline -5 && git merge-base --is-ancestor 5cd7aea HEAD && git merge-base --is-ancestor 33f8f5e HEAD && git show HEAD:apps/edge/internal/openai/chat_handler.go | grep chat_template_kwargs'
+```
+
+배포 전 provider direct preflight:
+
+```bash
+ssh fe@172.24.63.178 'set -e
+curl -fsS http://192.168.2.2:8003/health
+curl -fsS http://192.168.2.2:8003/v1/models
+curl -fsS http://192.168.2.4:8005/health
+curl -fsS http://192.168.2.4:8005/v1/models
+curl -fsS http://192.168.2.3:8004/health
+curl -fsS http://192.168.2.3:8004/v1/models
+'
+```
+
+빌드 전 테스트:
+
+```bash
+ssh fe@172.24.63.178 'cd /Users/fe/agent-work/iop-dev-corp && go test ./...'
+```
+
+그 다음 같은 source ref에서 dev-corp Control Plane, public Edge, macOS Node, Linux ARM64 Node binary를 rebuild/redeploy한다. public Edge runtime은 `iop.ai.kr` 경로를 기준으로 하고, Node `edge_addr`는 `iop.ai.kr:18087`이어야 한다. mac-mini local endpoint를 public Edge evidence로 쓰지 않는다.
+
+#### 수정 파일 및 체크리스트
+
+- [ ] remote runner checkout이 passthrough 포함 source ref로 clean sync됐다.
+- [ ] pre-build `go test ./...` 결과를 기록했다.
+- [ ] Edge/Node binaries가 같은 source ref에서 rebuild/redeploy됐다.
+- [ ] public `/v1/models`와 Node/provider 연결 상태를 secret 원문 없이 기록했다.
+
+#### 테스트 작성
+
+별도 unit test 작성 없음. 이미 로컬 소스에는 provider-native preservation unit test가 존재하며, 이 plan은 dev-corp runtime parity와 field evidence를 채운다.
+
+#### 중간 검증
+
+배포 후 public Edge `/v1/models`가 `ornith:35b`를 노출하고, stale 400 재현 원인이었던 deployed source/binary parity가 해소됐음을 기록한다.
+
+### [REVIEW_TEST-2] Think-Off Field Smoke Re-run
+
+#### 문제
+
+이전 TEST-2는 direct Spark 두 case만 통과했고, S10의 핵심인 IOP public Ornith case가 실패했다.
+
+#### 해결 방법
+
+redeploy 후 runner에서 동일 payload/cases로 smoke를 실행한다. 출력에는 secret 원문이 없어야 한다.
+
+```bash
+ssh fe@172.24.63.178 'cd /Users/fe/agent-work/iop-dev-corp && OPENAI_API_KEY="$(cat build/dev-corp-runtime/.secrets/openai_api_key)" python3 - <<'"'"'PY'"'"'
+import json
+import os
+import time
+import urllib.error
+import urllib.request
+
+payload = {
+    "model": "ornith:35b",
+    "messages": [{"role": "user", "content": "Reply with one short sentence and do not include reasoning."}],
+    "stream": True,
+    "temperature": 0,
+    "max_tokens": 64,
+    "chat_template_kwargs": {"enable_thinking": False},
+}
+
+cases = [
+    ("direct_spark01", "http://192.168.2.2:8003/v1/chat/completions", {}),
+    ("direct_spark02", "http://192.168.2.4:8005/v1/chat/completions", {}),
+    ("iop_public_ornith", "https://digitalplatform.iop.ai.kr/v1/chat/completions", {"Authorization": "Bearer " + os.environ["OPENAI_API_KEY"]}),
+]
+
+def run_case(name, url, headers):
+    req_headers = {"Content-Type": "application/json"}
+    req_headers.update(headers)
+    req = urllib.request.Request(url, data=json.dumps(payload).encode("utf-8"), headers=req_headers, method="POST")
+    started = time.monotonic()
+    content = []
+    reasoning_seen = False
+    first_content_sec = None
+    status = None
+    try:
+        with urllib.request.urlopen(req, timeout=180) as resp:
+            status = resp.status
+            for raw in resp:
+                line = raw.decode("utf-8", "replace").strip()
+                if not line.startswith("data: "):
+                    continue
+                data = line[6:]
+                if data == "[DONE]":
+                    break
+                obj = json.loads(data)
+                for choice in obj.get("choices", []):
+                    delta = choice.get("delta") or {}
+                    if delta.get("reasoning_content") or delta.get("reasoning") or delta.get("reasoning_text"):
+                        reasoning_seen = True
+                    piece = delta.get("content")
+                    if piece:
+                        if first_content_sec is None:
+                            first_content_sec = round(time.monotonic() - started, 3)
+                        content.append(piece)
+    except urllib.error.HTTPError as exc:
+        body = exc.read().decode("utf-8", "replace")
+        return {"name": name, "ok": False, "status": exc.code, "error_body": body[:500]}
+    except Exception as exc:
+        return {"name": name, "ok": False, "error": repr(exc)}
+    text = "".join(content).strip()
+    return {
+        "name": name,
+        "ok": status == 200 and first_content_sec is not None and not reasoning_seen,
+        "status": status,
+        "first_content_sec": first_content_sec,
+        "reasoning_seen": reasoning_seen,
+        "content_preview": text[:200],
+    }
+
+results = [run_case(*case) for case in cases]
+print(json.dumps({"payload": {"model": payload["model"], "chat_template_kwargs": payload["chat_template_kwargs"]}, "results": results}, ensure_ascii=False, indent=2))
+if not all(item.get("ok") for item in results):
+    raise SystemExit(1)
+PY'
+```
+
+#### 수정 파일 및 체크리스트
+
+- [ ] direct Spark01/Spark02 결과와 IOP public Ornith 결과를 `CODE_REVIEW-cloud-G07.md`에 기록한다.
+- [ ] 세 case 모두 `ok:true`, `reasoning_seen:false`, `first_content_sec` 값을 가진다.
+- [ ] 실패 시 HTTP status/body, 배포 ref, Edge/Node parity, provider direct 상태를 분리 기록한다.
+
+#### 테스트 작성
+
+별도 unit test 작성 없음. S10은 live dev-corp field smoke evidence가 테스트다.
+
+#### 중간 검증
+
+Python smoke command가 exit 0이어야 한다.
+
+## 수정 파일 요약
+
+| 파일 | 항목 |
+|------|------|
+| `agent-task/m-openai-compatible-provider-passthrough-contract-sync/CODE_REVIEW-cloud-G07.md` | 구현 에이전트가 배포/검증 출력과 판단을 기록한다. |
+| source files | 기본적으로 수정 없음. 배포 절차 결함을 고치는 경우에만 최소 변경하고 근거를 기록한다. |
+
+## 최종 검증
+
+- REVIEW_TEST-1 deploy parity evidence가 있어야 한다.
+- REVIEW_TEST-2 smoke command가 exit 0이어야 한다.
+- `iop_public_ornith`가 `ok:true`, `status:200`, `reasoning_seen:false`, `first_content_sec` 값을 가져야 한다.
+
+모든 작업 후 반드시 `CODE_REVIEW-*-G??.md`의 구현 에이전트 소유 섹션을 채운다. 이 파일 작성이 구현의 마지막 단계다.