@elyun/bylane 1.15.0 → 1.17.0

package/commands/bylane-monitor.md

@@ -19,14 +19,11 @@ Claude가 직접 실행하지 않는다. 사용자에게 아래 명령을 안내
 모니터 대시보드는 터미널에서 직접 실행하세요:
 
 ```bash
-npm run monitor
+npx @elyun/bylane monitor
 ```
 
-byLane이 설치된 디렉토리에서 실행하거나, 현재 프로젝트에서:
-
-```bash
-npm run monitor --prefix ~/.claude/bylane
-```
+> `npx`를 사용하면 항상 최신 버전 모니터가 실행됩니다.
+> 로컬 node_modules의 구버전이 실행되지 않습니다.
 
 **종료**: `q` 또는 `Ctrl+C`
 

package/commands/bylane-respond-agent.md

@@ -16,9 +16,9 @@ description: PR 리뷰 코멘트에 반박하거나 코드를 수정하여 반
 | `"api"` | REST API + `$GITHUB_TOKEN` |
 | `"auto"` (기본) | MCP → CLI → API 순서로 시도 |
 
-## GitHub 리뷰 대응 템플릿 탐지
+## 대응 템플릿 탐지
 
-답글 작성 전 프로젝트 내 대응 템플릿을 탐색한다:
+답글 작성 전 프로젝트 내 템플릿을 탐색한다:
 
 ```bash
 ls .github/REVIEW_RESPONSE_TEMPLATE.md \
@@ -26,9 +26,7 @@ ls .github/REVIEW_RESPONSE_TEMPLATE.md \
    .github/CONTRIBUTING.md 2>/dev/null | head -1
 ```
 
-- `REVIEW_RESPONSE_TEMPLATE.md`가 있으면 답글 형식을 **반드시** 따른다.
-- `CONTRIBUTING.md`가 있으면 코드 기여 가이드라인을 참고하여 대응 톤/형식을 맞춘다.
-- 없으면 기본 형식으로 작성한다.
+템플릿이 있으면 답글 형식을 따른다. 없으면 간결하게 작성한다.
 
 ## 입력
 
@@ -39,28 +37,25 @@ ls .github/REVIEW_RESPONSE_TEMPLATE.md \
 
 | 모드 | 동작 |
 |---|---|
-| `auto` (기본값, 미지정 시) | 각 코멘트를 분석하여 수정 반영 또는 반박을 **자동 판단** 후 진행 |
+| `auto` (기본, 미지정 시) | 각 코멘트를 분석하여 수정 반영 또는 반박을 자동 판단 후 진행 |
 | `accept` | 모든 코멘트를 수정 반영 |
 | `rebut` | 모든 코멘트에 반박 |
-| `manual` | 코멘트별로 사용자에게 "수정 반영할까요, 반박할까요?" 질문 후 진행 |
+| `manual` | 코멘트별로 사용자에게 선택 요청 |
 
 ### auto 모드 판단 기준
 
-각 코멘트를 분석하여:
 - **반영**: 버그 지적, 명확한 컨벤션 위반, 테스트 누락, 성능 문제
-- **반박**: 의견 차이, 이미 의도된 설계, 스펙 요구사항과 일치, 트레이드오프 판단이 필요한 경우
+- **반박**: 의견 차이, 의도된 설계, 스펙 요구사항과 일치하는 경우
 
-자동 판단 결과를 사용자에게 먼저 요약으로 보여준 뒤 실행한다:
+실행 전 요약을 먼저 보여주고 확인 후 진행:
 ```
 코멘트 #1: [반영] null 체크 누락 → 코드 수정
 코멘트 #2: [반박] 의도된 설계 (이슈 #12 참조)
-코멘트 #3: [반영] 타입 오류
 진행할까요? (y/n)
 ```
 
 ### manual 모드
 
-각 코멘트를 보여주고 사용자에게 선택을 요청:
 ```
 [코멘트 #1] null 체크가 없습니다.
 → (1) 수정 반영  (2) 반박  (3) 건너뜀
@@ -76,8 +71,7 @@ node -e "import('./src/state.js').then(({writeState})=>writeState('respond-agent
 
 ### 리뷰 코멘트 로드
 
-**MCP:**
-→ GitHub MCP `list_review_comments` 도구 사용
+**MCP:** → `list_review_comments` 도구 사용
 
 **CLI:**
 ```bash
