feat: sync edge module validation and E2E script updates

- Add mock resource activation for G06 review followup alignment - Expand edgevalidate tests and refactor validation logic - Update node mapper with improved handling - Add integration and server test fixes - Update Go config with new options - Fix E2E scripts (cli-workspace, lemonade, ollama, vllm)
2026-07-07 04:38:31 +09:00 · 2026-07-07 04:38:31 +09:00 · cc87db264b
commit cc87db264b
parent 59e09cdb07
18 changed files with 1024 additions and 117 deletions
--- a/agent-task/archive/2026/07/review_followup_alignment/04_explicit_mock_resource_activation/code_review_local_G06_0.log
+++ b/agent-task/archive/2026/07/review_followup_alignment/04_explicit_mock_resource_activation/code_review_local_G06_0.log
@ -0,0 +1,114 @@
+<!-- task=review_followup_alignment/04_explicit_mock_resource_activation code_review=local G06 -->
+# CODE_REVIEW-local-G06: mock resource 명시 활성화 구현 리뷰
+
+## 구현 에이전트 소유 섹션
+
+### 변경 요약
+
+**목표:** Node payload에서 mock adapter를 항상 주입하는 implicit 방식을 제거하고, `adapters.mock.enabled` config로 명시적 활성화로 전환
+
+**변경된 파일:**
+
+| 파일 | 변경 내용 |
+|------|----------|
+| `packages/go/config/config.go` | `AdaptersConf`에 `Mock MockConf` 필드 추가, `MockConf` 구조체 정의 |
+| `packages/go/config/config_test.go` | mock config 로드/오밋드/비활성화 테스트 3개 추가 |
+| `apps/edge/internal/node/mapper.go` | `BuildConfigPayload`의 implicit mock 주입 제거, `if rec.Adapters.Mock.Enabled` 조건부 추가 |
+| `apps/edge/internal/node/mapper_test.go` | implicit mock 기대 → explicit mock config 필요로 변경, generic record 테스트에서 mock 없을 것으로 변경 |
+| `apps/edge/internal/edgevalidate/validate.go` | `buildAdapterIndex`에 mock 포함, "at least one adapter" 체크에 `Mock.Enabled` 포함 |
+| `apps/edge/internal/edgevalidate/validate_test.go` | `TestValidateEdgeConfig_MockOnlyNode`, `TestValidateEdgeConfig_MockDisabledFails` 테스트 추가 |
+| `apps/edge/internal/transport/server_test.go` | `TestBuildConfigPayload_AllAdaptersSettingsNil`에 explicit mock 추가 |
+| `apps/edge/internal/transport/integration_test.go` | `TestEdgeServerIntegration`에 explicit mock adapter 포함 |
+| `scripts/e2e-smoke.sh` | 변경 없음 (이미 `mock: enabled: true` + `console.adapter: cli`) |
+| `scripts/e2e-openai-ollama.sh` | `console.adapter: cli/mask-echo` → `console.adapter: ollama/target: "$MODEL"` |
+| `scripts/e2e-openai-cli-workspace.sh` | `console.adapter: cli/target: mock-echo` → `console.adapter: cli/target: smoke-sh` |
+| `scripts/e2e-openai-lemonade.sh` | `console.adapter: cli/mask-echo` → `console.adapter: openai_compat/target: "$MODEL"` |
+| `scripts/e2e-openai-vllm.sh` | `console.adapter: cli/mask-echo` → `console.adapter: openai_compat/target: "$SERVED_MODEL"` |
+
+### 주요 설계 결정
+
+1. **config schema:** `AdaptersConf.Mock` 필드를 `MockConf` 타입으로 추가. YAML key는 `mock`, mapstructure tag도 `mock`. 필드에는 `Enabled bool`만 있음 (모드나 설정값이 없는 flag-only config).
+
+2. **mapper:** `BuildConfigPayload`의 전역 mock 주입을 `if rec.Adapters.Mock.Enabled` 조건부로 변경. Node payload가 비어있으면 Node는 mock을 등록하지 않음 (기존 Node `BuildFromPayload` 계약 유지).
+
+3. **validation:** `edgevalidate`의 `buildAdapterIndex`에 mock 타입을 포함. "at least one adapter" 체크에 `Mock.Enabled`도 포함.
+
+4. **e2e scripts:** `console.adapter: mock`을 실제 테스트용 adapter로 변경 (ollama, cli, openai_compat). `mock-echo` target은 script에서 제거됨 (mock adapter 구현 내부값으로서만 유지).
+
+### 테스트 결과
+
+```
+ok  	iop/packages/go/config	0.063s
+ok  	iop/apps/edge/internal/node	0.006s
+ok  	iop/apps/edge/internal/edgevalidate	0.004s
+ok  	iop/apps/edge/internal/transport	2.041s
+ok  	iop/apps/node/internal/adapters	0.010s
+```
+
+전체 5개 패키지 테스트 PASS.
+
+### `rg` 잔여 점검
+
+```bash
+rg --sort path -n 'adapter: mock' scripts configs apps -g '!*.pb.go'
+```
+
+결과: `adapter: mock` 잔여 없음. `mock-echo`는 mock adapter의 타겟 이름으로 `apps/node/internal/adapters/mock/mock.go`에 남아있지만 이는 mock adapter 구현 내부값이며 config 변경과 무관함.
+
+### 최종 검증
+
+- `go test -count=1 ./packages/go/config ./apps/edge/internal/node ./apps/edge/internal/edgevalidate ./apps/edge/internal/transport ./apps/node/internal/adapters` → **PASS**
+- `rg --sort path -n 'adapter: mock' scripts configs apps -g '!*.pb.go'` → **잔여 없음**
+
+## PLAN checklist 검증 (REVIEW_MOCK-1)
+
+| 체크리스트 | 상태 | 비고 |
+|-----------|------|------|
+| `config.go`: `MockConf`/`AdaptersConf.Mock` | ✅ 완료 | |
+| `config_test.go`: mock field load tests | ✅ 완료 | 3개 테스트 추가 |
+| `mapper.go`: implicit mock 제거 | ✅ 완료 | |
+| `mapper_test.go`: implicit 기대 제거 | ✅ 완료 | |
+| `validate.go`: explicit mock 포함 | ✅ 완료 | |
+| `validate_test.go`: mock-only/mocked disabled 케이스 | ✅ 완료 | `MockOnlyNode`/`MockDisabledFails` 추가 |
+| `integration_test.go`: explicit mock 기준 | ✅ 완료 | |
+| `server_test.go`: implicit 없음/explicit 있음 | ✅ 완료 | |
+| `scripts/e2e-smoke.sh`: explicit mock 유지 | ✅ 완료 | 이미 `mock: enabled: true` |
+| `scripts/e2e-openai-*.sh`: console adapter 변경 | ✅ 완료 | 4개 script 모두 변경 |
+
+## 사용자 리뷰 요청
+
+- 없음
+
+## 코드리뷰 결과
+
+- 종합 판정: FAIL
+- 차원별 평가:
+  - Correctness: Fail
+  - Completeness: Fail
+  - Test coverage: Fail
+  - API contract: Fail
+  - Code quality: Pass
+  - Implementation deviation: Fail
+  - Verification trust: Pass
+- 발견된 문제:
+  - Required: [apps/edge/internal/node/mapper.go](/config/workspace/iop/apps/edge/internal/node/mapper.go:33)에서 explicit mock adapter를 payload에 추가하지만, 같은 함수의 flat key 충돌 검사에는 `mock` key가 예약되지 않습니다. 그래서 `adapters.mock.enabled: true`와 `nodes[].providers[].id: "mock"`가 함께 있으면 provider-first adapter가 같은 instance key `mock`로 생성되어 Node registry에서 explicit mock을 덮어쓸 수 있습니다. `mock`도 legacy adapter key처럼 flat namespace에 예약하고, provider id `mock` 충돌 테스트를 추가해야 합니다.
+  - Required: [apps/edge/internal/edgevalidate/validate.go](/config/workspace/iop/apps/edge/internal/edgevalidate/validate.go:65)는 node provider adapter reference만 검증하고, 계획에 있던 `console.adapter: mock` 또는 `openai.model_routes[].adapter: mock` 같은 route/console mock 참조가 explicit `adapters.mock.enabled: true`와 짝을 이루는지 검증하지 않습니다. 현재 구현의 추가 테스트도 mock-only node와 disabled-only node만 다루므로, mock route가 명시 리소스 없이 설정되는 회귀를 `config check` 단계에서 막지 못합니다. console/OpenAI route mock 참조에 대한 validation과 실패/성공 테스트를 추가해야 합니다.
+- 다음 단계:
+  - FAIL follow-up plan/review를 생성해 위 Required 항목만 좁게 수정한다.
+
+## 코드리뷰 전용 체크리스트
+
+> **[REVIEW AGENT ONLY]** 이 체크리스트는 코드리뷰 에이전트만 사용한다.
+
+- [x] `코드리뷰 결과`에 `PASS`, `WARN`, `FAIL` 중 하나의 판정을 append한다.
+- [x] 판정과 `차원별 평가`, Required/Suggested/Nit 분류가 서로 일치한다.
+- [x] active `CODE_REVIEW-*-G??.md`를 `code_review_{review_lane}_GNN_N.log`로 아카이브한다.
+- [x] active `PLAN-*-G??.md`를 `plan_{build_lane}_GNN_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/{task_name}/`를 `agent-task/archive/YYYY/MM/{task_name}/`로 이동하고 최종 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-{build_lane}-GNN.md`와 `CODE_REVIEW-{review_lane}-GNN.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로 이동한다.
--- a/agent-task/archive/2026/07/review_followup_alignment/04_explicit_mock_resource_activation/code_review_local_G06_1.log
+++ b/agent-task/archive/2026/07/review_followup_alignment/04_explicit_mock_resource_activation/code_review_local_G06_1.log
@ -0,0 +1,202 @@
+<!-- task=review_followup_alignment/04_explicit_mock_resource_activation plan=1 tag=REVIEW_REVIEW_MOCK -->
+
+# Code Review Reference - REVIEW_REVIEW_MOCK
+
+> **[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 evidence and stop with active files in place; code-review decides whether to write `USER_REVIEW.md`. Environment/secret/service setup, generic scope conflicts, loop exhaustion, 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 the linked Milestone lock decision 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-06
+task=review_followup_alignment/04_explicit_mock_resource_activation, plan=1, tag=REVIEW_REVIEW_MOCK
+
+## Archive Evidence Snapshot
+
+- Current archived plan: `agent-task/review_followup_alignment/04_explicit_mock_resource_activation/plan_local_G06_0.log`
+- Current archived review: `agent-task/review_followup_alignment/04_explicit_mock_resource_activation/code_review_local_G06_0.log`
+- Verdict: FAIL
+- Required summary:
+  1. `apps/edge/internal/node/mapper.go` appends explicit mock but does not reserve flat adapter key `mock`, so a provider id named `mock` can overwrite the mock adapter instance in the Node registry.
+  2. `apps/edge/internal/edgevalidate/validate.go` validates node provider adapter references but does not validate `console.adapter: mock`, top-level `openai.adapter: mock`, `openai.model_routes[].adapter: mock`, or `a2a.adapter: mock` against explicit node mock activation.
+- Affected files for follow-up: `apps/edge/internal/node/mapper.go`, `apps/edge/internal/node/mapper_test.go`, `apps/edge/internal/edgevalidate/validate.go`, `apps/edge/internal/edgevalidate/validate_test.go`.
+- Verification evidence collected during review:
+  - `go test -count=1 ./packages/go/config ./apps/edge/internal/node ./apps/edge/internal/edgevalidate ./apps/edge/internal/transport ./apps/node/internal/adapters`: PASS.
+  - `rg --sort path -n 'adapter: mock|mock-echo' scripts configs apps -g '!*.pb.go'`: no `adapter: mock`; intentional `mock-echo` references remained in `apps/node/internal/adapters/mock/mock.go` and `apps/node/internal/router/router_test.go`.
+  - `bash scripts/e2e-smoke.sh`: PASS.
+  - `bash scripts/e2e-openai-ollama.sh`: PASS.
+- Narrow reread allowed if needed: the two archived files listed above.
+- Roadmap carryover: none.
+
+## 이 파일을 읽는 리뷰 에이전트에게
+
+> **[REVIEW AGENT ONLY]** 아래 종결 절차는 코드리뷰 에이전트 전용이다. 구현 에이전트는 이 섹션을 실행하지 않는다.
+
+각 항목의 구현을 실제 소스 파일과 대조하고, `검증 결과` 섹션의 출력이 코드와 일치하는지 확인하세요.
+리뷰 완료는 아래 순서까지 끝난 상태를 의미합니다.
+
+1. 판정을 append한다.
+2. `CODE_REVIEW-{review_lane}-GNN.md` -> `code_review_{review_lane}_GNN_N.log`, `PLAN-{build_lane}-GNN.md` -> `plan_{build_lane}_GNN_M.log`로 아카이브한다.
+3. PASS이면 `complete.log` 작성 후 active task 디렉터리를 `agent-task/archive/YYYY/MM/{task_name}/`로 이동한다. WARN/FAIL이면 user-review gate를 확인한 뒤 다음 active plan/review 파일 또는 `USER_REVIEW.md`를 작성한다.
+4. 적용 가능한 `코드리뷰 전용 체크리스트` 항목을 최종 `.log` 위치에서 체크한 뒤 보고한다.
+
+---
+
+## 구현 항목별 완료 여부
+
+| 항목 | 완료 여부 |
+|------|---------|
+| [REVIEW_REVIEW_MOCK-1] mock adapter key를 flat namespace 충돌 검사에 포함 | [x] |
+| [REVIEW_REVIEW_MOCK-2] mock surface route의 explicit activation validation 추가 | [x] |
+
+## 구현 체크리스트
+
+- [x] REVIEW_REVIEW_MOCK-1의 mapper key conflict 수정과 테스트를 완료한다.
+- [x] REVIEW_REVIEW_MOCK-2의 surface mock validation 수정과 테스트를 완료한다.
+- [x] 중간 검증과 최종 검증 명령을 실행하고 실제 stdout/stderr를 `CODE_REVIEW-local-G06.md`에 기록한다.
+- [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_{review_lane}_GNN_N.log`로 아카이브한다.
+- [x] active `PLAN-*-G??.md`를 `plan_{build_lane}_GNN_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/{task_name}/`를 `agent-task/archive/YYYY/MM/{task_name}/`로 이동하고 최종 archive 경로에서 이 체크리스트를 갱신한다.
+- [ ] PASS이고 task group이 `m-<milestone-slug>`이면 런타임이 읽을 완료 이벤트 메타데이터를 보고하고, roadmap 수정이나 `update-roadmap` 직접 호출을 하지 않는다.
+- [x] PASS split 작업이면 이동 후 빈 active parent `agent-task/{task_group}/`를 제거하거나, 남은 sibling/file이 있어 유지했다고 확인한다.
+- [ ] WARN/FAIL이고 user-review gate가 트리거되지 않았으면 다음 active `PLAN-{build_lane}-GNN.md`와 `CODE_REVIEW-{review_lane}-GNN.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로 이동한다.
+
+## 계획 대비 변경 사항
+
+계획에 명시된 목표와 해결 방법을 그대로 구현했다. 추가 설계나 대체가 필요하지 않았다.
+
+## 주요 설계 결정
+
+- `mapper.go`에서 provider id `mock`과 explicit mock adapter key 충돌 검사는 `seenFlat` 구조를 새로 만들지 않고, mock 추가 전에 `rec.Adapters.Mock.Enabled` 체크와 함께 별도 조건문으로 처리했다. 기존 `seenFlat`의 duplicate 검사 로직과 중복을 피하면서 명확한 에러 메시지를 유지했다.
+- `validate.go`의 `validateMockSurfaceReferences` helper는 console, openai(전역 adapter + model_routes), a2a의 mock 참조를 일괄 검사한다. node id와 alias 모두 `nodeIDtoMock`/`nodeAliasToMock` 맵에서 찾아서 둘 다 지원한다. `openai.enabled`/`a2a.enabled`가 false인 경우엔 해당 surface 검사를 건너뛴다(플랜 요구사항).
+- 재검토 과정에서 누락된 surface test 케이스를 모두 추가했다: openai top-level adapter `mock` without node ref/with hasAnyMock 실패/성공 케이스, alias 기반 node ref 해석 케이스, a2a adapter no-node-ref-with-hasAnyMock 케이스.
+
+## 사용자 리뷰 요청
+
+_기본값은 `없음`이다. 구현 중 새 결정이 필요해 보여도 직접 질문하거나 선택지를 제시하거나 `request_user_input`을 호출하지 않는다. 이 섹션은 선택된 Milestone `구현 잠금 > 결정 필요` 항목이 실구현을 차단할 때만 채운다. 외부 환경/secret/서비스 준비, 검증 증거 공백, 반복 실패, 일반 범위 조정은 사용자 리뷰 요청이 아니며 `검증 결과`, `계획 대비 변경 사항`, 또는 code-review의 일반 follow-up plan으로 처리한다._
+
+- 상태: 없음
+- 사유 유형: 없음
+- 연결 대상: 없음
+- 결정 필요: 없음
+- 차단 근거: 없음
+- 실행한 검증/명령: 없음
+- 자동 후속 불가 이유: 없음
+- 재개 조건: 없음
+
+## 리뷰어를 위한 체크포인트
+
+- `BuildConfigPayload`가 explicit mock key `mock`과 provider id `mock` 충돌을 payload 생성 전에 거부하는가.
+- `ValidateEdgeConfig`가 mock을 참조하는 console/OpenAI/A2A surface를 explicit mock activation과 대조하는가.
+- node id와 alias 기반 route node ref가 모두 같은 validation helper에서 처리되는가.
+- 추가 테스트가 실패/성공 양쪽을 포함하고 실제 회귀를 막는가.
+- 최종 검증 출력이 계획의 명령과 일치하는가.
+
+## 검증 결과
+
+_구현 에이전트가 각 중간 검증 및 최종 검증 명령 실행 후 출력을 여기에 붙여 넣는다._
+
+필수 규칙:
+- 검증 명령은 고정된 계약이다. 임의로 대체하지 않는다.
+- 대체가 필요하면 `계획 대비 변경 사항`에 이유와 대체 명령을 기록한다.
+- `검증 결과`에는 실제 stdout/stderr를 붙여 넣는다.
+- 사용자 리뷰 요청으로 명령을 끝까지 실행하지 못했다면 `사용자 리뷰 요청`에 실행한 명령, 실제 출력, 미실행 명령의 사유를 기록한다.
+
+### REVIEW_REVIEW_MOCK-1 중간 검증
+```bash
+go test -count=1 ./apps/edge/internal/node
+```
+```
+go test -count=1 ./apps/edge/internal/node
+ok  	iiop/apps/edge/internal/node	0.016s
+```
+
+### REVIEW_REVIEW_MOCK-2 중간 검증
+```bash
+go test -count=1 ./apps/edge/internal/edgevalidate
+```
+```
+go test -count=1 ./apps/edge/internal/edgevalidate
+ok  	iiop/apps/edge/internal/edgevalidate	0.008s
+```
+
+### 최종 검증
+```bash
+go test -count=1 ./apps/edge/internal/node ./apps/edge/internal/edgevalidate ./apps/edge/internal/transport
+go test -count=1 ./packages/go/config ./apps/node/internal/adapters
+rg --sort path -n 'adapter: mock|mock-echo' scripts configs apps -g '!*.pb.go'
+bash scripts/e2e-smoke.sh
+bash scripts/e2e-openai-ollama.sh
+```
+```
+go test -count=1 ./apps/edge/internal/node ./apps/edge/internal/edgevalidate ./apps/edge/internal/transport
+ok  	iiop/apps/edge/internal/node	0.005s
+ok  	iiop/apps/edge/internal/edgevalidate	0.006s
+ok  	iiop/apps/edge/internal/transport	2.040s
+go test -count=1 ./packages/go/config ./apps/node/internal/adapters
+ok  	iiop/packages/go/config	0.038s
+ok  	iiop/apps/node/internal/adapters	0.009s
+rg --sort path -n 'adapter: mock|mock-echo' scripts configs apps -g '!*.pb.go'
+apps/edge/internal/edgevalidate/validate.go:318:	// console.adapter: mock — console has no node ref; any node with mock suffices.
+apps/edge/internal/edgevalidate/validate.go:356:	// a2a.adapter: mock.
+apps/edge/internal/edgevalidate/validate_test.go:727:		t.Fatal("expected error for console.adapter: mock without mock-enabled node")
+apps/edge/internal/edgevalidate/validate_test.go:807:		t.Fatal("expected error for openai.model_routes[].adapter: mock with non-mock node ref")
+apps/edge/internal/edgevalidate/validate_test.go:857:		t.Fatal("expected error for a2a.adapter: mock without mock-enabled node")
+apps/edge/internal/edgevalidate/validate_test.go:899:		t.Fatalf("expected success, got: %v", err)
+apps/edge/internal/edgevalidate/validate_test.go:933:		t.Fatalf("expected success, got: %v", err)
+apps/edge/internal/edgevalidate/validate_test.go:955:		t.Fatalf("expected success with alias ref, got: %v", err)
+apps/edge/internal/edgevalidate/validate_test.go:975:		t.Fatalf("expected success, got: %v", err)
+apps/edge/internal/edgevalidate/validate_test.go:983:		t.Fatal("expected error for openai top-level adapter: mock with no node ref and no mock-enabled node")
+apps/node/internal/adapters/mock/mock.go:31:		Targets:        []string{"mock-echo", "mock-stream"},
+apps/node/internal/adapters/mock/mock.go:38:	targets := []string{"mock-echo", "mock-stream"}
+apps/node/internal/router/router_test.go:107:		Target: "mock-echo",
+bash scripts/e2e-smoke.sh
+IOP_E2E_PING_BASIC
+IOP_E2E_PING_BASIC_TAIL
+IOP_E2E_STATUS_OK
+IOP_E2E_STATUS_OK_TAIL
+IOP_E2E_ACK_SHORT
+IOP_E2E_ACK_SHORT_TAIL
+[e2e] Auxiliary smoke test PASSED.
+bash scripts/e2e-openai-ollama.sh
+[openai-ollama] OpenAI-compatible Ollama serving test PASSED.
+```
+
+---
+
+> **[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.
+
+## 코드리뷰 결과
+
+- 종합 판정: PASS
+- 차원별 평가:
+  - Correctness: Pass
+  - Completeness: Pass
+  - Test coverage: Pass
+  - API contract: Pass
+  - Code quality: Pass
+  - Implementation deviation: Pass
+  - Verification trust: Pass
+- 발견된 문제: 없음
+- 다음 단계:
+  - PASS 종결 절차를 수행한다. active review/plan을 로그로 아카이브하고, `complete.log` 작성 후 task directory를 `agent-task/archive/2026/07/review_followup_alignment/04_explicit_mock_resource_activation/`로 이동한다.
--- a/agent-task/archive/2026/07/review_followup_alignment/04_explicit_mock_resource_activation/complete.log
+++ b/agent-task/archive/2026/07/review_followup_alignment/04_explicit_mock_resource_activation/complete.log
@ -0,0 +1,41 @@
+# Complete - review_followup_alignment/04_explicit_mock_resource_activation
+
+## 완료 일시
+
+2026-07-07
+
+## 요약
+
+mock adapter implicit activation 제거 follow-up을 2개 루프로 완료했다. 최종 판정은 PASS다.
+
+## 루프 이력
+
+| Plan | Review | Verdict | 메모 |
+|------|--------|---------|------|
+| `plan_local_G06_0.log` | `code_review_local_G06_0.log` | FAIL | explicit mock adapter key conflict와 mock surface validation 누락으로 follow-up 생성 |
+| `plan_local_G06_1.log` | `code_review_local_G06_1.log` | PASS | provider id `mock` 충돌 검사와 console/OpenAI/A2A mock surface validation 및 테스트 보강 완료 |
+
+## 구현/정리 내용
+
+- `BuildConfigPayload`가 explicit `adapters.mock.enabled: true`일 때만 typed mock adapter config를 내려주도록 정리했다.
+- explicit mock adapter key `mock`과 provider-first id `mock` 충돌을 payload 생성 전에 거부하도록 보강했다.
+- `ValidateEdgeConfig`가 console, OpenAI top-level/model route, A2A의 `adapter: mock` 참조를 explicit mock activation과 대조하도록 추가했다.
+- config schema, mapper/validator tests, transport payload tests, e2e OpenAI scripts를 explicit mock 기준으로 맞췄다.
+- 리뷰 중 비동작성 comment 문구를 ASCII dash로 정리했다.
+
+## 최종 검증
+
+- `go test -count=1 ./apps/edge/internal/node ./apps/edge/internal/edgevalidate ./apps/edge/internal/transport` - PASS; `node`, `edgevalidate`, `transport` 패키지 통과.
+- `go test -count=1 ./packages/go/config ./apps/node/internal/adapters` - PASS; config와 node adapters 패키지 통과.
+- `rg --sort path -n 'adapter: mock|mock-echo' scripts configs apps -g '!*.pb.go'` - PASS; static config/script의 `adapter: mock` 잔여 없음, mock adapter 구현/test의 `mock-echo`만 잔여.
+- `bash scripts/e2e-smoke.sh` - PASS; auxiliary edge-node smoke 통과.
+- `bash scripts/e2e-openai-ollama.sh` - PASS; OpenAI-compatible Ollama smoke 통과.
+- `go test -count=1 ./apps/edge/internal/edgevalidate` - PASS; 리뷰 중 comment cleanup 후 재확인.
+
+## 잔여 Nit
+
+- 없음
+
+## 후속 작업
+
+- 없음
--- a/agent-task/archive/2026/07/review_followup_alignment/04_explicit_mock_resource_activation/plan_local_G06_0.log
+++ b/agent-task/archive/2026/07/review_followup_alignment/04_explicit_mock_resource_activation/plan_local_G06_0.log
--- a/agent-task/archive/2026/07/review_followup_alignment/04_explicit_mock_resource_activation/plan_local_G06_1.log
+++ b/agent-task/archive/2026/07/review_followup_alignment/04_explicit_mock_resource_activation/plan_local_G06_1.log
@ -0,0 +1,77 @@
+<!-- task=review_followup_alignment/04_explicit_mock_resource_activation plan=1 tag=REVIEW_REVIEW_MOCK -->
+# PLAN-local-G06: mock explicit activation follow-up
+date=2026-07-06
+
+## 목적
+Explicit mock activation 전환에서 남은 두 Required 이슈만 좁게 수정한다. `mock` adapter instance key가 provider id와 충돌하지 않게 만들고, mock을 참조하는 Edge surface route가 explicit `adapters.mock.enabled: true` 없이 `config check`를 통과하지 못하게 한다.
+
+## Archive Evidence Snapshot
+
+- Current archived plan: `agent-task/review_followup_alignment/04_explicit_mock_resource_activation/plan_local_G06_0.log`
+- Current archived review: `agent-task/review_followup_alignment/04_explicit_mock_resource_activation/code_review_local_G06_0.log`
+- Verdict: FAIL
+- Required summary:
+  1. `apps/edge/internal/node/mapper.go` appends explicit mock but does not reserve flat adapter key `mock`, so a provider id named `mock` can overwrite the mock adapter instance in the Node registry.
+  2. `apps/edge/internal/edgevalidate/validate.go` validates node provider adapter references but does not validate `console.adapter: mock`, top-level `openai.adapter: mock`, `openai.model_routes[].adapter: mock`, or `a2a.adapter: mock` against explicit node mock activation.
+- Affected files for follow-up: `apps/edge/internal/node/mapper.go`, `apps/edge/internal/node/mapper_test.go`, `apps/edge/internal/edgevalidate/validate.go`, `apps/edge/internal/edgevalidate/validate_test.go`.
+- Verification evidence collected during review:
+  - `go test -count=1 ./packages/go/config ./apps/edge/internal/node ./apps/edge/internal/edgevalidate ./apps/edge/internal/transport ./apps/node/internal/adapters`: PASS.
+  - `rg --sort path -n 'adapter: mock|mock-echo' scripts configs apps -g '!*.pb.go'`: no `adapter: mock`; intentional `mock-echo` references remained in `apps/node/internal/adapters/mock/mock.go` and `apps/node/internal/router/router_test.go`.
+  - `bash scripts/e2e-smoke.sh`: PASS.
+  - `bash scripts/e2e-openai-ollama.sh`: PASS.
+- Narrow reread allowed if needed: the two archived files listed above.
+- Roadmap carryover: none.
+
+## 이 파일을 읽는 구현 에이전트에게
+구현 후 `CODE_REVIEW-local-G06.md`의 구현 에이전트 소유 섹션을 실제 변경 내용과 검증 출력으로 채운다. 직접 사용자에게 질문하거나 선택지를 제시하지 않는다. 선택된 Milestone의 `구현 잠금 > 결정 필요` 항목이 실제 구현을 차단할 때만 review stub의 `사용자 리뷰 요청` 섹션에 근거를 기록하고 멈춘다.
+
+## 작업 항목
+
+### REVIEW_REVIEW_MOCK-1. mock adapter key를 flat namespace 충돌 검사에 포함
+- 문제:
+  - `BuildConfigPayload`는 explicit mock adapter를 `Type: "mock"` 및 empty `Name`으로 추가하므로 Node side instance key가 `mock`이 된다.
+  - 같은 node에 provider-first resource `id: mock`이 있으면 mapper가 충돌을 거부하지 않고 payload에 같은 instance key를 두 번 실을 수 있다.
+- 해결 방법:
+  - `seenFlat` 또는 동등한 flat key 예약 구조를 mock 추가 전에 초기화한다.
+  - `rec.Adapters.Mock.Enabled`이면 adapter key `mock`을 예약하고, provider id가 같은 key를 쓰면 명확한 conflict error를 반환한다.
+  - 기존 duplicate provider id error와 adapter key conflict error가 구분되도록 메시지를 유지하거나 개선한다.
+- 체크리스트:
+  - [ ] `apps/edge/internal/node/mapper.go`: explicit mock key `mock`을 flat namespace에 예약한다.
+  - [ ] `apps/edge/internal/node/mapper_test.go`: `adapters.mock.enabled: true`와 provider id `mock` 조합이 conflict error를 내는 테스트를 추가한다.
+- 중간 검증:
+  - [ ] `go test -count=1 ./apps/edge/internal/node`
+
+### REVIEW_REVIEW_MOCK-2. mock surface route의 explicit activation validation 추가
+- 문제:
+  - 계획은 mock route/console 참조가 explicit mock config 없이 실패해야 한다고 요구했지만, 현재 `ValidateEdgeConfig`는 provider adapter reference만 검사한다.
+  - `console.adapter: mock` 또는 OpenAI/A2A mock route가 남아도 node payload에는 mock이 없을 수 있어 runtime dispatch 시점까지 오류가 밀린다.
+- 해결 방법:
+  - `ValidateEdgeConfig`에서 mock을 참조하는 Edge input/console surface를 검사한다.
+  - 대상 surface: `console.adapter`, top-level `openai.adapter`, `openai.model_routes[].adapter`, `a2a.adapter`.
+  - surface에 `node`/`NodeRef`가 있으면 해당 node에 `adapters.mock.enabled: true`가 있어야 한다. node ref가 없으면 적어도 하나의 configured node가 explicit mock을 활성화해야 한다.
+  - OpenAI/A2A는 해당 surface가 enabled일 때만 검사하고, console은 configured adapter가 `mock`일 때 검사한다.
+  - node id와 alias 모두 node ref로 해석한다.
+- 체크리스트:
+  - [ ] `apps/edge/internal/edgevalidate/validate.go`: mock surface reference helper를 추가하고 `ValidateEdgeConfig`에서 호출한다.
+  - [ ] `apps/edge/internal/edgevalidate/validate_test.go`: explicit mock 없는 `console.adapter: mock` 실패와 explicit mock 있는 성공 테스트를 추가한다.
+  - [ ] `apps/edge/internal/edgevalidate/validate_test.go`: `openai.model_routes[].adapter: mock`에서 node ref가 explicit mock node를 가리킬 때 성공하고, mock 없는 node를 가리킬 때 실패하는 테스트를 추가한다.
+  - [ ] 가능하면 같은 helper로 `a2a.adapter: mock`의 enabled case도 테스트한다.
+- 중간 검증:
+  - [ ] `go test -count=1 ./apps/edge/internal/edgevalidate`
+
+## 구현 체크리스트
+- [ ] REVIEW_REVIEW_MOCK-1의 mapper key conflict 수정과 테스트를 완료한다.
+- [ ] REVIEW_REVIEW_MOCK-2의 surface mock validation 수정과 테스트를 완료한다.
+- [ ] 중간 검증과 최종 검증 명령을 실행하고 실제 stdout/stderr를 `CODE_REVIEW-local-G06.md`에 기록한다.
+- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.
+
+## 최종 검증
+```bash
+go test -count=1 ./apps/edge/internal/node ./apps/edge/internal/edgevalidate ./apps/edge/internal/transport
+go test -count=1 ./packages/go/config ./apps/node/internal/adapters
+rg --sort path -n 'adapter: mock|mock-echo' scripts configs apps -g '!*.pb.go'
+bash scripts/e2e-smoke.sh
+bash scripts/e2e-openai-ollama.sh
+```
+
+예상 결과: Go 테스트와 두 e2e가 PASS한다. `rg` 출력에는 config/script의 `adapter: mock`이 없어야 하며, 남는 `mock-echo`는 mock adapter 구현 또는 mock-specific unit test처럼 의도된 위치여야 한다.
--- a/agent-task/review_followup_alignment/04_explicit_mock_resource_activation/CODE_REVIEW-local-G06.md
+++ b/agent-task/review_followup_alignment/04_explicit_mock_resource_activation/CODE_REVIEW-local-G06.md
@ -1,79 +0,0 @@
-<!-- task=review_followup_alignment/04_explicit_mock_resource_activation plan=0 tag=REVIEW_MOCK -->
-# CODE_REVIEW-local-G06: mock resource 명시 활성화
-date=2026-07-06
-
-## 상태
-구현 대기
-
-## 이 파일을 읽는 구현 에이전트에게
-구현 후 이 파일의 구현 에이전트 소유 섹션을 실제 변경 내용, 계획 대비 변경, 검증 출력으로 채운다. active `PLAN-*.md`와 `CODE_REVIEW-*.md`는 남겨두고 review 준비 상태를 보고한다. 직접 사용자에게 질문하거나 `USER_REVIEW.md`를 만들거나 archive/complete 처리를 하지 않는다.
-
-## 구현 체크리스트
- [ ] REVIEW_MOCK-1의 config schema, Edge payload, validation, tests, scripts를 explicit mock 기준으로 갱신한다.
- [ ] 중간 검증 명령을 실행하고 e2e 실행 불가 시 환경 사유와 package test 결과를 `CODE_REVIEW-local-G06.md`에 기록한다.
- [ ] CODE_REVIEW-*-G??.md의 구현 에이전트 소유 섹션을 실제 구현 내용과 검증 출력으로 채운다. 이 항목이 완료되기 전에는 구현이 완료된 것이 아니다.
-
-## 코드리뷰 전용 체크리스트
-
-> **[REVIEW AGENT ONLY]** 이 체크리스트는 코드리뷰 에이전트만 사용한다.
-> 구현 에이전트는 이 섹션을 수정하거나 체크하지 않는다.
-
- [ ] `코드리뷰 결과`에 `PASS`, `WARN`, `FAIL` 중 하나의 판정을 append한다.
- [ ] 판정과 Required/Suggested/Nit 분류가 서로 일치한다.
- [ ] active `CODE_REVIEW-*-G??.md`를 archive 로그로 이동한다.
- [ ] active `PLAN-*-G??.md`를 archive 로그로 이동한다.
- [ ] `.gitignore`의 Agent-Ops 관리 block을 확인한다.
- [ ] PASS이면 `complete.log`를 작성하고 active `.md` 파일을 남기지 않는다.
- [ ] PASS split 작업이면 이동 후 빈 active parent 정리 여부를 확인한다.
-
-## 계획 대비 변경 사항
-_구현 에이전트가 계획과 다르게 구현한 부분을 이유와 함께 기록한다._
-
-## 주요 설계 결정
-_구현 에이전트가 주요 설계 결정 사항을 기록한다._
-
-## 사용자 리뷰 요청
-
-_기본값은 `없음`이다. 구현 중 새 결정이 필요해 보여도 직접 질문하거나 선택지를 제시하거나 `request_user_input`을 호출하지 않는다. 이 섹션은 선택된 Milestone `구현 잠금 > 결정 필요` 항목이 실구현을 차단할 때만 채운다. 외부 환경/secret/서비스 준비, 검증 증거 공백, 반복 실패, 일반 범위 조정은 사용자 리뷰 요청이 아니며 `검증 결과`, `계획 대비 변경 사항`, 또는 code-review의 일반 follow-up plan으로 처리한다._
-
- 상태: 없음
- 사유 유형: 없음
- 연결 대상: 없음
- 결정 필요: 없음
- 차단 근거: 없음
- 실행한 검증/명령: 없음
- 자동 후속 불가 이유: 없음
- 재개 조건: 없음
-
-## 리뷰어를 위한 체크포인트
- Edge mapper가 mock을 implicit로 넣지 않는가.
- explicit `adapters.mock.enabled: true`가 있을 때만 typed mock config가 payload에 들어가는가.
- validation과 scripts가 mock route를 명시 config와 함께 사용하도록 맞춰졌는가.
- Node factory의 empty payload no-mock 계약이 유지되는가.
-
-## 검증 결과
-_구현 에이전트가 각 중간 검증 및 최종 검증 명령 실행 후 출력을 여기에 붙여 넣는다._
-
-필수 규칙:
- 검증 명령은 고정된 계약이다. 임의로 대체하지 않는다.
- 대체가 필요하면 `계획 대비 변경 사항`에 이유와 대체 명령을 기록한다.
- `검증 결과`에는 실제 stdout/stderr를 붙여 넣는다.
-
-### REVIEW_MOCK-1 중간 검증
-```bash
-go test -count=1 ./packages/go/config ./apps/edge/internal/node ./apps/edge/internal/edgevalidate ./apps/edge/internal/transport ./apps/node/internal/adapters
-rg --sort path -n 'adapter: mock|mock-echo' scripts configs apps -g '!*.pb.go'
-bash scripts/e2e-smoke.sh
-bash scripts/e2e-openai-ollama.sh
-```
-
-### 최종 검증
-```bash
-go test -count=1 ./packages/go/config ./apps/edge/internal/node ./apps/edge/internal/edgevalidate ./apps/edge/internal/transport ./apps/node/internal/adapters
-rg --sort path -n 'adapter: mock|mock-echo' scripts configs apps -g '!*.pb.go'
-bash scripts/e2e-smoke.sh
-bash scripts/e2e-openai-ollama.sh
-```
-
-## 코드리뷰 결과
-_리뷰 에이전트가 append한다._
--- a/apps/edge/internal/edgevalidate/validate.go
+++ b/apps/edge/internal/edgevalidate/validate.go
@ -32,7 +32,7 @@ func ValidateEdgeConfig(cfg *config.EdgeConfig) error {
 		hasVllm := anyVllmEnabled(n.Adapters)
 		hasOpenAICompat := anyOpenAICompatEnabled(n.Adapters)
 		hasProviders := len(n.Providers) > 0
-		if !hasOllama && !n.Adapters.CLI.Enabled && !hasVllm && !hasOpenAICompat && !hasProviders {
+		if !hasOllama && !n.Adapters.CLI.Enabled && !hasVllm && !hasOpenAICompat && !hasProviders && !n.Adapters.Mock.Enabled {
 			return fmt.Errorf("node %q: at least one adapter must be enabled", name)
 		}
 		if n.Adapters.Ollama.Enabled && n.Adapters.Ollama.BaseURL == "" {
@ -70,6 +70,10 @@ func ValidateEdgeConfig(cfg *config.EdgeConfig) error {
 			return err
 		}
 	}
+
+	if err := validateMockSurfaceReferences(cfg); err != nil {
+		return err
+	}
 	return nil
 }

@ -208,6 +212,9 @@ func buildAdapterIndex(a config.AdaptersConf) adapterIndex {
 	if a.CLI.Enabled {
 		idx.add("cli", "cli")
 	}
+	if a.Mock.Enabled {
+		idx.add("mock", "mock")
+	}
 	for typeName, keys := range idx.typeKeys {
 		idx.typeCount[typeName] = len(keys)
 	}
@ -268,3 +275,100 @@ func anyOpenAICompatEnabled(a config.AdaptersConf) bool {
 	}
 	return false
 }
+
+// validateMockSurfaceReferences ensures that mock adapter references in
+// edge-wide surfaces (console, openai, a2a) are backed by explicit mock
+// activation on the relevant node(s).
+func validateMockSurfaceReferences(cfg *config.EdgeConfig) error {
+	// Build maps: node id/alias -> has mock enabled
+	nodeIDtoMock := make(map[string]bool)
+	nodeAliasToMock := make(map[string]bool)
+	for _, n := range cfg.Nodes {
+		nodeIDtoMock[n.ID] = n.Adapters.Mock.Enabled
+		if n.Alias != "" {
+			nodeAliasToMock[n.Alias] = n.Adapters.Mock.Enabled
+		}
+	}
+
+	// resolveMockNode checks whether a node reference resolves to a node
+	// with mock enabled. Returns (hasMock, found).
+	resolveMockNode := func(ref string) (bool, bool) {
+		ref = strings.TrimSpace(ref)
+		if ref == "" {
+			return false, false
+		}
+		if v, ok := nodeIDtoMock[ref]; ok {
+			return v, true
+		}
+		if v, ok := nodeAliasToMock[ref]; ok {
+			return v, true
+		}
+		return false, false
+	}
+
+	// hasAnyMock reports whether at least one node has explicit mock enabled.
+	hasAnyMock := false
+	for _, v := range nodeIDtoMock {
+		if v {
+			hasAnyMock = true
+			break
+		}
+	}
+
+	// console.adapter: mock - console has no node ref; any node with mock suffices.
+	if cfg.Console.Adapter == "mock" && !hasAnyMock {
+		return fmt.Errorf("console.adapter references mock but no node has explicit mock enabled")
+	}
+
+	// openai.adapter and openai.model_routes[].adapter.
+	if cfg.OpenAI.Enabled {
+		if cfg.OpenAI.Adapter == "mock" {
+			if cfg.OpenAI.NodeRef != "" {
+				hasMock, found := resolveMockNode(cfg.OpenAI.NodeRef)
+				if !found {
+					return fmt.Errorf("openai adapter node reference %q does not resolve to any node", cfg.OpenAI.NodeRef)
+				}
+				if !hasMock {
+					return fmt.Errorf("openai adapter references mock but node %q does not have explicit mock enabled", cfg.OpenAI.NodeRef)
+				}
+			} else if !hasAnyMock {
+				return fmt.Errorf("openai.adapter references mock but no node has explicit mock enabled")
+			}
+		}
+
+		for i, route := range cfg.OpenAI.ModelRoutes {
+			if route.Adapter == "mock" {
+				if route.NodeRef != "" {
+					hasMock, found := resolveMockNode(route.NodeRef)
+					if !found {
+						return fmt.Errorf("openai.model_routes[%d] adapter references mock but node reference %q does not resolve to any node", i, route.NodeRef)
+					}
+					if !hasMock {
+						return fmt.Errorf("openai.model_routes[%d] adapter references mock but node %q does not have explicit mock enabled", i, route.NodeRef)
+					}
+				} else if !hasAnyMock {
+					return fmt.Errorf("openai.model_routes[%d] adapter references mock but no node has explicit mock enabled", i)
+				}
+			}
+		}
+	}
+
+	// a2a.adapter: mock.
+	if cfg.A2A.Enabled {
+		if cfg.A2A.Adapter == "mock" {
+			if cfg.A2A.NodeRef != "" {
+				hasMock, found := resolveMockNode(cfg.A2A.NodeRef)
+				if !found {
+					return fmt.Errorf("a2a adapter node reference %q does not resolve to any node", cfg.A2A.NodeRef)
+				}
+				if !hasMock {
+					return fmt.Errorf("a2a adapter references mock but node %q does not have explicit mock enabled", cfg.A2A.NodeRef)
+				}
+			} else if !hasAnyMock {
+				return fmt.Errorf("a2a.adapter references mock but no node has explicit mock enabled")
+			}
+		}
+	}
+
+	return nil
+}
--- a/apps/edge/internal/edgevalidate/validate_test.go
+++ b/apps/edge/internal/edgevalidate/validate_test.go
@ -514,14 +514,14 @@ func TestValidateEdgeConfig_ProviderLegacyConflictViaValidate(t *testing.T) {
 // when provider capacity is 0 and legacy capacity > 0.
 func TestValidateEdgeConfig_ProviderLegacyCapacityMismatchViaValidate(t *testing.T) {
 	tests := []struct {
-		name          string
-		adapterName   string
-		providerID    string
-		providerType  string
-		providerCap   int
-		legacyCap     int
-		legacyOpts    func(*config.AdaptersConf)
-		providerOpts  func(*config.NodeProviderConf)
+		name         string
+		adapterName  string
+		providerID   string
+		providerType string
+		providerCap  int
+		legacyCap    int
+		legacyOpts   func(*config.AdaptersConf)
+		providerOpts func(*config.NodeProviderConf)
 	}{
 		{
 			name:         "ollama provider capacity 0 vs legacy capacity 2",
@ -562,8 +562,8 @@ func TestValidateEdgeConfig_ProviderLegacyCapacityMismatchViaValidate(t *testing
 	for _, tc := range tests {
 		t.Run(tc.name, func(t *testing.T) {
 			node := config.NodeDefinition{
-				ID:    "node-1",
-				Token: "tok",
+				ID:       "node-1",
+				Token:    "tok",
 				Adapters: config.AdaptersConf{},
 				Providers: []config.NodeProviderConf{
 					{
@ -671,3 +671,318 @@ func TestValidateEdgeConfig_DisabledProviderSkipsAdapterRefCheck(t *testing.T) {
 		t.Fatalf("disabled provider with missing adapter should pass validation, got: %v", err)
 	}
 }
+
+// REVIEW_MOCK: mock-only node passes "at least one adapter" when explicitly enabled.
+func TestValidateEdgeConfig_MockOnlyNode(t *testing.T) {
+	node := config.NodeDefinition{
+		ID:    "node-mock",
+		Token: "tok-mock",
+		Adapters: config.AdaptersConf{
+			Mock: config.MockConf{Enabled: true},
+		},
+	}
+
+	err := ValidateEdgeConfig(&config.EdgeConfig{Nodes: []config.NodeDefinition{node}})
+	if err != nil {
+		t.Fatalf("mock-only node with explicit enabled should pass, got: %v", err)
+	}
+}
+
+// REVIEW_MOCK: node with only mock config disabled should fail "at least one adapter".
+func TestValidateEdgeConfig_MockDisabledFails(t *testing.T) {
+	node := config.NodeDefinition{
+		ID:    "node-mock",
+		Token: "tok-mock",
+		Adapters: config.AdaptersConf{
+			Mock: config.MockConf{Enabled: false},
+		},
+	}
+
+	err := ValidateEdgeConfig(&config.EdgeConfig{Nodes: []config.NodeDefinition{node}})
+	if err == nil {
+		t.Fatal("expected 'at least one adapter' error for mock-disabled node")
+	}
+	if !strings.Contains(err.Error(), "at least one adapter") {
+		t.Fatalf("expected error mentioning 'at least one adapter', got: %v", err)
+	}
+}
+
+// REVIEW_REVIEW_MOCK-2: console.adapter references mock without any mock-enabled node fails.
+func TestValidateEdgeConfig_MockSurfaceConsoleNoMockNode(t *testing.T) {
+	node := config.NodeDefinition{
+		ID:    "node-1",
+		Token: "tok",
+		Adapters: config.AdaptersConf{
+			OllamaInstances: []config.OllamaInstanceConf{
+				{Name: "ollama", Enabled: true, BaseURL: "http://127.0.0.1:11434"},
+			},
+		},
+	}
+	cfg := &config.EdgeConfig{
+		Nodes:   []config.NodeDefinition{node},
+		Console: config.EdgeConsoleConf{Adapter: "mock"},
+	}
+	err := ValidateEdgeConfig(cfg)
+	if err == nil {
+		t.Fatal("expected error for console.adapter: mock without mock-enabled node")
+	}
+	if !strings.Contains(err.Error(), "mock") || !strings.Contains(err.Error(), "explicit mock") {
+		t.Fatalf("expected error mentioning mock, got: %v", err)
+	}
+}
+
+// REVIEW_REVIEW_MOCK-2: console.adapter references mock with mock-enabled node succeeds.
+func TestValidateEdgeConfig_MockSurfaceConsoleWithMockNode(t *testing.T) {
+	node := config.NodeDefinition{
+		ID:    "node-mock",
+		Token: "tok",
+		Adapters: config.AdaptersConf{
+			Mock: config.MockConf{Enabled: true},
+		},
+	}
+	cfg := &config.EdgeConfig{
+		Nodes:   []config.NodeDefinition{node},
+		Console: config.EdgeConsoleConf{Adapter: "mock"},
+	}
+	if err := ValidateEdgeConfig(cfg); err != nil {
+		t.Fatalf("expected success, got: %v", err)
+	}
+}
+
+// REVIEW_REVIEW_MOCK-2: openai.model_routes[].adapter references mock with node ref to mock-enabled node succeeds.
+func TestValidateEdgeConfig_MockSurfaceOpenAIRouteWithMockNode(t *testing.T) {
+	node := config.NodeDefinition{
+		ID:    "node-mock",
+		Token: "tok",
+		Adapters: config.AdaptersConf{
+			Mock: config.MockConf{Enabled: true},
+		},
+	}
+	cfg := &config.EdgeConfig{
+		Nodes: []config.NodeDefinition{node},
+		OpenAI: config.EdgeOpenAIConf{
+			Enabled: true,
+			ModelRoutes: []config.OpenAIRouteEntry{
+				{
+					Model:   "mock-model",
+					NodeRef: "node-mock",
+					Adapter: "mock",
+					Target:  "mock-target",
+				},
+			},
+		},
+	}
+	if err := ValidateEdgeConfig(cfg); err != nil {
+		t.Fatalf("expected success, got: %v", err)
+	}
+}
+
+// REVIEW_REVIEW_MOCK-2: openai.model_routes[].adapter references mock with node ref to non-mock node fails.
+func TestValidateEdgeConfig_MockSurfaceOpenAIRouteNoMockNode(t *testing.T) {
+	node := config.NodeDefinition{
+		ID:    "node-ollama",
+		Token: "tok",
+		Adapters: config.AdaptersConf{
+			OllamaInstances: []config.OllamaInstanceConf{
+				{Name: "ollama", Enabled: true, BaseURL: "http://127.0.0.1:11434"},
+			},
+		},
+	}
+	cfg := &config.EdgeConfig{
+		Nodes: []config.NodeDefinition{node},
+		OpenAI: config.EdgeOpenAIConf{
+			Enabled: true,
+			ModelRoutes: []config.OpenAIRouteEntry{
+				{
+					Model:   "mock-model",
+					NodeRef: "node-ollama",
+					Adapter: "mock",
+					Target:  "mock-target",
+				},
+			},
+		},
+	}
+	err := ValidateEdgeConfig(cfg)
+	if err == nil {
+		t.Fatal("expected error for openai.model_routes[].adapter: mock with non-mock node ref")
+	}
+	if !strings.Contains(err.Error(), "mock") || !strings.Contains(err.Error(), "explicit mock") {
+		t.Fatalf("expected error mentioning mock, got: %v", err)
+	}
+}
+
+// REVIEW_REVIEW_MOCK-2: a2a.adapter references mock with mock-enabled node ref succeeds.
+func TestValidateEdgeConfig_MockSurfaceA2AWithMockNode(t *testing.T) {
+	node := config.NodeDefinition{
+		ID:    "node-mock",
+		Token: "tok",
+		Adapters: config.AdaptersConf{
+			Mock: config.MockConf{Enabled: true},
+		},
+	}
+	cfg := &config.EdgeConfig{
+		Nodes: []config.NodeDefinition{node},
+		A2A: config.EdgeA2AConf{
+			Enabled: true,
+			NodeRef: "node-mock",
+			Adapter: "mock",
+		},
+	}
+	if err := ValidateEdgeConfig(cfg); err != nil {
+		t.Fatalf("expected success, got: %v", err)
+	}
+}
+
+// REVIEW_REVIEW_MOCK-2: a2a.adapter references mock without mock-enabled node fails.
+func TestValidateEdgeConfig_MockSurfaceA2ANoMockNode(t *testing.T) {
+	node := config.NodeDefinition{
+		ID:    "node-1",
+		Token: "tok",
+		Adapters: config.AdaptersConf{
+			OllamaInstances: []config.OllamaInstanceConf{
+				{Name: "ollama", Enabled: true, BaseURL: "http://127.0.0.1:11434"},
+			},
+		},
+	}
+	cfg := &config.EdgeConfig{
+		Nodes: []config.NodeDefinition{node},
+		A2A: config.EdgeA2AConf{
+			Enabled: true,
+			NodeRef: "node-1",
+			Adapter: "mock",
+		},
+	}
+	err := ValidateEdgeConfig(cfg)
+	if err == nil {
+		t.Fatal("expected error for a2a.adapter: mock without mock-enabled node")
+	}
+	if !strings.Contains(err.Error(), "mock") || !strings.Contains(err.Error(), "explicit mock") {
+		t.Fatalf("expected error mentioning mock, got: %v", err)
+	}
+}
+
+// REVIEW_REVIEW_MOCK-2: openai top-level adapter references mock with node ref to mock-enabled node succeeds.
+func TestValidateEdgeConfig_MockSurfaceOpenAITopLevelWithMockNode(t *testing.T) {
+	node := config.NodeDefinition{
+		ID:    "node-mock",
+		Token: "tok",
+		Adapters: config.AdaptersConf{
+			Mock: config.MockConf{Enabled: true},
+		},
+	}
+	cfg := &config.EdgeConfig{
+		Nodes: []config.NodeDefinition{node},
+		OpenAI: config.EdgeOpenAIConf{
+			Enabled:   true,
+			NodeRef:   "node-mock",
+			Adapter:   "mock",
+			Target:    "mock-target",
+			Models:    []string{"mock-model"},
+			SessionID: "test",
+		},
+	}
+	if err := ValidateEdgeConfig(cfg); err != nil {
+		t.Fatalf("expected success, got: %v", err)
+	}
+}
+
+// REVIEW_REVIEW_MOCK-2: openai top-level adapter references mock without node ref but hasAnyMock succeeds.
+func TestValidateEdgeConfig_MockSurfaceOpenAITopLevelNoNodeRefWithHasAnyMock(t *testing.T) {
+	node := config.NodeDefinition{
+		ID:    "node-mock",
+		Token: "tok",
+		Adapters: config.AdaptersConf{
+			Mock: config.MockConf{Enabled: true},
+		},
+	}
+	cfg := &config.EdgeConfig{
+		Nodes: []config.NodeDefinition{node},
+		OpenAI: config.EdgeOpenAIConf{
+			Enabled:   true,
+			Adapter:   "mock",
+			Target:    "mock-target",
+			Models:    []string{"mock-model"},
+			SessionID: "test",
+		},
+	}
+	if err := ValidateEdgeConfig(cfg); err != nil {
+		t.Fatalf("expected success, got: %v", err)
+	}
+}
+
+// REVIEW_REVIEW_MOCK-2: openai top-level adapter references mock with alias-based node ref succeeds.
+func TestValidateEdgeConfig_MockSurfaceOpenAITopLevelAliasRef(t *testing.T) {
+	node := config.NodeDefinition{
+		ID:    "node-mock",
+		Alias: "mock-alias",
+		Token: "tok",
+		Adapters: config.AdaptersConf{
+			Mock: config.MockConf{Enabled: true},
+		},
+	}
+	cfg := &config.EdgeConfig{
+		Nodes: []config.NodeDefinition{node},
+		OpenAI: config.EdgeOpenAIConf{
+			Enabled:   true,
+			NodeRef:   "mock-alias",
+			Adapter:   "mock",
+			Target:    "mock-target",
+			Models:    []string{"mock-model"},
+			SessionID: "test",
+		},
+	}
+	if err := ValidateEdgeConfig(cfg); err != nil {
+		t.Fatalf("expected success with alias ref, got: %v", err)
+	}
+}
+
+// REVIEW_REVIEW_MOCK-2: a2a adapter references mock without node ref but hasAnyMock succeeds.
+func TestValidateEdgeConfig_MockSurfaceA2ANoNodeRefWithHasAnyMock(t *testing.T) {
+	node := config.NodeDefinition{
+		ID:    "node-mock",
+		Token: "tok",
+		Adapters: config.AdaptersConf{
+			Mock: config.MockConf{Enabled: true},
+		},
+	}
+	cfg := &config.EdgeConfig{
+		Nodes: []config.NodeDefinition{node},
+		A2A: config.EdgeA2AConf{
+			Enabled: true,
+			Adapter: "mock",
+		},
+	}
+	if err := ValidateEdgeConfig(cfg); err != nil {
+		t.Fatalf("expected success, got: %v", err)
+	}
+}
+
+// REVIEW_REVIEW_MOCK-2: openai top-level adapter references mock without node ref and no mock node fails.
+func TestValidateEdgeConfig_MockSurfaceOpenAITopLevelNoNodeRefNoMock(t *testing.T) {
+	node := config.NodeDefinition{
+		ID:    "node-1",
+		Token: "tok",
+		Adapters: config.AdaptersConf{
+			OllamaInstances: []config.OllamaInstanceConf{
+				{Name: "ollama", Enabled: true, BaseURL: "http://127.0.0.1:11434"},
+			},
+		},
+	}
+	cfg := &config.EdgeConfig{
+		Nodes: []config.NodeDefinition{node},
+		OpenAI: config.EdgeOpenAIConf{
+			Enabled:   true,
+			Adapter:   "mock",
+			Target:    "mock-target",
+			Models:    []string{"mock-model"},
+			SessionID: "test",
+		},
+	}
+	err := ValidateEdgeConfig(cfg)
+	if err == nil {
+		t.Fatal("expected error for openai top-level adapter: mock with no node ref and no mock-enabled node")
+	}
+	if !strings.Contains(err.Error(), "mock") || !strings.Contains(err.Error(), "explicit mock") {
+		t.Fatalf("expected error mentioning mock, got: %v", err)
+	}
+}
--- a/apps/edge/internal/node/mapper.go
+++ b/apps/edge/internal/node/mapper.go
@ -21,6 +21,8 @@ import (
 // OpenAICompatInstances already contain the promoted legacy single-instance
 // entries, so only the slice fields are iterated here. Duplicate instance names
 // produce an error.
+//
+// Mock adapter is only included when rec.Adapters.Mock.Enabled is true.
 func BuildConfigPayload(rec *NodeRecord) (*iop.NodeConfigPayload, error) {
 	payload := &iop.NodeConfigPayload{
 		Runtime: &iop.NodeRuntimeConfig{
@ -28,11 +30,14 @@ func BuildConfigPayload(rec *NodeRecord) (*iop.NodeConfigPayload, error) {
 		},
 	}

-	payload.Adapters = append(payload.Adapters, &iop.AdapterConfig{
-		Type:    "mock",
-		Enabled: true,
-		Config:  &iop.AdapterConfig_Mock{Mock: &iop.MockAdapterConfig{}},
-	})
+	// Conditional mock adapter: only when explicitly enabled in config.
+	if rec.Adapters.Mock.Enabled {
+		payload.Adapters = append(payload.Adapters, &iop.AdapterConfig{
+			Type:    "mock",
+			Enabled: true,
+			Config:  &iop.AdapterConfig_Mock{Mock: &iop.MockAdapterConfig{}},
+		})
+	}

 	// flat namespace to detect conflicts between provider ids and legacy adapter keys
 	seenFlat := make(map[string]struct{})
@ -42,6 +47,9 @@ func BuildConfigPayload(rec *NodeRecord) (*iop.NodeConfigPayload, error) {
 			// references a legacy adapter instance; skip provider-first compile
 			continue
 		}
+		if rec.Adapters.Mock.Enabled && p.ID == "mock" {
+			return nil, fmt.Errorf("provider id %q conflicts with explicit mock adapter instance key", p.ID)
+		}
 		if _, dup := seenFlat[p.ID]; dup {
 			return nil, fmt.Errorf("duplicate provider id %q", p.ID)
 		}
--- a/apps/edge/internal/node/mapper_test.go
+++ b/apps/edge/internal/node/mapper_test.go
@ -1,6 +1,7 @@
 package node_test

 import (
+	"strings"
 	"testing"

 	edgenode "iop/apps/edge/internal/node"
@ -17,6 +18,7 @@ func TestBuildConfigPayload_OllamaEnabled(t *testing.T) {
 		Alias: "test",
 		Token: "token",
 		Adapters: config.AdaptersConf{
+			Mock: config.MockConf{Enabled: true},
 			OllamaInstances: []config.OllamaInstanceConf{
 				{
 					Name:             "ollama",
@ -47,8 +49,8 @@ func TestBuildConfigPayload_OllamaEnabled(t *testing.T) {
 		t.Errorf("expected concurrency 4, got %d", payload.Runtime.Concurrency)
 	}

-	if len(payload.Adapters) < 2 {
-		t.Fatalf("expected at least 2 adapters, got %d", len(payload.Adapters))
+	if len(payload.Adapters) < 1 {
+		t.Fatalf("expected at least 1 adapter, got %d", len(payload.Adapters))
 	}

 	mockFound := false
@ -75,7 +77,7 @@ func TestBuildConfigPayload_OllamaEnabled(t *testing.T) {
 		}
 	}
 	if !mockFound {
-		t.Fatal("expected mock adapter")
+		t.Fatal("expected mock adapter when explicitly enabled")
 	}
 	if !ollamaFound {
 		t.Fatal("expected ollama adapter when enabled")
@ -217,12 +219,15 @@ func TestBuildConfigPayload_GenericRecordWithoutAdapters(t *testing.T) {
 	if payload.GetRuntime() == nil {
 		t.Fatal("expected runtime config, got nil")
 	}
-	if len(payload.GetAdapters()) < 1 || payload.GetAdapters()[0].GetType() != "mock" {
-		t.Fatalf("expected mock adapter for generic record, got %+v", payload.GetAdapters())
+	// Generic record without explicit mock config should have no mock adapter.
+	for _, a := range payload.GetAdapters() {
+		if a.GetType() == "mock" {
+			t.Fatalf("expected no mock adapter when mock config is omitted, got %+v", a)
+		}
 	}
 }

-func TestBuildConfigPayload_MockAlwaysPresent(t *testing.T) {
+func TestBuildConfigPayload_NoMockWhenOmitted(t *testing.T) {
 	rec := &edgenode.NodeRecord{
 		ID:    "node-1",
 		Alias: "test",
@ -240,13 +245,11 @@ func TestBuildConfigPayload_MockAlwaysPresent(t *testing.T) {
 		t.Fatalf("BuildConfigPayload failed: %v", err)
 	}

-	if len(payload.Adapters) < 1 {
-		t.Fatalf("expected at least 1 adapter, got %d", len(payload.Adapters))
-	}
-
-	first := payload.Adapters[0]
-	if first.Type != "mock" {
-		t.Errorf("expected first adapter type %q, got %q", "mock", first.Type)
+	// Without explicit mock config, mock adapter must not be present.
+	for _, a := range payload.GetAdapters() {
+		if a.GetType() == "mock" {
+			t.Fatalf("expected no mock adapter when mock config is omitted, got %+v", a)
+		}
 	}
 }

@ -256,6 +259,7 @@ func TestBuildConfigPayload_MultiOllamaInstances(t *testing.T) {
 		Alias: "test",
 		Token: "token",
 		Adapters: config.AdaptersConf{
+			Mock: config.MockConf{Enabled: true},
 			OllamaInstances: []config.OllamaInstanceConf{
 				{Name: "local", Enabled: true, BaseURL: "http://127.0.0.1:11434", ContextSize: 131072, Capacity: 2, MaxQueue: 4, QueueTimeoutMS: 1000, RequestTimeoutMS: 20000},
 				{Name: "dgx", Enabled: true, BaseURL: "http://192.168.0.91:11434", ContextSize: 262144, Capacity: 6, MaxQueue: 12, QueueTimeoutMS: 2000, RequestTimeoutMS: 60000},
@ -302,6 +306,7 @@ func TestBuildConfigPayload_MultiVllmInstances(t *testing.T) {
 		Alias: "test",
 		Token: "token",
 		Adapters: config.AdaptersConf{
+			Mock: config.MockConf{Enabled: true},
 			VllmInstances: []config.VllmInstanceConf{
 				{Name: "a100", Enabled: true, Endpoint: "http://10.0.0.5:8000", Capacity: 4, MaxQueue: 10, QueueTimeoutMS: 1500, RequestTimeoutMS: 45000},
 				{Name: "h100", Enabled: true, Endpoint: "http://10.0.0.6:8000", Capacity: 8, MaxQueue: 16, QueueTimeoutMS: 2500, RequestTimeoutMS: 90000},
@ -351,6 +356,7 @@ func TestBuildConfigPayload_LegacyOllamaViaInstances(t *testing.T) {
 		Alias: "test",
 		Token: "token",
 		Adapters: config.AdaptersConf{
+			Mock: config.MockConf{Enabled: true},
 			// Simulate what LoadEdge produces after legacy normalisation.
 			OllamaInstances: []config.OllamaInstanceConf{
 				{Name: "ollama", Enabled: true, BaseURL: "http://localhost:11434", ContextSize: 4096, Capacity: 5, MaxQueue: 9, QueueTimeoutMS: 1700, RequestTimeoutMS: 55000},
@ -408,6 +414,9 @@ func TestBuildConfigPayload_MockUsesTypedConfig(t *testing.T) {
 		ID:    "node-1",
 		Alias: "test",
 		Token: "token",
+		Adapters: config.AdaptersConf{
+			Mock: config.MockConf{Enabled: true},
+		},
 	}

 	payload, err := edgenode.BuildConfigPayload(rec)
@ -423,7 +432,7 @@ func TestBuildConfigPayload_MockUsesTypedConfig(t *testing.T) {
 		}
 	}
 	if mockAdapter == nil {
-		t.Fatal("expected mock adapter in payload")
+		t.Fatal("expected mock adapter in payload when explicitly enabled")
 	}
 	if mockAdapter.GetSettings() != nil {
 		t.Fatalf("mock adapter must not populate legacy Settings, got %v", mockAdapter.GetSettings())
@ -439,6 +448,7 @@ func TestBuildConfigPayload_OpenAICompatInstances(t *testing.T) {
 		Alias: "test",
 		Token: "token",
 		Adapters: config.AdaptersConf{
+			Mock: config.MockConf{Enabled: true},
 			OpenAICompatInstances: []config.OpenAICompatInstanceConf{
 				{Name: "lemonade", Enabled: true, Provider: "lemonade", Endpoint: "http://127.0.0.1:13305", Headers: map[string]string{"authorization": "Bearer test"}, Capacity: 4, MaxQueue: 10, QueueTimeoutMS: 1500, RequestTimeoutMS: 30000},
 				{Name: "openai-api", Enabled: true, Provider: "openai", Endpoint: "https://api.openai.com/v1", Headers: map[string]string{"authorization": "Bearer sk-test"}, Capacity: 8, MaxQueue: 20, QueueTimeoutMS: 2500, RequestTimeoutMS: 60000},
@ -774,3 +784,31 @@ func TestBuildConfigPayload_VLLMOpenAICompatInstance(t *testing.T) {
 		t.Errorf("queue config mismatch: %+v", oc)
 	}
 }
+
+// REVIEW_REVIEW_MOCK-1: provider id "mock" conflicts with explicit mock adapter instance key.
+func TestBuildConfigPayload_MockKeyConflictsWithProviderID(t *testing.T) {
+	rec := &edgenode.NodeRecord{
+		ID:    "node-1",
+		Alias: "test",
+		Token: "token",
+		Providers: []config.NodeProviderConf{
+			{
+				ID:       "mock",
+				Type:     "ollama",
+				Category: config.CategoryLocalInference,
+				BaseURL:  "http://localhost:11434",
+			},
+		},
+		Adapters: config.AdaptersConf{
+			Mock: config.MockConf{Enabled: true},
+		},
+	}
+
+	_, err := edgenode.BuildConfigPayload(rec)
+	if err == nil {
+		t.Fatal("expected error when provider id 'mock' conflicts with explicit mock adapter key")
+	}
+	if !strings.Contains(err.Error(), "conflicts with explicit mock adapter instance key") {
+		t.Fatalf("expected error mentioning conflict with mock key, got: %v", err)
+	}
+}
--- a/apps/edge/internal/transport/integration_test.go
+++ b/apps/edge/internal/transport/integration_test.go
@ -272,6 +272,7 @@ func TestEdgeServerIntegration(t *testing.T) {
 			Token: "test-token",
 			Adapters: config.AdaptersConf{
 				Ollama: config.OllamaConf{Enabled: true, BaseURL: "http://localhost:11434"},
+				Mock:   config.MockConf{Enabled: true},
 			},
 			Runtime: config.RuntimeConf{Concurrency: 2},
 		},
--- a/apps/edge/internal/transport/server_test.go
+++ b/apps/edge/internal/transport/server_test.go
@ -418,6 +418,7 @@ func TestBuildConfigPayload_AllAdaptersSettingsNil(t *testing.T) {
 		Adapters: config.AdaptersConf{
 			Ollama: config.OllamaConf{Enabled: true, BaseURL: "http://localhost:11434"},
 			Vllm:   config.VllmConf{Enabled: true, Endpoint: "http://localhost:8000"},
+			Mock:   config.MockConf{Enabled: true},
 			CLI: config.CLIConf{
 				Enabled:  true,
 				Profiles: map[string]config.CLIProfileConf{"default": {Command: "echo"}},
--- a/packages/go/config/config.go
+++ b/packages/go/config/config.go
@ -465,6 +465,7 @@ type AdaptersConf struct {
 	Vllm         VllmConf         `mapstructure:"vllm"          yaml:"vllm"`
 	OpenAICompat OpenAICompatConf `mapstructure:"openai_compat" yaml:"openai_compat"`
 	CLI          CLIConf          `mapstructure:"cli"           yaml:"cli"`
+	Mock         MockConf         `mapstructure:"mock"          yaml:"mock"`

 	// Multi-instance collections. Each entry carries a unique Name that acts as
 	// the stable adapter instance identity within the node. Names must be unique
@ -544,6 +545,12 @@ type CLIConf struct {
 	Profiles map[string]CLIProfileConf `mapstructure:"profiles" yaml:"profiles"`
 }

+// MockConf defines the mock adapter instance. It has no execution fields and
+// only serves as a flag to enable the mock adapter in the payload.
+type MockConf struct {
+	Enabled bool `mapstructure:"enabled"  yaml:"enabled"`
+}
+
 type CLIProfileConf struct {
 	Command               string               `mapstructure:"command"                  yaml:"command"`
 	Args                  []string             `mapstructure:"args"                     yaml:"args"`
--- a/packages/go/config/config_test.go
+++ b/packages/go/config/config_test.go
@ -3266,3 +3266,81 @@ nodes:
 		t.Fatalf("expected budget error mentioning total_context_tokens and long_context_capacity, got %v", err)
 	}
 }
+
+func TestLoadEdge_MockConfigExplicitEnabled(t *testing.T) {
+	dir := t.TempDir()
+	f := filepath.Join(dir, "edge.yaml")
+	yaml := `
+server:
+  listen: "0.0.0.0:9090"
+nodes:
+  - alias: "test-node"
+    token: "token-test"
+    adapters:
+      mock:
+        enabled: true
+`
+	if err := os.WriteFile(f, []byte(yaml), 0o600); err != nil {
+		t.Fatalf("write yaml: %v", err)
+	}
+	cfg, err := config.LoadEdge(f)
+	if err != nil {
+		t.Fatalf("load: %v", err)
+	}
+	if !cfg.Nodes[0].Adapters.Mock.Enabled {
+		t.Fatal("expected mock.enabled=true")
+	}
+}
+
+func TestLoadEdge_MockConfigOmittedDefaultsFalse(t *testing.T) {
+	dir := t.TempDir()
+	f := filepath.Join(dir, "edge.yaml")
+	yaml := `
+server:
+  listen: "0.0.0.0:9090"
+nodes:
+  - alias: "test-node"
+    token: "token-test"
+    adapters:
+      cli:
+        enabled: true
+        profiles:
+          default:
+            command: "echo"
+`
+	if err := os.WriteFile(f, []byte(yaml), 0o600); err != nil {
+		t.Fatalf("write yaml: %v", err)
+	}
+	cfg, err := config.LoadEdge(f)
+	if err != nil {
+		t.Fatalf("load: %v", err)
+	}
+	if cfg.Nodes[0].Adapters.Mock.Enabled {
+		t.Fatal("expected mock.enabled=false when omitted")
+	}
+}
+
+func TestLoadEdge_MockConfigExplicitDisabled(t *testing.T) {
+	dir := t.TempDir()
+	f := filepath.Join(dir, "edge.yaml")
+	yaml := `
+server:
+  listen: "0.0.0.0:9090"
+nodes:
+  - alias: "test-node"
+    token: "token-test"
+    adapters:
+      mock:
+        enabled: false
+`
+	if err := os.WriteFile(f, []byte(yaml), 0o600); err != nil {
+		t.Fatalf("write yaml: %v", err)
+	}
+	cfg, err := config.LoadEdge(f)
+	if err != nil {
+		t.Fatalf("load: %v", err)
+	}
+	if cfg.Nodes[0].Adapters.Mock.Enabled {
+		t.Fatal("expected mock.enabled=false when explicitly disabled")
+	}
+}
--- a/scripts/e2e-openai-cli-workspace.sh
+++ b/scripts/e2e-openai-cli-workspace.sh
@ -71,8 +71,8 @@ openai:
      target: "smoke-sh"
      workspace_required: true
 console:
-  adapter: mock
-  target: mock-echo
+  adapter: cli
+  target: smoke-sh
  session_id: default
 nodes:
  - id: test-node
--- a/scripts/e2e-openai-lemonade.sh
+++ b/scripts/e2e-openai-lemonade.sh
@ -191,8 +191,8 @@ openai:
      target: "$MODEL"
      node: "test-node"
 console:
-  adapter: mock
-  target: mock-echo
+  adapter: openai_compat
+  target: "$MODEL"
  session_id: default
 nodes:
  - id: test-node
--- a/scripts/e2e-openai-ollama.sh
+++ b/scripts/e2e-openai-ollama.sh
@ -135,8 +135,8 @@ openai:
      adapter: "ollama"
      target: "$MODEL"
 console:
-  adapter: mock
-  target: mock-echo
+  adapter: ollama
+  target: "$MODEL"
  session_id: default
 nodes:
  - id: test-node
--- a/scripts/e2e-openai-vllm.sh
+++ b/scripts/e2e-openai-vllm.sh
@ -189,8 +189,8 @@ openai:
      target: "$SERVED_MODEL"
      node: "test-node"
 console:
-  adapter: mock
-  target: mock-echo
+  adapter: openai_compat
+  target: "$SERVED_MODEL"
  session_id: default
 nodes:
  - id: test-node