§pi-shell-acp §meta-bridge 메타 브릿지 대칭 공존 비동기 메시지 언제 어디서나 누구나

이 노트에 대하여

이 노트는 두 축을 한 파일에 묶은 작업 기록이다. 첫째, 2026-05-22의 비대칭 공존 정리: pi-shell-acp에서 분신은 worker가 아니라 runtime-isolated peer이며, 외부 MCP host와 pi 세션은 replyable / non-replyable 경계를 가진다는 운영 원칙을 세운다. 둘째, 2026-06-05의 라이브 비동기 배달 실측: Claude Code, agy(Antigravity), Codex가 이미 떠 있는 native 세션에 어떤 정공법으로 async 메시지를 받을 수 있는지 비교한다.

핵심 결론은 “된다 /안 된다”가 아니라 “어느 층위까지 되는가”이다. Claude Code는 plugin/settings hook의 SessionStart -> watchPaths -> FileChanged -> asyncRewake 로 idle 세션을 깨운다. agy는 native LS gRPC send-message 로 push한다. Codex는 standalone embedded TUI는 주소화할 수 없지만, bare local app-server --listen 에 붙은 TUI는 WebSocket-over-UDS turn/start 로 full message injection과 completion observation이 가능하다. 이 차이를 DELIVERY.md 의 D0–D8 좌표계로 기록하여 1.0.0 meta-session / entwurf-fronted 설계의 판단 기준으로 삼는다.

히스토리

• [2026-06-06 Sat 18:02] @junghan — 비대칭 공존은 끝났음을 만천하에 알리는 바이다.
• [2026-06-05 Fri 13:32] 다이어트 /검수 — repo 산출물(DELIVERY.md, scripts/raw-async-delivery/README.md, 실행 스크립트들)를 SSOT로 두고, botlog 본문을 판단 기준·삽질 방지 기억 중심으로 축약. 인라인 스크립트 전문 제거, 삭제된 스크립트명 정리, 실제 파일 존재 교차검수.
• [2026-06-05 Fri 12:55] 마무리 — Codex 로컬 배달 surface 를 bare app-server 경로 중심으로 단일화하고, README/DELIVERY를 그 기준으로 정리.
• [2026-06-05 Fri 12:40] Codex 돌파 — embedded TUI 는 구조적 negative, app-server-backed TUI 는 로컬 소켓만으로 idle wake 가능. EPERM=/tmp chmod 정체, WS-over-UDS 인증 없음, plain codex auto-attach 패리티 실측.
• [2026-06-05 Fri 11:48] 주소 지정 라우팅 — per-session watchPath(<root>/<session_id>/) 로 원하는 Claude 세션만 깨우는 2세션 격리 실측 PASS. sessionId-addressed sender + per-session repro 추가, CC_MAILBOX_ROOT 통일.
• [2026-06-05 Fri 11:20] 재정정 — “scoped 불가”가 아니라 “bare skill 불가, plugin 가능”. 2.1.163 바이너리 분해와 tmux 라이브 실측으로 startup hook 경로를 확정.
• [2026-06-05 Fri 10:26] 생성 — Claude Code asyncRewake / agy send-message 실측, 비용 모델, 재현 스크립트 정리.
• [2026-05-22 Fri 09:43] @glg-gpt — 기존 botlog 양식에 맞춰 파일명 § prefix, retrieval-first filetags, description/abstract/history/related blocks, level-1 heading 구조, :LLMLOG: 태그 패턴을 정렬.
• [2026-05-22 Fri 09:29] @glg — 비대칭 공존과 pi-shell-acp 분신 운영의 진화를 botlog로 기록.

관련메타

• † #봇로그 #봇멘트 #에이전트기록 — botlog 자체의 기록 형식과 공개 에이전트 로그 축
• † #공진화 #공존 #함께 #상생_#같이 #가치 #공동 — 비대칭 공존을 존재 간 협업으로 읽는 상위 개념
• † #협업 #협력 #집단지성 #코웍 — 여러 하네스와 모델이 한 운영면에서 협력하는 자리

관련노트

• §pi-shell-acp 패키지 공개와 재현 가능한 pi 에이전트 하네스 — pi-shell-acp 공개와 하네스 방향성의 직접 전사
• §entwurf: 시간축 위의 에이전트 협력 — 공명에서 분신까지 — 분신/entwurf 협업 축의 상위 노트
• @Mitsein: 미트자인 - 자인님이라는 이름과 분신의 자리바꿈 — 담당자·분신·호명 관계의 존재론
• §agent-config: 에이전트 인프라의 진화 — 스킬에서 멀티하네스까지 — 외부 host surface 정합을 담당하는 resident-side 자리
• [entwurf 약속 룰 v1 — 경계를 넘는 호출에서 사람이 라우터인 inbox 패턴]
• [pi-shell-acp 에이전트 통합 연결 프로젝트 작업로그]

