@elyun/bylane 1.16.0 → 1.18.0

package/src/cleanup.js

@@ -0,0 +1,152 @@
+/**
+ * cleanup.js
+ * 상태 파일 정리, 권한 수정, 좀비 프로세스/에이전트 초기화
+ * monitor [r] 키 또는 `npx @elyun/bylane cleanup`으로 실행
+ */
+import { readdirSync, chmodSync, existsSync, unlinkSync, readFileSync, writeFileSync, mkdirSync } from 'fs'
+import { join } from 'path'
+import { readState, writeState } from './state.js'
+
+const STATE_DIR = '.bylane/state'
+const STALE_MS = 30 * 60 * 1000   // 30분 이상 in_progress → 초기화
+const SUBAGENTS_FILE = join(STATE_DIR, 'subagents.json')
+
+/** 프로세스가 살아있는지 확인 (kill -0) */
+function isPidAlive(pid) {
+  try {
+    process.kill(Number(pid), 0)
+    return true
+  } catch {
+    return false
+  }
+}
+
+/** subagents.json에서 죽은 PID 제거 */
+function cleanSubagents() {
+  if (!existsSync(SUBAGENTS_FILE)) return []
+  let data
+  try { data = JSON.parse(readFileSync(SUBAGENTS_FILE, 'utf8')) } catch { return [] }
+
+  const before = (data.active ?? []).length
+  const active = (data.active ?? []).filter(a => {
+    if (!a.pid) return false
+    return isPidAlive(a.pid)
+  })
+  const cleaned = before - active.length
+
+  if (cleaned > 0) {
+    writeFileSync(SUBAGENTS_FILE, JSON.stringify({ ...data, active }, null, 2))
+  }
+  return cleaned > 0 ? [`subagents.json: active ${before}개 → ${active.length}개 (${cleaned}개 제거)`] : []
+}
+
+/** 디렉토리 및 파일 권한 수정 */
+function fixPermissions() {
+  const fixed = []
+  try {
+    chmodSync(STATE_DIR, 0o755)
+  } catch {}
+
+  const files = existsSync(STATE_DIR)
+    ? readdirSync(STATE_DIR).filter(f => f.endsWith('.json'))
+    : []
+
+  for (const file of files) {
+    try {
+      chmodSync(join(STATE_DIR, file), 0o644)
+    } catch (e) {
+      fixed.push(`권한 수정 실패: ${file} — ${e.message}`)
+    }
+  }
+  return fixed
+}
+
+/**
+ * 전체 정리 실행
+ * @returns {{ fixed: string[], killed: string[], reset: string[], cleared: string[] }}
+ */
+export function runCleanup() {
+  const result = { fixed: [], killed: [], reset: [], cleared: [] }
+
+  if (!existsSync(STATE_DIR)) {
+    mkdirSync(STATE_DIR, { recursive: true })
+    return result
+  }
+
+  // 1. 파일 권한 수정
+  result.fixed.push(...fixPermissions())
+
+  // 2. 상태 파일 순회
+  const files = readdirSync(STATE_DIR).filter(f => f.endsWith('.json'))
+
+  for (const file of files) {
+    const name = file.replace('.json', '')
+
+    // 특수 파일 건너뜀
+    if (name === 'cancel') continue
+
+    // subagents 별도 처리
+    if (name === 'subagents') {
+      result.cleared.push(...cleanSubagents())
+      continue
+    }
+
+    const state = readState(name, STATE_DIR)
+    if (!state) continue
+
+    // 루프: PID가 죽었으면 stopped로 전환
+    if (name.endsWith('-loop') && state.pid && state.status === 'running') {
+      if (!isPidAlive(state.pid)) {
+        writeState(name, { ...state, status: 'stopped', stoppedAt: new Date().toISOString() }, STATE_DIR)
+        result.killed.push(`${name}: PID ${state.pid} 없음 → stopped`)
+      }
+    }
+
+    // in_progress 상태가 30분 이상 → failed로 초기화
+    if (state.status === 'in_progress' && state.startedAt) {
+      const age = Date.now() - new Date(state.startedAt).getTime()
+      if (age > STALE_MS) {
+        writeState(name, {
+          ...state,
+          status: 'failed',
+          error: `stale: ${Math.floor(age / 60000)}분 초과 in_progress`
+        }, STATE_DIR)
+        result.reset.push(`${name}: ${Math.floor(age / 60000)}분 in_progress → failed`)
+      }
+    }
+
+    // 큐 파일: responding/reviewing 상태가 남아있으면 pending으로 복구
+    if ((name === 'review-queue' || name === 'respond-queue') && Array.isArray(state.queue)) {
+      const fixed = state.queue.map(item =>
+        item.status === 'reviewing' || item.status === 'responding'
+          ? { ...item, status: 'pending', recoveredAt: new Date().toISOString() }
+          : item
+      )
+      const changedCount = fixed.filter((item, i) => item.status !== state.queue[i].status).length
+      if (changedCount > 0) {
+        writeState(name, { ...state, queue: fixed }, STATE_DIR)
+        result.reset.push(`${name}: ${changedCount}개 진행중 항목 → pending 복구`)
+      }
+    }
+  }
+
+  return result
+}
+
+/** 결과를 사람이 읽기 쉬운 문자열로 출력 */
+export function formatCleanupResult(result) {
+  const lines = []
+  const total = Object.values(result).reduce((s, arr) => s + arr.length, 0)
+
+  if (total === 0) {
+    lines.push('정리할 항목 없음.')
+    return lines.join('\n')
+  }
+
+  if (result.killed.length)  lines.push('  [종료]', ...result.killed.map(s => `    · ${s}`))
+  if (result.reset.length)   lines.push('  [초기화]', ...result.reset.map(s => `    · ${s}`))
+  if (result.cleared.length) lines.push('  [정리]', ...result.cleared.map(s => `    · ${s}`))
+  if (result.fixed.length)   lines.push('  [오류]', ...result.fixed.map(s => `    · ${s}`))
+
+  return lines.join('\n')
+}