@@ -91,16 +85,12 @@ curl -s \
   https://api.github.com/repos/OWNER/REPO/pulls/PR_NUMBER/comments
 ```
 
-### accept 모드
+### 수정 반영 (accept)
 
-1. 각 코멘트별 수정 사항 결정
-2. 코드 수정 (code-agent 서브 실행)
-3. test-agent로 검증
-4. commit-agent로 수정 커밋 (`fix: address review comments`)
-5. 코멘트에 "반영 완료" 답글 게시:
+1. 코드 수정 후 커밋 (`fix: address review comments`)
+2. 해당 코멘트에 짧은 답글 게시:
 
-   **MCP:**
-   → GitHub MCP `create_review_comment_reply` 도구 사용
+   **MCP:** → `create_review_comment_reply` 사용
 
    **CLI:**
    ```bash
@@ -116,13 +106,14 @@ curl -s \
      -d '{"body":"REPLY_BODY"}'
    ```
 
-### rebut 모드
+### 반박 (rebut)
 
-1. 각 코멘트에 근거를 기술한 반박 답글 작성:
-   - 의도적 설계 결정: 배경 설명
-   - 성능 트레이드오프: 구체적 수치 근거
-   - 스펙 요구사항과 일치하는 경우: 이슈 링크 첨부
-2. 위와 동일한 방법으로 답글 게시
+근거를 간결하게 기술한 답글 작성:
+- 의도적 설계 결정: 배경 한 줄 설명
+- 스펙 요구사항과 일치: 이슈 링크 첨부
+- 성능 트레이드오프: 수치 근거
+
+답글은 짧고 명확하게. 불필요한 서두 없이 핵심만.
 
 ## 출력
 
@@ -132,7 +123,7 @@ curl -s \
   "agent": "respond-agent",
   "status": "completed",
   "progress": 100,
-  "mode": "accept",
+  "mode": "auto",
   "resolvedComments": 3,
   "needsMoreWork": false
 }
@@ -140,4 +131,4 @@ curl -s \
 
 ## 수동 실행
 
-`/bylane respond #45` → accept/rebut 선택 프롬프트 표시
+`/bylane respond #45`

package/commands/bylane-respond-loop.md