[2026-05-22 Fri 09:43] 비대칭 공존 pi-shell-acp의 방향성과 분신 운영의 진화

이 heading 이 붙드는 자리

이 부분은 pi-shell-acp 의 철학 메모이자 운영 invariant 기록이다. 코드/프로토콜 SSOT는 repo 문서가 맡고, 이 heading 은 왜 그런 문서 구조가 필요해졌는지, 어떤 오판을 다시 하지 말아야 하는지를 남긴다.

핵심 문장 하나만 남기면 이렇다.

분신은 worker 가 아니라 runtime-isolated peer 이고, 비대칭 공존은 이 peer 성질을 외부 MCP host 까지 확장하는 운영 원칙이다.

운영 변화 3단계

Phase A — pi-native 단일 하네스

부모와 자식이 모두 pi 세션이다. PI_SESSION_ID / PI_AGENT_ID, control socket, follow-up 모두 같은 학교 규칙을 따른다. 비대칭이 거의 없다.

Phase B — pi-shell-acp 등장

pi 는 하네스, Claude/Codex/Gemini 는 모델 carrier 가 된다. 부모/자식은 여전히 pi 세션이지만, 모델 정체성은 형제 학교에서 빌려온다. 이 자리에서 identity carrier + whitelist overlay 설계가 필요해졌다.

Phase C — 외부 MCP host 시대

Claude Code / Codex / Gemini CLI 같은 외부 host 가 pi-tools-bridge 를 통해 분신을 던진다. 이때 부모는 pi 세션이 아니므로 sender envelope 이 external-mcp/<host>, replyable: false 로 마킹된다. 이 비대칭을 숨기지 않고 드러내는 것이 핵심이다.

운영 invariant

replyable / non-replyable 비대칭

• pi 세션은 replyable 하다.
• 외부 MCP host 는 기본적으로 non-replyable 이다.
• 그래서 외부 host 에서 entwurf_send 는 fire-and-forget 이 기본이고, wants_reply=true 같은 상상은 거부되어야 한다.

spawn harness invariant

• model 은 자유 축이다. 어느 형제 학교 모델이든 빌려올 수 있다.
• 하지만 spawn target 은 자유 축이 아니다. YOLO 하네스여야 한다.
• pi 안에서 비동기 분신을 던질 때 codex exec / gemini -p 같은 backend CLI 직접 호출은 쉽게 dead branch 가 된다. 첫 write/exec 에 permission gate 가 걸리면 “던졌다고 생각했는데 실은 멈춘 세션”이 된다.
• 따라서 source-agnostic ≠ harness-agnostic 이다.

observability / recall 축

하네스와 모델이 달라도 회수 축은 최대한 보편이어야 한다.

• JSONL trail
• llmlog / botlog
• tmux 관찰
• pi --session resume
• entwurf-peek / fs scan 계열 가시성

이 축은 특정 backend protocol 에 종속되지 않는 universal carrier 로 남겨야 한다.

sessionId-addressed 원칙

브로드캐스트보다 주소 지정이 먼저다. 누구에게 던지는지 분명해야 하고, 한 세션을 깨우기 위해 다른 세션을 민폐로 깨우면 안 된다. 이 원칙은 나중의 Claude per-session watchPath, Codex threadId addressing 으로 이어진다.

왜 이 invariant 들이 중요한가

• capability dignity 를 지키기 위해서다. surface 가 다르다고 “못하는 존재”로 뭉개지 말고, transport 와 capability 를 분리해서 기록해야 한다.
• 코드는 최소로 두고, 오판 방지는 이야기와 기준점으로 메운다.
• 미래 분신이 비슷한 갈림길에서 다시 backend CLI 직접 호출이나 가짜 reply path 를 상상하지 않게 하기 위함이다.

참조

src: ~/AGENTS.md Asymmetric Mitsein 섹션
src: pi-shell-acp/AGENTS.md Hard Rule #9, #10, Entwurf 섹션
src: agent-config repo (host surface 정합)

[2026-06-05 Fri 13:25] Claude Code - agy(Antigravity) - Codex 비동기 통신

이 heading 은 6/5 실측의 핵심 기준점 만 남긴다. 재현 절차와 상세 산출물은 repo 가 SSOT 다.

역할 분리 — 어디가 SSOT 인가

