monitor-patterns

Monitor Patterns Skill

OMP 2.1.x Monitor tool을 활용한 pane 이벤트 스트리밍 패턴. 주 사용처는 orchestra Round 2 응답 대기(idea.md Step 3.6).

1. Monitor Tool 개요

Monitor는 실행 중인 command의 stdout을 실시간 tail하여 각 라인을 notification으로 전달한다. until-loop/polling sleep 보다 저렴하다 — 대기 중 토큰 소비 없음.

기본 호출:

Monitor(
  command = "...",
  timeout_ms = 180000
)

반환값: notification stream (stdout의 각 라인이 1개 이벤트).

활성화 조건: AUTOPUS_PLATFORM == claude-code AND features.cc21.monitor_enabled: true. 비 OMP CLI 환경에서는 polling fallback으로 graceful degradation (R8).

2. grep --line-buffered 요구사항

Monitor가 실시간으로 라인을 수신하려면 command가 line-buffered 모드로 출력해야 한다. stdout이 pipe 앞단이면 기본값은 fully-buffered — 이벤트가 버퍼 flush 전까지 지연된다.

올바른 패턴

# GNU grep (Linux 기본값, macOS Homebrew grep)
grep --line-buffered -E 'pattern'

# BSD grep (macOS 기본값) — stdbuf로 강제 line-buffering
stdbuf -oL grep -E 'pattern'

# Universal fallback — unbuffer (expect 패키지)
unbuffer grep -E 'pattern'

잘못된 패턴 — Monitor가 실시간 이벤트를 받지 못함

grep -E 'pattern'          # fully-buffered 기본값 — 이벤트 지연
cat file | grep 'pattern'  # grep 자체도 line-buffered 필요

3. 플랫폼 감지 및 분기 템플릿

# Detect GNU vs BSD grep and set GREP_LB accordingly
if grep --version 2>/dev/null | grep -qi "gnu grep"; then
  GREP_LB="grep --line-buffered"
else
  GREP_LB="stdbuf -oL grep"
fi

Monitor 호출 시 적용:

Monitor(
  command = f"cmux read-screen --surface {surface_id} --follow --scrollback 200 | {GREP_LB} -E '{idle_regex}'",
  timeout_ms = 180000
)

4. Provider별 idle prompt 정규식

spec.md R7 정의. provider pane이 응답을 마치고 입력 대기 상태에 진입하면 해당 라인이 stdout으로 출력된다.

Provider	Pattern
claude	^❯\s*$
codex	^codex>\s*$
antigravity-cli	^>\s*(Type your|Press Ctrl) 또는 gemini>\s*$
opencode	^opencode›\s*$ 또는 ^>\s*Ready\s*$

오버라이드

.autopus/project/orchestra-patterns.yaml:

orchestra_patterns:
  claude:
    idle: '^❯\s*$'
  codex:
    idle: '^codex>\s*$'
  antigravity-cli:
    idle: '^>\s*(Type your|Press Ctrl)'
  opencode:
    idle: '^opencode›\s*$'