junghan0611/entwurf-peek

entwurf-peek — 분신을 들여다보는 손

세 개의 서브커맨드. live control socket probe + 세션 JSONL header/name 스캔만으로 동작. pi-shell-acp 새 surface 없음. session-recap의 JSONL 파서 패턴 재사용.

API

python3 {baseDir}/scripts/entwurf-peek.py <subcommand> [options]

| Subcommand | Purpose | Example | |------------|---------|---------| | peek <id> | 세션 안 마지막 메시지 + 활성 여부 + caller + model/state | peek 9858a7 | | map | 살아있는 세션 전체 지도 (sockets + 최근 entwurf 파일 + child caller + compact model/state) | map -p abductcli | | trace <parent> | 부모가 던진 자식 entwurf 추적 + child compact model/state | trace 20260604T094303-842ded |

Common flags

| Flag | Where | Description | |------|-------|-------------| | --plain | global | ASCII fallback ([ACTIVE]/[IDLE]/[DONE] 대신 🔴🟡⚫) |

peek <id|file>

| Flag | Default | Description | |------|---------|-------------| | -m, --messages N | 4 | 마지막 N개 user/assistant 메시지 | | -t, --tools N | 5 | 최근 N개 inline tool 흔적 | | -c, --chars N | 200 | 요소당 최대 글자 | | --thinking | off | 최근 thinking 블록 1개 포함 |

<id>는 session selector다. canonical target 은 JSONL header id 이며, garden sessionId 전체(20260604T094309-9858a7)나 6-hex 접미사(9858a7), legacy full UUID(019dddb0-...), 직접 파일 경로를 받을 수 있다. 0.9.0부터 entwurf-xxx 같은 옛 filename/task species 는 identity authority 가 아니다.

• full id (garden 또는 UUID)는 exact match 우선
• 같은 header id가 여러 파일에 있으면 wrong-cwd duplicate footgun 으로 보고 ambiguous 에러를 낸다
• 짧은 prefix가 여러 세션과 충돌해도 최근 것으로 침묵 선택하지 않고 ambiguous 에러를 낸다

map

| Flag | Default | Description | |------|---------|-------------| | -p, --project NAME | all | cwd 디렉토리명 부분 매치 (e.g. abductcli, agent-config) | | --since SEC | 3600 | 최근 N초 이내 활동한 세션. control socket 있는 세션은 강제 포함 | | -a, --all | off | done 상태도 포함 |

활성도: <30s → 🔴 active · <5m → 🟡 idle · 5m+ → ⚫ done. 🔌 = connect() 성공한 live control socket.

trace <parent-id|file>

| Flag | Default | Description | |------|---------|-------------| | --heuristic | off | declared 매치 외 시간 인접 자식도 포함 (±2h) |

자식 매칭은 부모 JSONL의 entwurf spawn 결과 Session ID: <YYYYMMDDTHHMMSS-xxxxxx> 텍스트에서 추출 (0.9.0: 옛 Task ID: <hex> 폐기). 이게 1차 시그널. 기본 trace는 heuristic 자식을 자동 포함하지 않지만, 숨겨진 nearby candidate 개수는 보여준다.

Examples

# 진행 중 자식 분신 들여다보기 (garden 6-hex suffix)
python3 {baseDir}/scripts/entwurf-peek.py peek 9858a7

# full garden sessionId로 thinking까지 보기
python3 {baseDir}/scripts/entwurf-peek.py peek 20260604T094309-9858a7 --thinking

# 지금 살아있는 세션 전부
python3 {baseDir}/scripts/entwurf-peek.py map

# 특정 cwd만 (abductcli 부모-자식 묶어서 보기)
python3 {baseDir}/scripts/entwurf-peek.py map -p abductcli -a --since 7200

# 부모 full sessionId로 자식 entwurf 트리
python3 {baseDir}/scripts/entwurf-peek.py trace 20260604T094303-842ded

Workflow: "내가 던진 분신이 뭐 하고 있지?"

Step 1: map  →  살아있는 세션 그림 잡기
Step 2: trace <my-session-id>  →  내 자식들 식별
Step 3: peek <child-id>  →  자식 마지막 활동 확인
Step 4: 활성도가 ⚫ DONE이면 결과 회수, 🟡 IDLE이면 잠시 대기, 🔴 ACTIVE이면 진행 중

Sync entwurf로 호출자가 "Mattering..."에 묶여있을 때, 다른 세션에서 이 스킬을 돌려 자식의 실시간 상태를 확인한다. peers MCP는 control socket이 있는 세션만 보여주지만, 자식 entwurf 세션(이름 태그 entwurf)은 socket이 없어 peers에 안 잡힌다 — 이걸 메우는 도구. (0.9.0: 자식 판별 = 파일명이 아니라 session_info name 의 entwurf 태그.)

Output 규칙

• 헤더에 항상 ═══ {icon} {kind}-{short_id} ({age}) ═══ 형식 — 무엇을 보고 있는지 고정
• child (kind entwurf) 는 가능하면 caller: <kind>-<short> [declared|time_adjacent] 를 함께 보여준다 (caller 는 보통 control/plain 세션)
• peek 는 가능하면 model: provider/model + state: tool running | awaiting assistant reply | waiting for user 를 함께 보여준다
• map / trace 는 child row 끝에 · model / state compact suffix를 붙인다
• 메시지/thinking은 --chars로 자르고, 줄바꿈은 공백으로 치환 (한 줄 압축)
• inline [tool:start]/[tool:done] 텍스트는 🔧 recent tools 섹션에 별도 분리

한계 및 신뢰 경계

• 활성 판정은 mtime 기반만: 자식 entwurf 세션은 control socket이 없어서 프로세스 살아있는지 직접 못 본다. mtime이 멈춘 지 5분이면 done으로 분류 — 진짜 죽었는지 확신 못 함. control socket은 stale 파일을 세지 않고 connect() 성공한 것만 🔌로 표시한다.
• kind 판별은 session_info name 의 태그: 첫 assistant 턴 전이거나 이름이 없는 세션은 plain 으로 분류된다 (legacy uuid 세션 포함). entwurf/control 태그가 박힌 뒤에야 그 종류로 보인다.
• 부모-자식 매칭: declared(1차)는 강한 시그널. caller / --heuristic은 시간 인접만 보므로 같은 cwd에서 다른 부모가 던진 entwurf와 섞일 수 있음
• 상태 추정은 last-event heuristic: 최신 이벤트가 tool start면 tool running, tool result면 awaiting assistant reply, assistant text면 waiting for user. 오래된 orphan toolCall은 무시한다. provider별 JSONL shape가 다르면 정확도는 떨어질 수 있음
• partial line 안전: 마지막 라인이 writer-in-progress면 자동 스킵 (json decode 실패 시 무시)

Cost

| 작업 | Context | 대안 | |------|---------|------| | peek | ~2KB | raw JSONL read ~50KB | | map | ~1KB | 수동 ls+stat 조합 5+ 호출 | | trace | ~1KB | 수동 grep+ls 조합 |