@elyun/bylane 1.32.0 → 1.34.0

package/README.md

@@ -486,17 +486,45 @@ respond-loop    독립: 5분 주기 리뷰 코멘트 감지
 }
 ```
 
-### Slack 웹훅 설정
+### Slack 웹훅 설정 (Workflow Builder)
 
-1. [Slack API](https://api.slack.com/apps) → **Create New App** → **Incoming Webhooks** 활성화
-2. **Add New Webhook to Workspace** → 채널 선택 → Webhook URL 복사
-3. `.bylane/bylane.json`에 입력:
+**1. Workflow 생성**
+
+Slack → **Automations** → **New Workflow** → **Start from scratch**
+트리거: **Webhook**
+
+**2. 변수 스키마 정의**
+
+웹훅 트리거 설정에서 아래 변수를 추가:
+
+| 변수명 | 타입 |
+|--------|------|
+| `title` | 텍스트 |
+| `status` | 텍스트 |
+| `url` | 텍스트 |
+| `elapsed` | 텍스트 |
+| `reason` | 텍스트 |
+
+**3. 메시지 단계 추가**
+
+"Send a message" 단계에서 변수 참조:
+```
+{{title}} — {{status}}
+{{url}}
+{{elapsed}}{{reason}}
+```
+
+**4. Workflow 게시 후 Webhook URL 복사**
+
+URL 형식: `https://hooks.slack.com/workflows/...`
+
+**5. `.bylane/bylane.json`에 입력**
 
 ```json
 "notifications": {
   "slack": {
     "enabled": true,
-    "webhookUrl": "https://hooks.slack.com/services/T.../B.../..."
+    "webhookUrl": "https://hooks.slack.com/workflows/..."
   }
 }
 ```

package/commands/bylane-notify-agent.md

@@ -38,21 +38,44 @@ PR: PR_URL
 
 ### Slack 알림 (notifications.slack.enabled: true)
 
-`config.notifications.slack.webhookUrl`로 Incoming Webhook POST:
+Slack Workflow Builder 웹훅으로 POST한다.
+Workflow에 정의된 변수 스키마와 페이로드 키가 일치해야 한다.
 
 ```bash
-# 완료 메시지
+# 완료 (type: completed)
 curl -s -X POST "$SLACK_WEBHOOK_URL" \
   -H "Content-Type: application/json" \
-  -d '{"text":"[byLane] ✅ 완료: TITLE\nPR: PR_URL | 소요 시간: ELAPSED"}'
-
-# 개입 필요 메시지
+  -d "{
+    \"title\": \"TITLE\",
+    \"status\": \"completed\",
+    \"url\": \"PR_URL\",
+    \"elapsed\": \"ELAPSED\",
+    \"reason\": \"\"
+  }"
+
+# 개입 필요 (type: escalated / error)
 curl -s -X POST "$SLACK_WEBHOOK_URL" \
   -H "Content-Type: application/json" \
-  -d '{"text":"[byLane] ⚠️ 개입 필요: TITLE\n이유: REASON | 확인: PR_URL"}'
+  -d "{
+    \"title\": \"TITLE\",
+    \"status\": \"escalated\",
+    \"url\": \"PR_URL\",
+    \"elapsed\": \"\",
+    \"reason\": \"REASON\"
+  }"
 ```
 
-`webhookUrl`이 비어 있으면 Slack 알림을 건너뜬다.
+Workflow Builder에서 정의해야 할 변수 스키마:
+
+| 변수명 | 타입 | 설명 |
+|--------|------|------|
+| `title` | 텍스트 | 작업 제목 |
+| `status` | 텍스트 | `completed` / `escalated` / `error` |
+| `url` | 텍스트 | GitHub PR/Issue URL |
+| `elapsed` | 텍스트 | 소요 시간 (완료 시) |
+| `reason` | 텍스트 | 실패/에스컬레이션 이유 |
+
+`webhookUrl`이 비어 있으면 Slack 알림을 건너뛴다.
 
 ### Telegram 알림 (notifications.telegram.enabled: true)
 

package/commands/bylane-review-agent.md

@@ -18,17 +18,25 @@ description: PR의 diff를 파일별로 분석하여 코드 라인별 인라인
 
 ## GitHub 리뷰 템플릿 탐지
 
