@elyun/bylane 1.33.0 → 1.35.0

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.33.0",
+  "version": "1.35.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) {
@@ -285,14 +286,14 @@ if (command === 'install') {
     const mode = resolveLoopMode()
 
     if (mode === 'tmux') {
-      startTmuxLoops(sessionName)
+      startTmuxLoops(sessionName, { packageRoot: ROOT, projectDir: process.cwd() })
       console.log(`\n  tmux 세션에 접속하려면: tmux attach -t ${sessionName}\n`)
     } else {
       // process 모드: 현재 프로세스에서 직접 실행
       console.log('\n  process 모드: review-loop + respond-loop 실행\n')
       const { spawn } = await import('child_process')
-      const review = spawn(process.execPath, ['src/review-loop.js'], { stdio: 'inherit', detached: false })
-      const respond = spawn(process.execPath, ['src/respond-loop.js'], { stdio: 'inherit', detached: false })
+      const review = spawn(process.execPath, [join(ROOT, 'src', 'review-loop.js')], { stdio: 'inherit', detached: false, cwd: process.cwd() })
+      const respond = spawn(process.execPath, [join(ROOT, 'src', 'respond-loop.js')], { stdio: 'inherit', detached: false, cwd: process.cwd() })
 
       function shutdownAll() {
         review.kill('SIGTERM')
@@ -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

@@ -3,6 +3,7 @@
  * 루프 프로세스 공통 유틸
  */
 import { execSync } from 'child_process'
+import { join } from 'path'
 import { readState, writeState } from './state.js'
 import { loadConfig } from './config.js'
 
@@ -97,29 +98,107 @@ 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 {object} opts
+ * @param {string} [opts.stateDir]      상태 디렉토리 (상대경로)
+ * @param {string} [opts.packageRoot]   패키지 루트 경로 (스크립트 절대경로 해석용)
+ * @param {string} [opts.projectDir]    프로젝트 디렉토리 (tmux CWD, .bylane/ 기준)
  */
-export function startTmuxLoops(sessionName = 'bylane-loops') {
+export function startTmuxLoops(sessionName = 'bylane-loops', opts = {}) {
+  const {
+    stateDir = '.bylane/state',
+    packageRoot = process.cwd(),
+    projectDir = process.cwd()
+  } = typeof opts === 'string' ? { stateDir: opts } : opts
+
   if (isTmuxSessionAlive(sessionName)) {
     console.log(`[tmux] 세션 '${sessionName}'이 이미 실행 중입니다.`)
     return { started: false, reason: 'already_running' }
   }
 
-  // 첫 번째 윈도우: review-loop
+  const reviewScript = join(packageRoot, 'src', 'review-loop.js')
+  const respondScript = join(packageRoot, 'src', 'respond-loop.js')
+
+  // 첫 번째 윈도우: review-loop (-c 로 프로젝트 디렉토리에서 실행)
   execSync(
-    `tmux new-session -d -s ${sessionName} -n review 'node src/review-loop.js'`,
+    `tmux new-session -d -s ${sessionName} -n review -c '${projectDir}' 'node ${reviewScript}'`,
     { stdio: 'inherit' }
   )
   // 두 번째 윈도우: respond-loop
   execSync(
-    `tmux new-window -t ${sessionName} -n respond 'node src/respond-loop.js'`,
+    `tmux new-window -t ${sessionName} -n respond -c '${projectDir}' 'node ${respondScript}'`,
     { 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 +253,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() {