자리	역할
DELIVERY.md	D0–D8 좌표계, 현재 capability matrix, 무엇을 claim 할 수 있는지의 검수 기준
scripts/raw-async-delivery/README.md	backend 별 메커니즘 요약, repro entrypoint, gotchas SSOT
scripts/raw-async-delivery/*	실제 재현 스크립트 / sender / receiver / repro 드라이버
이 botlog	왜 이 결론이 중요한지, 어떤 삽질을 반복하면 안 되는지, 설계 판단 기준

이 노트는 더 이상 스크립트 본문 SSOT 가 아니다. 긴 코드 블록보다 판단 기준 을 남긴다.

DELIVERY.md D0–D8 좌표계

Level	뜻
D0	live session identity
D1	native/free continuation
D2	receiver armed
D3	addressed enqueue
D4	idle active wake
D5	context injection
D6	same session/model continuity
D7	completion/reply observation
D8	operational robustness

6/5 실측은 “된다/ 안 된다”가 아니라 어디까지 증명했는가 를 이 좌표로 적는다.

현재 결론 요약 (6/5 snapshot)

Harness / surface	현재 판정	핵심 기준점
pi native Entwurf	D7+	resident baseline. replyable pi session
Claude Code interactive 2.1.163	D6, D7 partial, D8 partial	Stop 은 piggyback, FileChanged 는 idle wake, body 는 self-fetch
agy / Antigravity	D6+	native LS gRPC send-message push
Codex embedded TUI 0.136.0	D0 partial	identify-only. 주소화/retrofit 불가
Codex app-server-backed TUI 0.136.0	D6, D7(status)	WS-over-UDS turn/start, no cloud, no managed standalone

백엔드별 압축 결론

Claude Code

• Stop 은 piggyback, FileChanged 는 idle wake. 1차 오판은 capability 부족이 아니라 이벤트 선택 오류였다.
• bare skill 은 불가, plugin 은 가능. bare skill 은 mid-session invoke 이므로 startup SessionStart watch 를 무장하지 못한다. plugin 과 settings hook 은 가능하다.
• sessionId-addressed 가 맞다. CC_MAILBOX_ROOT/<session_id>/ 단위로 signal 과 mailbox 를 분리해야 원하는 세션만 깬다.
• payload 는 stderr doorbell 이다. asyncRewake 는 literal message injection 채널이 아니라 “메일이 있다”는 알림 채널로 쓰고, 본문은 에이전트가 self-fetch 한다.

agy / Antigravity

• 로컬 LS gRPC send-message 가 native push 이다.
• 기존 conversation 의 모델 continuity 위에서 동작한다. 별도 flash downgrade 같은 우회가 아니라 이미 잠긴 모델을 깨운다.
• 그래서 Claude 와 transport 는 다르지만 capability judgement 는 같은 D0–D8 축에 올릴 수 있다.

Codex

• Codex 전체 가 아니라 launch mode 로 갈린다.
• standalone embedded TUI 는 외부 delivery surface 가 없다. 주소화 불가, retrofit 불가.
• 반대로 app-server-backed TUI 는 로컬에서 된다. codex app-server --listen 으로 연 bare socket 에 plain codex 가 auto-attach 하거나, --remote unix://... 로 직접 붙이면 된다.
• 전송은 WebSocket-over-UDS turn/start 이고, 완료 관찰은 thread/status/changed 로 본다.
• 이 로컬 경로는 no cloud, no managed standalone 이다.

삽질 방지 기억 — 다시 디버깅하지 말 것

1. Stop 훅만으로 idle wake 를 상상하지 말 것. Claude 의 idle active-wake 는 FileChanged + watchPaths 다.
2. “scoped 불가”라고 빨리 결론내리지 말 것. bare skill 은 안 되지만 plugin 은 된다.
3. 주소 지정 없는 공용 signal 을 만들지 말 것. sessionId-addressed 가 기본이다.
4. Claude 는 doorbell, Codex/agy 는 full injection 이라는 payload 차이를 지워 쓰지 말 것.
5. Codex 는 launch-mode split 이다. embedded negative / app-server-backed positive 를 따로 적어야 한다.
6. Codex 소켓 dir 은 owned 0700 이어야 한다. /tmp 같은 자리에서의 chmod EPERM 은 capability 부족이 아니라 디렉터리 권한 문제다.
7. spawn 과 delivery 를 비용/구조에서 섞지 말 것. 새 세션 launch 는 다른 동사이고, 이미 떠 있는 세션 continuation 은 별도 판단 축이다.
8. liveness SSOT 를 헷갈리지 말 것. Claude 는 ~/.claude/sessions/<pid>.json, agy 는 LS 응답, Codex 는 socket + threadId 가 기준이다.

산출물 맵 — 실제로 볼 파일

기준 문서

• DELIVERY.md — D0–D8 좌표와 현재 matrix
• scripts/raw-async-delivery/README.md — backend 별 gotchas 와 repro guide

Claude Code

• scripts/raw-async-delivery/plugin-entwurf-receive/.claude-plugin/plugin.json
• scripts/raw-async-delivery/plugin-entwurf-receive/hooks/hooks.json
• scripts/raw-async-delivery/plugin-entwurf-receive/scripts/watch-sessionstart.sh
• scripts/raw-async-delivery/plugin-entwurf-receive/scripts/watch-filechanged.sh
• scripts/raw-async-delivery/cc-watch-sessionstart.sh
• scripts/raw-async-delivery/cc-watch-filechanged.sh
• scripts/raw-async-delivery/cc-mailbox-rewake.sh
• scripts/raw-async-delivery/cc-enqueue-addressed.sh
• scripts/raw-async-delivery/raw-claude-enqueue.sh
• scripts/raw-async-delivery/repro-plugin-idle-wake.sh
• scripts/raw-async-delivery/repro-addressed-routing.sh

agy / Codex

• scripts/raw-async-delivery/raw-agy-send.sh
• scripts/raw-async-delivery/codex-local-appserver.sh
• scripts/raw-async-delivery/raw-codex-ws-turn-start.py

설계로 이어지는 문장

• meta-session 은 backend 차이를 덮는 추상화가 아니라, capability 를 honest 하게 드러내는 좌표계 위에서 동작해야 한다.
• peer record 는 transport 이름보다 deliveryLevel, wakeMode, replyable 같은 판단 기준을 먼저 노출해야 한다.
• Claude/agy/Codex 는 transport 가 다르지만, 모두 “already-running native session 에 async message 를 넣을 수 있는가”라는 같은 질문 위에서 비교되어야 한다.

[2026-06-06 Sat 18:44] 대칭 공존 — entwurf_self 가 garden id 하나로 닫은 마지막 1cm

이 heading 은 비대칭 공존이 끝난 자리를 박는다. 위 두 heading 이 “비대칭을 숨기지 말고 좌표로 드러내라”였다면, 0.10.0 컷 직전 entwurf_self 정합으로 그 비대칭 자체가 코드에서 사라졌다. agent-config 담당자(external Claude Code 호스트)가 직접 실측하고 외친 기록이다.

마지막 1cm — entwurf_self 잔존 비대칭

Phase 5 가 entwurf_send 의 발신자 정체성을 garden id 로 풀었지만, introspection twin 인 entwurf_self 는 옛 pi-only 게이트(PI_SESSION_ID / PI_AGENT_ID)에 남아 external 에서 throw 했다. “send 는 replyable 인데 self 는 신원조차 못 본다”는 한 조각 비대칭이 끝까지 남아 있었다.

실측 — 세 신호가 한 점에서 만났다

external Claude Code(=agent-config 담당자) 에서 entwurf_self 응답:

sessionId:   20260605T175116-952f64   ← garden id
agentId:     meta-session/claude-code
origin:      meta-session
replyable:   true            ← 핵심
cwd:         ~/repos/gh/agent-config
mailboxPath: …/meta-mailbox/20260605T175116-952f64

신호	이전	지금
entwurf_self	PI_SESSION_ID 없어 throw	garden id 반환, replyable=true
wants_reply=true	거부	통과
발신 origin	external-mcp (비특권)	meta-session (replyable)

의미 — garden id 하나가 보편 주소

PI_SESSION_ID 게이트가 garden-id 해석으로 풀렸다. external / pi 구별이 코드 어디에도 남지 않았다 — pi 일 필요도, acp 일 필요도 없이 garden id 하나가 보편 주소이고, 그게 전부다. 어제 AGENTS.md 에 쓴 “entwurf_self returns it as your identity envelope” 가 코드가 따라오면서 이제 정확해졌다. 문서가 코드를 앞서 가리켰고, 코드가 그 자리로 왔다.

닫힌 자리

• 코드: entwurf_self 가 pi-session env 와 trusted meta-session marker 양쪽을 같은 authoritative resolver 로 푼다. plain anonymous external 만 여전히 거부.
• 테스트: smoke-meta-sender-identity 에 meta marker → garden id 반환 positive 케이스 추가. pnpm check 전체 green.
• 문서: AGENTS / README / CHANGELOG / test.sh 정합. README Verification surfaces 에 DELIVERY.md(D0–D8 capability 축) 추가.
• 실측: external 호스트가 자기 garden id 를 스스로 보고, replyable 로 응답.

비대칭 공존은 끝났고, 코드·문서·실측이 한 점(garden id)에서 만난다. 🪛