-bylane 설정보다 먼저 프로젝트 내 GitHub 리뷰 템플릿을 탐색한다:
+다음 순서로 탐색한다. 먼저 발견된 파일을 **최우선**으로 따른다:
 
 ```bash
+# 1순위: 프로젝트 .github/ 커스텀 템플릿
 ls .github/REVIEW_TEMPLATE.md \
    .github/review_template.md \
    .github/CODE_REVIEW_TEMPLATE.md \
    docs/REVIEW_TEMPLATE.md 2>/dev/null | head -1
+
+# 2순위: 프로젝트 .bylane/ 설치 템플릿 (bylane setup 시 설치됨)
+# .bylane/templates/review-template.md
+
+# 3순위: 글로벌 fallback (~/.claude/templates/bylane/review-template.md)
 ```
 
-GitHub 템플릿이 있으면 해당 형식을 **최우선**으로 따른다.
-없으면 `templates/review-template.md`를 사용한다.
+우선순위 요약:
+1. `.github/` 내 커스텀 템플릿 (프로젝트별 재정의)
+2. `.bylane/templates/review-template.md` (프로젝트 기본값)
+3. `~/.claude/templates/bylane/review-template.md` (글로벌 기본값)
 
 ## 검사 항목 선택
 

package/commands/bylane-setup.md

@@ -10,9 +10,10 @@ ALWAYS complete all 8 steps before saving. NEVER skip steps.
 
 ## 실행 전 준비
 
-1. `.bylane/` 디렉토리가 없으면 생성:
+1. `.bylane/` 디렉토리가 없으면 생성하고 기본 템플릿을 설치:
    ```bash
    mkdir -p .bylane/state
+   npx @elyun/bylane templates install
    ```
 
 2. 기존 bylane.json 있으면 현재 설정을 로드해 기본값으로 사용.

package/package.json

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

package/src/cli.js