package/src/cli.js

@@ -141,6 +141,45 @@ function install() {
 
 if (command === 'install') {
   install()
+} else if (command === 'models') {
+  // models → 에이전트별 모델 목록 출력 (KEY=VALUE 형식)
+  const { loadConfig, getAgentModel } = await import('./config.js')
+  const config = loadConfig()
+  const agents = ['orchestrator','issue-agent','code-agent','test-agent',
+    'commit-agent','pr-agent','review-agent','respond-agent','notify-agent','analyze-agent']
+  agents.forEach(a => console.log(`${a}=${getAgentModel(config, a)}`))
+} else if (command === 'branch') {
+  // branch ISSUE_NUMBER  → 브랜치명 출력
+  const issueNumber = Number(args[1])
+  if (!issueNumber) { console.error('사용법: bylane branch <issueNumber>'); process.exit(1) }
+  const { buildBranchNameFromConfig } = await import('./branch.js')
+  const { loadConfig } = await import('./config.js')
+  console.log(buildBranchNameFromConfig(loadConfig(), issueNumber))
+} else if (command === 'state') {
+  // state write AGENT '{"status":"in_progress",...}'
+  // state append AGENT "메시지"
+  // state read AGENT
+  const subCmd = args[1]
+  const agentName = args[2]
+  const payload = args[3]
+  const { writeState, appendLog, readState } = await import('./state.js')
+
+  if (subCmd === 'write' && agentName && payload) {
+    writeState(agentName, JSON.parse(payload))
+  } else if (subCmd === 'append' && agentName && payload) {
+    appendLog(agentName, payload)
+  } else if (subCmd === 'read' && agentName) {
+    console.log(JSON.stringify(readState(agentName), null, 2))
+  } else {
+    console.error('사용법: bylane state <write|append|read> <agentName> [payload]')
+    process.exit(1)
+  }
+} else if (command === 'cleanup') {
+  const { runCleanup, formatCleanupResult } = await import('./cleanup.js')
+  console.log('\n  byLane 상태 정리 중...\n')
+  const result = runCleanup()
+  console.log(formatCleanupResult(result))
+  console.log('\n  완료.\n')
 } else if (command === 'monitor') {
   // 항상 현재 패키지의 모니터 실행 (버전 일치 보장)
   const monitorPath = join(__dirname, 'monitor', 'index.js')

package/src/monitor/index.js

@@ -1,14 +1,17 @@
 #!/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'
 import { join } from 'path'
+import { runCleanup, formatCleanupResult } from '../cleanup.js'
 
 const { screen, header, pipeline, log, queue, status, onCleanup } = createLayout()
 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 +23,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 +38,99 @@ 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()
+  })
+})
+
+// 'r' — 상태 정리 (권한 수정, 좀비 초기화, 큐 복구)
+screen.key('r', () => {
+  header.update({
+    workflowTitle: '상태 정리 중...',
+    time: new Date().toLocaleTimeString('ko-KR', { hour12: false }),
+    elapsed: `${Math.floor((Date.now() - startTime) / 1000)}s`
+  })
+  screen.render()
+
+  try {
+    const result = runCleanup()
+    const summary = formatCleanupResult(result)
+    const total = Object.values(result).reduce((s, a) => s + a.length, 0)
+    header.update({
+      workflowTitle: total > 0 ? `정리 완료 (${total}건)` : '정리 완료 — 이상 없음',
+      time: new Date().toLocaleTimeString('ko-KR', { hour12: false }),
+      elapsed: `${Math.floor((Date.now() - startTime) / 1000)}s`
+    })
+  } catch (e) {
+    header.update({
+      workflowTitle: `정리 실패: ${e.message}`,
+      time: new Date().toLocaleTimeString('ko-KR', { hour12: false }),
+      elapsed: `${Math.floor((Date.now() - startTime) / 1000)}s`
+    })
+  }
+  screen.render()
+})
+
 // 'c' — 하위 에이전트 취소 플래그 토글
-const cancelLabel = () => existsSync(CANCEL_FILE) ? '[취소 활성]' : ''
 screen.key('c', () => {
   if (existsSync(CANCEL_FILE)) {
     unlinkSync(CANCEL_FILE)

package/src/monitor/layout.js

@@ -62,7 +62,7 @@ export function createLayout() {
     left: 0,
     width: '100%',
     height: 1,
-    content: ' [q]종료  [c]에이전트취소토글  [Tab]포커스  [j/k]로그스크롤',
+    content: ' [q]종료  [r]상태정리  [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}` — 실제 모델명과 날짜로 자동 치환됩니다.