@@ -63,7 +63,7 @@ import('./src/state.js').then(({readState, writeState}) => {
 "
 ```
 
-4. 다음 pending 항목으로 반복. pending 없으면 30초 대기 후 재확인.
+4. 다음 pending 항목으로 반복. pending 없으면 5분 대기 후 재확인 (폴러 주기와 동일).
 
 ## 큐 항목 스키마
 

package/commands/bylane-review-agent.md

@@ -1,6 +1,6 @@
 ---
 name: bylane-review-agent
-description: PR의 diff를 분석하여 코드 리뷰 코멘트를 작성한다.
+description: PR의 diff를 분석하여 코드 라인별 인라인 리뷰 코멘트를 작성한다.
 ---
 
 # Review Agent
@@ -28,35 +28,7 @@ ls .github/REVIEW_TEMPLATE.md \
 ```
 
 GitHub 템플릿이 있으면 해당 형식을 **최우선**으로 따른다.
-없으면 아래 bylane 설정의 템플릿을 사용한다.
-
-## 리뷰 템플릿 로드
-
-실행 전 `.bylane/bylane.json`의 `review` 설정 읽기:
-
-```bash
-node -e "
-import('./src/config.js').then(({loadConfig}) => {
-  const c = loadConfig()
-  console.log(JSON.stringify(c.review, null, 2))
-})
-"
-```
-
-설정 항목:
-- `model` — 리뷰에 사용할 모델 (기본: `claude-sonnet-4-6`)
-- `language` — 리뷰 언어 (기본: `ko`)
-- `includeModel` — 푸터에 모델명 포함 여부
-- `includeCodeExample` — Before/After 코드 예시 포함 여부
-- `templateFile` — 커스텀 템플릿 파일 경로 (비어있으면 `templates/review-template.md` 사용)
-- `severityEmoji` — 심각도 레이블 커스터마이즈
-- `footer` — 푸터 문자열 (`{model}`, `{date}` 치환 가능)
-
-커스텀 템플릿이 있으면 로드:
-```bash
-# templateFile이 설정된 경우
-cat TEMPLATE_FILE_PATH
-```
+없으면 `templates/review-template.md`를 사용한다.
 
 ## 검사 항목 선택
 
@@ -88,108 +60,128 @@ Enter 또는 아무것도 선택하지 않으면 → `all` (전체 검사)
 
 | 항목 | 중점 확인 사항 |
 |---|---|
-| `grammar` | 오탈자, 주석 언어 일관성, 변수/함수명 문법, 문서 일관성 |
+| `grammar` | 오탈자, 주석 언어 일관성, 변수/함수명 문법 |
 | `domain` | 비즈니스 규칙 위반, 도메인 용어 오용, 로직 정합성 |
 | `code` | 컨벤션 위반, 중복 코드, 복잡도, 불변성, 테스트 커버리지 |
-| `security` | 시크릿 노출, SQL/XSS 인젝션, 인증·인가 누락, 민감 데이터 처리 |
+| `security` | 시크릿 노출, SQL/XSS 인젝션, 인증·인가 누락 |
 | `all` | 위 4가지 전체 |
 
-선택된 항목만 집중 검사하고, 리뷰 코멘트 상단에 검사 범위를 명시한다:
+## 실행 전 상태 기록
+
+```bash
+node -e "import('./src/state.js').then(({writeState})=>writeState('review-agent',{status:'in_progress',startedAt:new Date().toISOString(),progress:0,retries:0,log:[]}))"
+```
+
+## 실행 흐름
+
+### 1. PR diff 로드
+
+**MCP:**
+→ `get_pull_request_files` + `get_pull_request` 도구 사용
+
+**CLI:**
+```bash
+gh pr diff PR_NUMBER
+gh pr view PR_NUMBER --json files,headRefName,baseRefName
 ```
-> 검사 범위: code, security
+
+**API:**
+```bash
+curl -s \
+  -H "Authorization: Bearer $GITHUB_TOKEN" \
+  https://api.github.com/repos/OWNER/REPO/pulls/PR_NUMBER/files
 ```
 
-## 입력
+### 2. 파일별 분석
 
-PR 번호 (`.bylane/state/pr-agent.json`에서 자동 로드, 또는 수동 전달)
+선택된 검사 항목 범위에서 각 변경 파일 분석:
+- 버그 가능성 (null check, 경계값, 예외 처리)
+- 타입 오류 (TypeScript)
+- 성능 이슈
+- 컨벤션 위반
+- 보안 취약점
 
-## 실행 전 상태 기록
+### 3. 인라인 코멘트 작성 (라인별 개별 등록)
+
+**핵심 원칙: 모든 지적사항은 해당 코드 라인에 직접 코멘트로 등록한다.**
+
+코멘트 본문 형식:
+```
+{제목}
+
+{설명}
 
+```suggestion
+{수정 제안 코드 (해당 라인 전체 대체)}
+```
+```
+
+- suggestion 블록은 수정 제안이 명확한 경우에만 포함
+- 한 코멘트에 한 가지 지적사항만 담는다
+- 검사 범위가 지정된 경우 첫 코멘트 또는 요약에 명시: `> 검사 범위: code, security`
+
+#### 인라인 코멘트 등록 방법
+
+**MCP:**
+→ `create_review` 도구의 `comments` 배열에 각 항목 포함
+
+**CLI (파일별 개별 등록):**
 ```bash
-node -e "import('./src/state.js').then(({writeState})=>writeState('review-agent',{status:'in_progress',startedAt:new Date().toISOString(),progress:0,retries:0,log:[]}))"
+# diff의 position 값 또는 line 번호 사용
+gh api repos/OWNER/REPO/pulls/PR_NUMBER/reviews \
+  --method POST \
+  --field body="" \
+  --field event="COMMENT" \
+  --field "comments[][path]=파일경로" \
+  --field "comments[][line]=라인번호" \
+  --field "comments[][body]=코멘트 본문"
 ```
 
-## 실행 흐름
+여러 코멘트는 `comments[]` 배열에 모두 담아 **한 번의 review 요청**으로 제출한다.
+
+**API:**
+```bash
+curl -s -X POST \
+  -H "Authorization: Bearer $GITHUB_TOKEN" \
+  -H "Content-Type: application/json" \
+  https://api.github.com/repos/OWNER/REPO/pulls/PR_NUMBER/reviews \
+  -d '{
+    "body": "요약 코멘트",
+    "event": "COMMENT",
+    "comments": [
+      {
+        "path": "src/foo.js",
+        "line": 42,
+        "body": "코멘트 본문 (suggestion 포함 가능)"
+      }
+    ]
+  }'
+```
+
+`event` 값: 지적사항이 있으면 `"REQUEST_CHANGES"`, 없으면 `"APPROVE"`, 코멘트만이면 `"COMMENT"`
 
-1. PR diff 로드:
-
-   **MCP:**
-   → GitHub MCP `get_pull_request_files` 도구 사용
-
-   **CLI:**
-   ```bash
-   gh pr diff PR_NUMBER
-   gh pr view PR_NUMBER --json files
-   ```
-
-   **API:**
-   ```bash
-   curl -s \
-     -H "Authorization: Bearer $GITHUB_TOKEN" \
-     https://api.github.com/repos/OWNER/REPO/pulls/PR_NUMBER/files
-   ```
-
-2. 변경된 파일별 분석:
-   - 버그 가능성 (null check, 경계값 등)
-   - 타입 오류 (TypeScript)
-   - 성능 이슈 (불필요한 리렌더링, 메모이제이션 누락)
-   - 코딩 컨벤션 위반
-   - 테스트 커버리지 누락
-
-3. 코멘트 작성 규칙 (템플릿 적용):
-
-   각 코멘트 형식:
-   ```
-   {severityEmoji.SEVERITY} {title}
-
-   {description}
-
-   [includeCodeExample=true인 경우]
-   **Before:**
-   ```lang
-   // 문제 코드
-   ```
-   **After:**
-   ```lang
-   // 개선 코드
-   ```
-
-   {suggestion}
-   ```
-
-   리뷰 언어(`language`)에 맞게 작성. `ko`이면 한국어, `en`이면 영어.
-
-4. 전체 요약 생성:
-   - 심각도별 건수 표
-   - 주요 발견사항
-   - 종합 의견
-   - 푸터: `review.footer`의 `{model}`을 실제 모델명으로, `{date}`를 현재 날짜로 치환
-
-5. 리뷰 제출 (CRITICAL/HIGH 없으면 `APPROVE`, 있으면 `REQUEST_CHANGES`):
-
-   **MCP:**
-   → GitHub MCP `create_review` 도구 사용
-
-   **CLI:**
-   ```bash
-   gh pr review PR_NUMBER --approve --body "REVIEW_BODY"
-   # 또는
-   gh pr review PR_NUMBER --request-changes --body "REVIEW_BODY"
-   ```
-
-   **API:**
-   ```bash
-   curl -s -X POST \
-     -H "Authorization: Bearer $GITHUB_TOKEN" \
-     -H "Content-Type: application/json" \
-     https://api.github.com/repos/OWNER/REPO/pulls/PR_NUMBER/reviews \
-     -d '{"body":"REVIEW_BODY","event":"APPROVE","comments":[]}'
-   ```
-
-6. 상태 업데이트:
-   ```bash
-   node -e "import('./src/state.js').then(({writeState})=>writeState('review-agent',{status:'completed',progress:100,approved:APPROVED_BOOL,commentCount:COMMENT_COUNT}))"
-   ```
+### 4. 전체 요약 (PR 전체 코멘트)
+
+```
+## 리뷰 요약
+
+> 검사 범위: {scope}
+
+### 주요 발견사항
+- ...
+
+### 종합 의견
+...
+```
+
+푸터: `review.footer`의 `{model}`을 실제 모델명으로, `{date}`를 현재 날짜로 치환.
+기본 푸터: `{model} · {date}`  (bylane 문구 없음)
+
+### 5. 상태 업데이트
+
+```bash
+node -e "import('./src/state.js').then(({writeState})=>writeState('review-agent',{status:'completed',progress:100,approved:APPROVED_BOOL,commentCount:COMMENT_COUNT}))"
+```
 
 ## 출력
 
@@ -199,8 +191,8 @@ node -e "import('./src/state.js').then(({writeState})=>writeState('review-agent'
   "agent": "review-agent",
   "status": "completed",
   "progress": 100,
-  "approved": true,
-  "commentCount": 3
+  "approved": false,
+  "commentCount": 5
 }
 ```
 

package/commands/bylane-review-loop.md

@@ -74,7 +74,7 @@ import('./src/state.js').then(({readState, writeState}) => {
 ```
 
 3. 다음 pending 항목으로 반복
-4. pending 없으면 30초 대기 후 재확인
+4. pending 없으면 5분 대기 후 재확인 (폴러 주기와 동일)
 
 ## 큐 항목 스키마
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elyun/bylane",
-  "version": "1.15.0",
+  "version": "1.17.0",
   "description": "Frontend development harness for Claude Code",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -12,6 +12,11 @@ const args = process.argv.slice(2)
 const command = args[0] || 'install'
 const useSymlink = args.includes('--symlink')
 
+// 사용자 설정 파일 — 절대 덮어쓰지 않는다
+const USER_CONFIG_FILES = [
+  '.bylane/bylane.json',
+]
+
 const TARGETS = [
   { src: join(ROOT, 'commands'), dest: join(CLAUDE_DIR, 'commands'), label: 'Commands' },
   { src: join(ROOT, 'hooks'),    dest: join(CLAUDE_DIR, 'hooks'),    label: 'Hooks' },
@@ -31,7 +36,7 @@ function backupAndCopy(src, dest, file, label) {
     const backupPath = `${destFile}.bak`
     renameSync(destFile, backupPath)
     copyFileSync(srcFile, destFile)
-    console.log(`  ~ ${label}: ${file} (기존 파일 -> ${file}.bak)`)
+    console.log(`  ~ ${label}: ${file} (업데이트됨, 기존 파일 -> ${file}.bak)`)
   } else {
     copyFileSync(srcFile, destFile)
     console.log(`  + ${label}: ${file}`)
@@ -48,41 +53,41 @@ function registerHooks() {
   const hookScript = join(CLAUDE_DIR, 'hooks', 'bylane-agent-tracker.js')
   settings.hooks = settings.hooks ?? {}
 
-  // PreToolUse
-  settings.hooks.PreToolUse = settings.hooks.PreToolUse ?? []
-  const preExists = settings.hooks.PreToolUse.some(h =>
-    h.hooks?.some(hh => hh.command?.includes('bylane-agent-tracker'))
-  )
-  if (!preExists) {
-    settings.hooks.PreToolUse.push({
-      matcher: 'Agent',
-      hooks: [{ type: 'command', command: `node ${hookScript} pre` }]
-    })
-    console.log('  + Hook: PreToolUse/Agent → bylane-agent-tracker')
-  } else {
-    console.log('  = Hook: PreToolUse/Agent (이미 등록됨)')
-  }
+  // 기존 bylane 훅 제거 후 재등록 (버전 업 시 경로 변경 대응)
+  const stripBylane = (arr) =>
+    (arr ?? []).filter(h => !h.hooks?.some(hh => hh.command?.includes('bylane-agent-tracker')))
 
-  // PostToolUse
-  settings.hooks.PostToolUse = settings.hooks.PostToolUse ?? []
-  const postExists = settings.hooks.PostToolUse.some(h =>
-    h.hooks?.some(hh => hh.command?.includes('bylane-agent-tracker'))
-  )
-  if (!postExists) {
-    settings.hooks.PostToolUse.push({
-      matcher: 'Agent',
-      hooks: [{ type: 'command', command: `node ${hookScript} post` }]
-    })
-    console.log('  + Hook: PostToolUse/Agent → bylane-agent-tracker')
-  } else {
-    console.log('  = Hook: PostToolUse/Agent (이미 등록됨)')
-  }
+  settings.hooks.PreToolUse = [
+    ...stripBylane(settings.hooks.PreToolUse),
+    { matcher: 'Agent', hooks: [{ type: 'command', command: `node ${hookScript} pre` }] }
+  ]
+  settings.hooks.PostToolUse = [
+    ...stripBylane(settings.hooks.PostToolUse),
+    { matcher: 'Agent', hooks: [{ type: 'command', command: `node ${hookScript} post` }] }
+  ]
 
   writeFileSync(settingsPath, JSON.stringify(settings, null, 2))
+  console.log('  ~ Hook: bylane-agent-tracker 등록 (최신 경로로 갱신)')
+}
+
+function preservedConfigs() {
+  const found = USER_CONFIG_FILES.filter(f => existsSync(f))
+  if (found.length > 0) {
+    console.log('\n  [보존된 사용자 설정]')
+    found.forEach(f => console.log(`  * ${f}`))
+  }
+}
+
+function isUpdateMode() {
+  return existsSync(join(CLAUDE_DIR, 'commands', 'bylane.md'))
 }
 
 function install() {
-  console.log('\n  byLane 설치 중...\n')
+  const updating = isUpdateMode()
+  console.log(updating
+    ? '\n  byLane 업데이트 중...\n'
+    : '\n  byLane 설치 중...\n'
+  )
 
   for (const { src, dest, label } of TARGETS) {
     mkdirSync(dest, { recursive: true })
@@ -108,8 +113,17 @@ function install() {
 
   console.log('')
   registerHooks()
+  preservedConfigs()
 
-  console.log(`
+  if (updating) {
+    console.log(`
+  byLane 업데이트 완료!
+
+  사용자 설정(.bylane/bylane.json)은 그대로 유지됩니다.
+  Claude Code를 재시작하면 변경사항이 적용됩니다.
+`)
+  } else {
+    console.log(`
   byLane 설치 완료!
 
   다음 단계:
@@ -122,12 +136,19 @@ function install() {
 
      /bylane 다크모드 토글 추가해줘
 `)
+  }
 }
 
 if (command === 'install') {
   install()
+} else if (command === 'monitor') {
+  // 항상 현재 패키지의 모니터 실행 (버전 일치 보장)
+  const monitorPath = join(__dirname, 'monitor', 'index.js')
+  const { spawn } = await import('child_process')
+  const child = spawn(process.execPath, [monitorPath], { stdio: 'inherit' })
+  child.on('exit', code => process.exit(code ?? 0))
 } else {
   console.error(`알 수 없는 명령: ${command}`)
-  console.error('사용법: npx bylane [install] [--symlink]')
+  console.error('사용법: npx @elyun/bylane [install|monitor] [--symlink]')
   process.exit(1)
 }

package/src/monitor/index.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import blessed from 'blessed'
 import { createLayout } from './layout.js'
 import { createPoller } from './poller.js'
 import { existsSync, readFileSync, writeFileSync, unlinkSync, mkdirSync } from 'fs'
@@ -9,6 +10,7 @@ const poller = createPoller()
 
 const startTime = Date.now()
 const STATE_DIR = '.bylane/state'
+let lastStates = {}
 const SUBAGENTS_FILE = join(STATE_DIR, 'subagents.json')
 const CANCEL_FILE = join(STATE_DIR, 'cancel.json')
 
@@ -20,6 +22,7 @@ function readSubagents() {
 onCleanup(() => poller.stop())
 
 poller.onChange((states) => {
+  lastStates = states
   const active = Object.values(states).find(s => s.status === 'in_progress')
   const workflowTitle = active ? (active.currentTask ?? active.agent) : 'Idle'
 
@@ -34,8 +37,71 @@ poller.onChange((states) => {
   status.update()
 })
 
+// 's' — 실행 중인 루프 선택 종료
+screen.key('s', () => {
+  const runningLoops = Object.entries(lastStates)
+    .filter(([name, s]) => name.endsWith('-loop') && s?.status === 'running' && s?.pid)
+    .map(([name, s]) => ({ name, pid: s.pid }))
+
+  if (runningLoops.length === 0) {
+    header.update({
+      workflowTitle: '실행 중인 루프 없음',
+      time: new Date().toLocaleTimeString('ko-KR', { hour12: false }),
+      elapsed: `${Math.floor((Date.now() - startTime) / 1000)}s`
+    })
+    screen.render()
+    return
+  }
+
+  // blessed list 오버레이
+  const list = blessed.list({
+    top: 'center',
+    left: 'center',
+    width: 40,
+    height: runningLoops.length + 4,
+    label: ' 종료할 루프 선택 (Enter/Esc) ',
+    tags: true,
+    border: { type: 'line' },
+    style: {
+      border: { fg: 'yellow' },
+      selected: { bg: 'blue', fg: 'white' },
+      item: { fg: 'white' }
+    },
+    keys: true,
+    items: runningLoops.map(l => ` ${l.name}  (PID: ${l.pid})`)
+  })
+
+  screen.append(list)
+  list.focus()
+  screen.render()
+
+  list.on('select', (item, idx) => {
+    const loop = runningLoops[idx]
+    try {
+      process.kill(loop.pid, 'SIGTERM')
+      header.update({
+        workflowTitle: `${loop.name} 종료 요청됨 (PID: ${loop.pid})`,
+        time: new Date().toLocaleTimeString('ko-KR', { hour12: false }),
+        elapsed: `${Math.floor((Date.now() - startTime) / 1000)}s`
+      })
+    } catch {
+      header.update({
+        workflowTitle: `${loop.name} 종료 실패 (이미 종료됨?)`,
+        time: new Date().toLocaleTimeString('ko-KR', { hour12: false }),
+        elapsed: `${Math.floor((Date.now() - startTime) / 1000)}s`
+      })
+    }
+    screen.remove(list)
+    screen.render()
+  })
+
+  list.key(['escape', 'q'], () => {
+    screen.remove(list)
+    screen.render()
+  })
+})
+
 // 'c' — 하위 에이전트 취소 플래그 토글
-const cancelLabel = () => existsSync(CANCEL_FILE) ? '[취소 활성]' : ''
 screen.key('c', () => {
   if (existsSync(CANCEL_FILE)) {
     unlinkSync(CANCEL_FILE)

package/src/monitor/layout.js

@@ -9,9 +9,48 @@ export function createLayout() {
   const screen = blessed.screen({
     smartCSR: true,
     fullUnicode: true,
+    dockBorders: true,
     title: 'byLane Monitor'
   })
 
+  // 최소 크기 경고 오버레이
+  const tooSmall = blessed.box({
+    top: 'center',
+    left: 'center',
+    width: 40,
+    height: 5,
+    content: '\n  터미널이 너무 작습니다.\n  최소 80×24 이상으로 키워주세요.',
+    align: 'center',
+    tags: true,
+    border: { type: 'line' },
+    style: { fg: 'white', bg: 'red', border: { fg: 'white' } },
+    hidden: true
+  })
+  screen.append(tooSmall)
+
+  function checkSize() {
+    const cols = screen.width
+    const rows = screen.height
+    if (cols < 80 || rows < 24) {
+      tooSmall.show()
+    } else {
+      tooSmall.hide()
+    }
+    screen.render()
+  }
+
+  screen.on('resize', () => {
+    // 약간의 지연으로 tmux/pane 리사이즈 완료 후 렌더링
+    setTimeout(() => {
+      screen.alloc()
+      screen.render()
+      checkSize()
+    }, 50)
+  })
+
+  // 초기 크기 체크
+  process.nextTick(checkSize)
+
   const header = createHeader(screen)
   const pipeline = createPipelinePanel(screen)
   const log = createLogPanel(screen)
@@ -23,7 +62,7 @@ export function createLayout() {
     left: 0,
     width: '100%',
     height: 1,
-    content: ' [q]종료  [c]에이전트취소토글  [Tab]포커스  [j/k]로그스크롤',
+    content: ' [q]종료  [c]에이전트취소토글  [s]루프종료  [Tab]포커스  [j/k]로그스크롤',
     style: { fg: 'black', bg: 'cyan' }
   })
   screen.append(footer)

package/src/respond-loop.js

@@ -186,5 +186,5 @@ process.on('SIGTERM', () => {
   process.exit(0)
 })
 
-writeState('respond-loop', { status: 'running', startedAt: new Date().toISOString() }, STATE_DIR)
+writeState('respond-loop', { status: 'running', startedAt: new Date().toISOString(), pid: process.pid }, STATE_DIR)
 console.log('respond-loop 시작. Ctrl+C로 종료.')

package/src/review-loop.js

@@ -133,5 +133,5 @@ process.on('SIGTERM', () => {
   process.exit(0)
 })
 
-writeState('review-loop', { status: 'running', startedAt: new Date().toISOString() }, STATE_DIR)
+writeState('review-loop', { status: 'running', startedAt: new Date().toISOString(), pid: process.pid }, STATE_DIR)
 console.log('review-loop 시작. Ctrl+C로 종료.')

package/templates/review-template.md

@@ -1,86 +1,56 @@
-# byLane 리뷰 템플릿
+# 리뷰 템플릿
 
 이 파일을 복사해 프로젝트별로 커스터마이즈하세요.
 `.bylane/bylane.json`의 `review.templateFile`에 경로를 지정하면 적용됩니다.
 
 ---
 
-## 코멘트 형식
+## 인라인 코멘트 형식
 
-각 리뷰 코멘트는 아래 형식을 따릅니다:
+각 리뷰 코멘트는 **해당 코드 라인에 직접** 작성합니다.
 
 ```
-{severity} {title}
+{title}
 
 {description}
 
-{code_example}
-
-{suggestion}
+{suggestion_block}
 ```
 
 ### 필드 설명
 
-- `{severity}` — 심각도 레이블 (`[CRITICAL]` / `[HIGH]` / `[MEDIUM]` / `[LOW]`)
-- `{title}` — 문제 제목 (한 줄)
+- `{title}` — 문제 제목 (한 줄, 간결하게)
 - `{description}` — 문제 설명 및 이유
-- `{code_example}` — 문제가 있는 코드 예시 (선택, `review.includeCodeExample: false`로 비활성)
-- `{suggestion}` — 수정 방법 또는 개선 예시 코드
-
----
+- `{suggestion_block}` — GitHub suggestion 블록 (수정 제안 코드)
 
-## 심각도 기준
-
-| 심각도 | 기준 | 처리 |
-|--------|------|------|
-| CRITICAL | 버그, 보안 취약점, 데이터 손실 가능성 | 즉시 수정 필요, PR 차단 |
-| HIGH | 잘못된 로직, 성능 심각 저하 | 수정 강력 권장 |
-| MEDIUM | 코드 품질, 가독성, 테스트 누락 | 개선 권장 |
-| LOW | 네이밍, 스타일, 선택적 개선 | 참고용 |
-
----
+### suggestion 블록 형식
 
-## 코드 예시 형식
-
-**Before (문제 코드):**
-```language
-// 문제가 있는 코드
+````
+```suggestion
+// 수정된 코드 (원본 라인을 그대로 대체)
 ```
+````
 
-**After (수정 제안):**
-```language
-// 개선된 코드
-```
+GitHub에서 "Apply suggestion" 버튼으로 바로 적용 가능합니다.
 
 ---
 
-## 전체 리뷰 요약 형식
+## 전체 요약 형식 (PR 전체 코멘트)
 
 ```
-## 코드 리뷰 요약
-
-| 심각도 | 건수 |
-|--------|------|
-| CRITICAL | N |
-| HIGH | N |
-| MEDIUM | N |
-| LOW | N |
+## 리뷰 요약
 
 ### 주요 발견사항
 - ...
 
 ### 종합 의견
 ...
-
----
-{footer}
 ```
 
 ---
 
 ## 푸터
 
-기본값: `Reviewed by byLane · model: {model}`
+기본값: `{model} · {date}`
 
-`{model}` — 실제 사용된 모델명으로 자동 치환됩니다.
-커스터마이즈 예시: `AI 리뷰 by byLane (claude-sonnet-4-6) · {date}`
+`{model}`, `{date}` — 실제 모델명과 날짜로 자동 치환됩니다.