@@ -18,8 +18,9 @@ const USER_CONFIG_FILES = [
 ]
 
 const TARGETS = [
-  { src: join(ROOT, 'commands'), dest: join(CLAUDE_DIR, 'commands'), label: 'Commands' },
-  { src: join(ROOT, 'hooks'),    dest: join(CLAUDE_DIR, 'hooks'),    label: 'Hooks' },
+  { src: join(ROOT, 'commands'),  dest: join(CLAUDE_DIR, 'commands'),             label: 'Commands' },
+  { src: join(ROOT, 'hooks'),     dest: join(CLAUDE_DIR, 'hooks'),                label: 'Hooks' },
+  { src: join(ROOT, 'templates'), dest: join(CLAUDE_DIR, 'templates', 'bylane'),  label: 'Templates' },
 ]
 
 function backupAndCopy(src, dest, file, label) {
@@ -369,6 +370,35 @@ if (command === 'install') {
     console.error('사용법: bylane loop <start|stop|status>')
     process.exit(1)
   }
+} else if (command === 'templates') {
+  const subCmd = args[1] || 'install'
+  if (subCmd === 'install') {
+    const globalTemplatesDir = join(CLAUDE_DIR, 'templates', 'bylane')
+    const projectTemplatesDir = join('.bylane', 'templates')
+    if (!existsSync(globalTemplatesDir)) {
+      console.error('  글로벌 템플릿이 없습니다. 먼저 npx @elyun/bylane install 을 실행하세요.')
+      process.exit(1)
+    }
+    mkdirSync(projectTemplatesDir, { recursive: true })
+    const files = readdirSync(globalTemplatesDir)
+    let copied = 0
+    for (const file of files) {
+      const dest = join(projectTemplatesDir, file)
+      if (!existsSync(dest)) {
+        copyFileSync(join(globalTemplatesDir, file), dest)
+        console.log(`  + Templates: ${file}`)
+        copied++
+      } else {
+        console.log(`  = Templates: ${file} (이미 존재, 건너뜀)`)
+      }
+    }
+    console.log(copied > 0
+      ? `\n  템플릿 ${copied}개가 .bylane/templates/ 에 설치되었습니다.`
+      : '\n  모든 템플릿이 이미 설치되어 있습니다.')
+  } else {
+    console.error('사용법: bylane templates install')
+    process.exit(1)
+  }
 } else if (command === 'monitor') {
   // 항상 현재 패키지의 모니터 실행 (버전 일치 보장)
   const monitorPath = join(__dirname, 'monitor', 'index.js')
@@ -377,6 +407,6 @@ if (command === 'install') {
   child.on('exit', code => process.exit(code ?? 0))
 } else {
   console.error(`알 수 없는 명령: ${command}`)
-  console.error('사용법: npx @elyun/bylane [install|uninstall|loop|monitor|preflight|state|memory|cleanup] [--symlink]')
+  console.error('사용법: npx @elyun/bylane [install|uninstall|loop|monitor|preflight|state|memory|cleanup|templates] [--symlink]')
   process.exit(1)
 }

package/src/config.js

@@ -72,7 +72,7 @@ export const DEFAULT_CONFIG = {
     includeModel: true,
     includeCodeExample: true,
     autoApprove: false,
-    templateFile: '',
+    templateFile: '.bylane/templates/review-template.md',
     severityEmoji: {
       CRITICAL: '[CRITICAL]',
       HIGH: '[HIGH]',

package/src/loop-utils.js

@@ -97,11 +97,64 @@ export function isTmuxSessionAlive(sessionName) {
   }
 }
 
+/**
+ * tmux 세션의 두 루프가 정상 기동됐는지 검증한다.
+ * state 파일에 running 상태가 기록될 때까지 최대 timeoutMs 대기.
+ * @param {string} sessionName
+ * @param {string} stateDir
+ * @param {number} timeoutMs
+ * @returns {{ ok: boolean, review: object, respond: object }}
+ */
+export function verifyTmuxLoops(sessionName = 'bylane-loops', stateDir = '.bylane/state', timeoutMs = 8000) {
+  const loops = ['review-loop', 'respond-loop']
+  const result = {}
+
+  // 1. tmux 세션 및 윈도우 존재 확인
+  if (!isTmuxSessionAlive(sessionName)) {
+    return { ok: false, review: { alive: false }, respond: { alive: false } }
+  }
+
+  let windows = []
+  try {
+    const out = execSync(
+      `tmux list-windows -t ${sessionName} -F '#{window_name}'`,
+      { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }
+    ).trim()
+    windows = out.split('\n').map(w => w.trim())
+  } catch { /* 세션이 막 종료됐을 수 있음 */ }
+
+  // 2. 각 루프의 state 파일이 running 상태가 될 때까지 폴링
+  const deadline = Date.now() + timeoutMs
+  const pending = new Set(loops)
+
+  while (pending.size > 0 && Date.now() < deadline) {
+    for (const loop of [...pending]) {
+      const state = readState(loop, stateDir)
+      if (state?.status === 'running' && state?.pid) {
+        result[loop] = { alive: true, pid: state.pid, startedAt: state.startedAt }
+        pending.delete(loop)
+      }
+    }
+    if (pending.size > 0) execSync('sleep 0.5')
+  }
+
+  // 타임아웃된 루프는 실패로 처리
+  for (const loop of pending) {
+    const windowName = loop.replace('-loop', '')
+    const windowAlive = windows.includes(windowName)
+    result[loop] = { alive: false, windowAlive }
+  }
+
+  const ok = loops.every(l => result[l]?.alive)
+  return { ok, review: result['review-loop'], respond: result['respond-loop'] }
+}
+
 /**
  * tmux 세션에서 review-loop + respond-loop을 실행
  * @param {string} sessionName
+ * @param {string} stateDir
  */
-export function startTmuxLoops(sessionName = 'bylane-loops') {
+export function startTmuxLoops(sessionName = 'bylane-loops', stateDir = '.bylane/state') {
   if (isTmuxSessionAlive(sessionName)) {
     console.log(`[tmux] 세션 '${sessionName}'이 이미 실행 중입니다.`)
     return { started: false, reason: 'already_running' }
@@ -118,8 +171,21 @@ export function startTmuxLoops(sessionName = 'bylane-loops') {
     { stdio: 'inherit' }
   )
 
-  console.log(`[tmux] 세션 '${sessionName}' 시작 완료 (review-loop + respond-loop)`)
-  return { started: true, sessionName }
+  console.log(`[tmux] 세션 '${sessionName}' 시작 — 루프 기동 확인 중...`)
+  const verification = verifyTmuxLoops(sessionName, stateDir)
+
+  if (verification.ok) {
+    console.log(`[tmux] review-loop (PID: ${verification.review.pid}) ✓`)
+    console.log(`[tmux] respond-loop (PID: ${verification.respond.pid}) ✓`)
+  } else {
+    const reviewStatus = verification.review?.alive ? `✓ PID: ${verification.review.pid}` : `✗ 기동 실패 (창: ${verification.review?.windowAlive ? '있음' : '없음'})`
+    const respondStatus = verification.respond?.alive ? `✓ PID: ${verification.respond.pid}` : `✗ 기동 실패 (창: ${verification.respond?.windowAlive ? '있음' : '없음'})`
+    console.log(`[tmux] review-loop  ${reviewStatus}`)
+    console.log(`[tmux] respond-loop ${respondStatus}`)
+    console.log(`[tmux] 일부 루프가 정상 기동되지 않았습니다. tmux attach -t ${sessionName} 으로 확인하세요.`)
+  }
+
+  return { started: true, sessionName, verified: verification.ok, verification }
 }
 
 /**
@@ -174,9 +240,10 @@ export function resolveLoopMode() {
   if (mode === 'tmux') {
     try {
       execSync('which tmux', { stdio: ['pipe', 'pipe', 'pipe'] })
+      execSync('tmux -V', { stdio: ['pipe', 'pipe', 'pipe'] })
       return 'tmux'
     } catch {
-      console.log('[loop] tmux 미설치 — process 모드로 fallback합니다.')
+      console.log('[loop] tmux를 사용할 수 없음 — process 모드로 fallback합니다.')
       return 'process'
     }
   }

package/src/monitor/index.js

@@ -36,7 +36,7 @@ poller.onChange((states) => {
   pipeline.update(states, readSubagents())
   log.update(states)
   queue.update()
-  status.update()
+  status.update(lastStates)
 })
 
 // 's' — 실행 중인 루프/에이전트 선택 종료

package/src/monitor/panels/status.js

@@ -1,6 +1,14 @@
 import blessed from 'blessed'
+import { execSync } from 'child_process'
 import { loadConfig } from '../../config.js'
 
+function isTmuxAlive(sessionName) {
+  try {
+    execSync(`tmux has-session -t ${sessionName}`, { stdio: ['pipe', 'pipe', 'pipe'] })
+    return true
+  } catch { return false }
+}
+
 export function createStatusPanel(screen) {
   const box = blessed.box({
     top: '60%',
@@ -15,13 +23,35 @@ export function createStatusPanel(screen) {
   screen.append(box)
 
   return {
-    update() {
+    update(states = {}) {
       const config = loadConfig()
       const check = (v) => v ? '{green-fg}OK{/green-fg}' : '{red-fg}--{/red-fg}'
+
+      // 루프 상태
+      const reviewState = states['review-loop']
+      const respondState = states['respond-loop']
+      const loopMode = config.loop?.mode ?? 'tmux'
+      const sessionName = config.loop?.sessionName ?? 'bylane-loops'
+      const tmuxAlive = loopMode === 'tmux' ? isTmuxAlive(sessionName) : null
+
+      const loopStatus = (state) => {
+        if (!state) return '{red-fg}미실행{/red-fg}'
+        if (state.status === 'running') return `{green-fg}실행중{/green-fg} PID:${state.pid ?? '?'}`
+        if (state.status === 'stopped') return '{yellow-fg}중지됨{/yellow-fg}'
+        return `{grey-fg}${state.status ?? '알 수 없음'}{/grey-fg}`
+      }
+
       const lines = [
+        ` ── 루프 ──`,
+        ` review-loop  ${loopStatus(reviewState)}`,
+        ` respond-loop ${loopStatus(respondState)}`,
+        tmuxAlive !== null
+          ? ` tmux [${sessionName}]  ${tmuxAlive ? '{green-fg}세션 유지{/green-fg}' : '{red-fg}세션 없음{/red-fg}'}`
+          : ` 모드: process`,
+        ``,
+        ` ── 연동 ──`,
         ` GitHub      ${check(true)} 연결됨`,
         ` Linear      ${check(config.trackers.linear.enabled)} ${config.trackers.linear.enabled ? '활성' : '비활성'}`,
-        ` Figma MCP   ${check(config.extensions.figma.enabled)} ${config.extensions.figma.enabled ? '활성' : '비활성'}`,
         ` Slack       ${check(config.notifications.slack.enabled)} ${config.notifications.slack.channel || '미설정'}`,
         ` Telegram    ${check(config.notifications.telegram.enabled)} ${config.notifications.telegram.chatId || '미설정'}`,
         ``,

package/src/preflight.js

@@ -20,7 +20,18 @@ function run(cmd) {
 export function checkTmux() {
   const which = run('which tmux')
   if (!which.ok) return { ok: false, reason: 'tmux 미설치 — loop을 process 모드로 실행합니다', fix: 'brew install tmux  # 또는 https://github.com/tmux/tmux' }
-  return { ok: true, detail: which.out }
+
+  const version = run('tmux -V')
+  if (!version.ok) return { ok: false, reason: 'tmux 바이너리가 있으나 실행 불가', fix: 'tmux 재설치 또는 PATH 확인' }
+
+  // 실제 세션 생성/삭제로 동작 검증
+  const testSession = `bylane-preflight-test-${Date.now()}`
+  const create = run(`tmux new-session -d -s ${testSession}`)
+  if (!create.ok) return { ok: false, reason: `tmux 세션 생성 실패: ${create.out || '알 수 없는 오류'}`, fix: 'tmux 서버 상태 확인: tmux kill-server && tmux new-session -d -s test' }
+
+  run(`tmux kill-session -t ${testSession}`)
+
+  return { ok: true, detail: version.out }
 }
 
 function checkGhCli() {