@elyun/bylane 1.0.0

package/src/monitor/index.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import { createLayout } from './layout.js'
+import { createPoller } from './poller.js'
+
+const { screen, header, pipeline, log, queue, status, onCleanup } = createLayout()
+const poller = createPoller()
+
+let startTime = Date.now()
+
+const clockInterval = setInterval(() => {
+  header.update({
+    time: new Date().toLocaleTimeString('ko-KR', { hour12: false }),
+    elapsed: `${Math.floor((Date.now() - startTime) / 1000)}s`
+  })
+}, 1000)
+
+onCleanup(() => poller.stop())
+
+poller.onChange((states) => {
+  pipeline.update(states)
+  log.update(states)
+  queue.update()
+  status.update()
+})
+
+screen.render()

package/src/monitor/layout.js

@@ -0,0 +1,37 @@
+import blessed from 'blessed'
+import { createHeader } from './panels/header.js'
+import { createPipelinePanel } from './panels/pipeline.js'
+import { createLogPanel } from './panels/log.js'
+import { createQueuePanel } from './panels/queue.js'
+import { createStatusPanel } from './panels/status.js'
+
+export function createLayout() {
+  const screen = blessed.screen({
+    smartCSR: true,
+    title: 'byLane Monitor'
+  })
+
+  const header = createHeader(screen)
+  const pipeline = createPipelinePanel(screen)
+  const log = createLogPanel(screen)
+  const queue = createQueuePanel(screen)
+  const status = createStatusPanel(screen)
+
+  const footer = blessed.box({
+    bottom: 0,
+    left: 0,
+    width: '100%',
+    height: 1,
+    content: ' [q]종료  [p]일시정지  [c]작업취소  [Tab]포커스  [↑↓]로그스크롤  [?]도움말',
+    style: { fg: 'black', bg: 'cyan' }
+  })
+  screen.append(footer)
+
+  let cleanupFn = null
+  screen.key(['q', 'C-c'], () => {
+    if (cleanupFn) cleanupFn()
+    process.exit(0)
+  })
+
+  return { screen, header, pipeline, log, queue, status, onCleanup(fn) { cleanupFn = fn } }
+}

package/src/monitor/panels/header.js

@@ -0,0 +1,24 @@
+import blessed from 'blessed'
+
+export function createHeader(screen) {
+  const box = blessed.box({
+    top: 0,
+    left: 0,
+    width: '100%',
+    height: 3,
+    content: ' byLane Monitor   Idle   --:--:--',
+    tags: true,
+    border: { type: 'line' },
+    style: { fg: 'white', bg: 'blue', border: { fg: 'cyan' } }
+  })
+  screen.append(box)
+
+  return {
+    update({ workflowTitle, elapsed, time }) {
+      const title = workflowTitle ?? 'Idle'
+      const elapsedStr = elapsed ?? ''
+      box.setContent(` {bold}byLane Monitor{/bold}   ${title}   ${elapsedStr}  ${time}`)
+      screen.render()
+    }
+  }
+}

package/src/monitor/panels/log.js

@@ -0,0 +1,39 @@
+import blessed from 'blessed'
+
+export function createLogPanel(screen) {
+  const box = blessed.box({
+    top: 3,
+    left: '50%',
+    width: '50%',
+    height: '60%-3',
+    label: ' AGENT LOG  [LIVE] ',
+    tags: true,
+    scrollable: true,
+    alwaysScroll: true,
+    border: { type: 'line' },
+    style: { border: { fg: 'cyan' } },
+    keys: true,
+    vi: true
+  })
+  screen.append(box)
+  const lines = []
+
+  return {
+    update(states) {
+      const newLines = []
+      for (const state of Object.values(states)) {
+        for (const entry of (state.log ?? []).slice(-5)) {
+          const ts = new Date(entry.ts).toLocaleTimeString('ko-KR', { hour12: false })
+          newLines.push(` ${ts} {cyan-fg}${state.agent}{/cyan-fg}`)
+          newLines.push(`   → ${entry.msg}`)
+        }
+      }
+      const all = [...lines, ...newLines].slice(-50)
+      lines.length = 0
+      lines.push(...all)
+      box.setContent(lines.join('\n'))
+      box.scrollTo(lines.length)
+      screen.render()
+    }
+  }
+}

package/src/monitor/panels/pipeline.js

@@ -0,0 +1,50 @@
+import blessed from 'blessed'
+
+const AGENTS = [
+  'orchestrator', 'issue-agent', 'code-agent', 'test-agent',
+  'commit-agent', 'pr-agent', 'review-agent', 'respond-agent', 'notify-agent'
+]
+
+const STATUS_ICON = {
+  idle:        '[○]',
+  in_progress: '[▶]',
+  completed:   '[✓]',
+  failed:      '[✗]',
+  escalated:   '[!]'
+}
+
+export function createPipelinePanel(screen) {
+  const box = blessed.box({
+    top: 3,
+    left: 0,
+    width: '50%',
+    height: '60%-3',
+    label: ' AGENT PIPELINE ',
+    tags: true,
+    border: { type: 'line' },
+    style: { border: { fg: 'cyan' } }
+  })
+  screen.append(box)
+
+  return {
+    update(states) {
+      const lines = AGENTS.map(name => {
+        const s = states[name]
+        if (!s) return ` ${STATUS_ICON.idle} ${name.padEnd(16)} 대기`
+        const icon = STATUS_ICON[s.status] ?? STATUS_ICON.idle
+        const elapsed = s.startedAt
+          ? `${Math.floor((Date.now() - new Date(s.startedAt)) / 1000)}s`
+          : ''
+        const bar = s.progress > 0
+          ? `${'█'.repeat(Math.floor(s.progress / 10))}${'░'.repeat(10 - Math.floor(s.progress / 10))} ${s.progress}%`
+          : ''
+        return ` ${icon} ${name.padEnd(16)} ${elapsed.padEnd(6)} ${bar}`
+      })
+      const retries = states['orchestrator']?.retries ?? 0
+      const maxRetries = states['orchestrator']?.maxRetries ?? 3
+      lines.push('', ` Retries: ${retries}/${maxRetries}`)
+      box.setContent(lines.join('\n'))
+      screen.render()
+    }
+  }
+}

package/src/monitor/panels/queue.js

@@ -0,0 +1,36 @@
+import blessed from 'blessed'
+import { existsSync, readFileSync } from 'fs'
+
+export function createQueuePanel(screen) {
+  const box = blessed.box({
+    top: '60%',
+    left: 0,
+    width: '50%',
+    height: '40%',
+    label: ' QUEUE ',
+    tags: true,
+    border: { type: 'line' },
+    style: { border: { fg: 'cyan' } }
+  })
+  screen.append(box)
+
+  return {
+    update() {
+      const queuePath = '.bylane/queue.json'
+      let queue = []
+      if (existsSync(queuePath)) {
+        try {
+          queue = JSON.parse(readFileSync(queuePath, 'utf8'))
+        } catch {
+          queue = []
+        }
+      }
+      const header = ` ${'#'.padEnd(3)} ${'TYPE'.padEnd(12)} ${'TARGET'.padEnd(10)} STATUS`
+      const rows = queue.slice(0, 8).map((item, i) =>
+        ` ${String(i + 1).padEnd(3)} ${(item.type ?? '').padEnd(12)} ${(item.target ?? '').padEnd(10)} ${item.status ?? ''}`
+      )
+      box.setContent([header, ...rows].join('\n'))
+      screen.render()
+    }
+  }
+}

package/src/monitor/panels/status.js

@@ -0,0 +1,35 @@
+import blessed from 'blessed'
+import { loadConfig } from '../../config.js'
+
+export function createStatusPanel(screen) {
+  const box = blessed.box({
+    top: '60%',
+    left: '50%',
+    width: '50%',
+    height: '40%',
+    label: ' SYSTEM STATUS ',
+    tags: true,
+    border: { type: 'line' },
+    style: { border: { fg: 'cyan' } }
+  })
+  screen.append(box)
+
+  return {
+    update() {
+      const config = loadConfig()
+      const check = (v) => v ? '{green-fg}✓{/green-fg}' : '{red-fg}✗{/red-fg}'
+      const lines = [
+        ` 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 || '미설정'}`,
+        ``,
+        ` 팀 모드     ${check(config.team.enabled)} ${config.team.enabled ? `활성 (${config.team.members.length}명)` : '비활성'}`,
+        ` 권한 범위   ${config.permissions.scope}`
+      ]
+      box.setContent(lines.join('\n'))
+      screen.render()
+    }
+  }
+}

package/src/monitor/poller.js

@@ -0,0 +1,28 @@
+import { watch } from 'chokidar'
+import { listStates } from '../state.js'
+
+export function createPoller(stateDir = '.bylane/state', intervalMs = 1000) {
+  const callbacks = new Set()
+
+  const emit = () => {
+    const states = {}
+    for (const s of listStates(stateDir)) {
+      states[s.agent] = s
+    }
+    for (const cb of callbacks) cb(states)
+  }
+
+  const watcher = watch(`${stateDir}`, { persistent: true, ignoreInitial: false })
+  watcher.on('change', emit)
+  watcher.on('add', emit)
+
+  const interval = setInterval(emit, intervalMs)
+
+  return {
+    onChange(cb) { callbacks.add(cb) },
+    stop() {
+      clearInterval(interval)
+      watcher.close()
+    }
+  }
+}

package/src/state.js

@@ -0,0 +1,44 @@
+import { readFileSync, writeFileSync, unlinkSync, readdirSync, existsSync, mkdirSync } from 'fs'
+import { join } from 'path'
+
+const DEFAULT_DIR = '.bylane/state'
+
+export function writeState(agentName, data, dir = DEFAULT_DIR) {
+  mkdirSync(dir, { recursive: true })
+  const payload = {
+    ...data,
+    agent: agentName,
+    updatedAt: new Date().toISOString(),
+    log: data.log ?? []
+  }
+  writeFileSync(join(dir, `${agentName}.json`), JSON.stringify(payload, null, 2))
+}
+
+export function readState(agentName, dir = DEFAULT_DIR) {
+  const path = join(dir, `${agentName}.json`)
+  if (!existsSync(path)) return null
+  try {
+    return JSON.parse(readFileSync(path, 'utf8'))
+  } catch {
+    return null
+  }
+}
+
+export function clearState(agentName, dir = DEFAULT_DIR) {
+  const path = join(dir, `${agentName}.json`)
+  if (existsSync(path)) unlinkSync(path)
+}
+
+export function listStates(dir = DEFAULT_DIR) {
+  if (!existsSync(dir)) return []
+  return readdirSync(dir)
+    .filter(f => f.endsWith('.json'))
+    .map(f => readState(f.replace('.json', ''), dir))
+    .filter(Boolean)
+}
+
+export function appendLog(agentName, message, dir = DEFAULT_DIR) {
+  const state = readState(agentName, dir) ?? { agent: agentName, status: 'idle', log: [] }
+  const entry = { ts: new Date().toISOString(), msg: message }
+  writeState(agentName, { ...state, log: [...(state.log ?? []), entry] }, dir)
+}

package/tests/branch.test.js

@@ -0,0 +1,55 @@
+import { describe, it, expect } from 'vitest'
+import { buildBranchName } from '../src/branch.js'
+
+describe('buildBranchName', () => {
+  it('{tracker}-{issue-number} 패턴 기본 케이스', () => {
+    const result = buildBranchName(
+      '{tracker}-{issue-number}',
+      { tracker: 'issues', 'issue-number': '32' }
+    )
+    expect(result).toBe('issues-32')
+  })
+
+  it('{custom-id}가 비어있으면 해당 토큰과 앞 구분자를 제외한다', () => {
+    const result = buildBranchName(
+      '{tracker}-{issue-number}-{custom-id}',
+      { tracker: 'issues', 'issue-number': '32', 'custom-id': '' }
+    )
+    expect(result).toBe('issues-32')
+  })
+
+  it('{custom-id}가 있으면 포함한다', () => {
+    const result = buildBranchName(
+      '{tracker}-{issue-number}-{custom-id}',
+      { tracker: 'issues', 'issue-number': '32', 'custom-id': 'C-12' }
+    )
+    expect(result).toBe('issues-32-C-12')
+  })
+
+  it('{type}/{issue-number}-{title-slug} 패턴', () => {
+    const result = buildBranchName(
+      '{type}/{issue-number}-{title-slug}',
+      { type: 'feature', 'issue-number': '32', 'title-slug': 'add-dark-mode' }
+    )
+    expect(result).toBe('feature/32-add-dark-mode')
+  })
+
+  it('kebab-case 변환: 공백을 하이픈으로', () => {
+    const result = buildBranchName(
+      '{type}-{title-slug}',
+      { type: 'feat', 'title-slug': 'Add Dark Mode' },
+      'kebab-case'
+    )
+    expect(result).toBe('feat-add-dark-mode')
+  })
+
+  it('슬래시 패턴에서 type이 비어있으면 선행 슬래시 없이 반환한다', () => {
+    const result = buildBranchName(
+      '{type}/{issue-number}',
+      { type: '', 'issue-number': '32' },
+      'kebab-case'
+    )
+    expect(result).toBe('32')
+    expect(result.startsWith('/')).toBe(false)
+  })
+})

package/tests/config.test.js

@@ -0,0 +1,55 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest'
+import { loadConfig, saveConfig, validateConfig, DEFAULT_CONFIG } from '../src/config.js'
+import { mkdirSync, rmSync, writeFileSync } from 'fs'
+
+const TEST_DIR = '.bylane-config-test'
+
+beforeEach(() => mkdirSync(TEST_DIR, { recursive: true }))
+afterEach(() => rmSync(TEST_DIR, { recursive: true, force: true }))
+
+describe('DEFAULT_CONFIG', () => {
+  it('기본 maxRetries는 3이다', () => {
+    expect(DEFAULT_CONFIG.workflow.maxRetries).toBe(3)
+  })
+
+  it('기본 primary tracker는 github이다', () => {
+    expect(DEFAULT_CONFIG.trackers.primary).toBe('github')
+  })
+})
+
+describe('loadConfig', () => {
+  it('파일이 없으면 DEFAULT_CONFIG를 반환한다', () => {
+    const config = loadConfig(TEST_DIR)
+    expect(config.workflow.maxRetries).toBe(3)
+  })
+
+  it('존재하는 설정 파일을 로드한다', () => {
+    writeFileSync(`${TEST_DIR}/bylane.json`, JSON.stringify({
+      ...DEFAULT_CONFIG,
+      workflow: { ...DEFAULT_CONFIG.workflow, maxRetries: 5 }
+    }))
+    const config = loadConfig(TEST_DIR)
+    expect(config.workflow.maxRetries).toBe(5)
+  })
+})
+
+describe('saveConfig', () => {
+  it('설정을 bylane.json에 저장한다', () => {
+    saveConfig({ ...DEFAULT_CONFIG }, TEST_DIR)
+    const loaded = loadConfig(TEST_DIR)
+    expect(loaded.version).toBe('1.0')
+  })
+})
+
+describe('validateConfig', () => {
+  it('유효한 설정은 에러가 없다', () => {
+    const errors = validateConfig(DEFAULT_CONFIG)
+    expect(errors).toHaveLength(0)
+  })
+
+  it('maxRetries가 숫자가 아니면 에러를 반환한다', () => {
+    const bad = { ...DEFAULT_CONFIG, workflow: { ...DEFAULT_CONFIG.workflow, maxRetries: 'abc' } }
+    const errors = validateConfig(bad)
+    expect(errors.length).toBeGreaterThan(0)
+  })
+})

package/tests/state.test.js

@@ -0,0 +1,59 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest'
+import { readState, writeState, clearState, listStates, appendLog } from '../src/state.js'
+import { mkdirSync, rmSync } from 'fs'
+
+const TEST_DIR = '.bylane-test/state'
+
+beforeEach(() => mkdirSync(TEST_DIR, { recursive: true }))
+afterEach(() => rmSync('.bylane-test', { recursive: true, force: true }))
+
+describe('writeState', () => {
+  it('에이전트 상태를 JSON 파일에 저장한다', () => {
+    writeState('code-agent', { status: 'in_progress', progress: 50 }, TEST_DIR)
+    const result = readState('code-agent', TEST_DIR)
+    expect(result.status).toBe('in_progress')
+    expect(result.progress).toBe(50)
+  })
+})
+
+describe('readState', () => {
+  it('존재하지 않는 에이전트는 null을 반환한다', () => {
+    const result = readState('nonexistent', TEST_DIR)
+    expect(result).toBeNull()
+  })
+
+  it('저장된 상태에 agent 이름과 updatedAt이 포함된다', () => {
+    writeState('issue-agent', { status: 'completed' }, TEST_DIR)
+    const result = readState('issue-agent', TEST_DIR)
+    expect(result.agent).toBe('issue-agent')
+    expect(result.updatedAt).toBeDefined()
+  })
+})
+
+describe('clearState', () => {
+  it('특정 에이전트 상태 파일을 삭제한다', () => {
+    writeState('pr-agent', { status: 'idle' }, TEST_DIR)
+    clearState('pr-agent', TEST_DIR)
+    expect(readState('pr-agent', TEST_DIR)).toBeNull()
+  })
+})
+
+describe('listStates', () => {
+  it('모든 에이전트 상태 목록을 반환한다', () => {
+    writeState('code-agent', { status: 'completed' }, TEST_DIR)
+    writeState('test-agent', { status: 'idle' }, TEST_DIR)
+    const list = listStates(TEST_DIR)
+    expect(list).toHaveLength(2)
+    expect(list.map(s => s.agent)).toContain('code-agent')
+  })
+})
+
+describe('appendLog', () => {
+  it('로그 항목을 state에 추가한다', () => {
+    writeState('code-agent', { status: 'in_progress', log: [] }, TEST_DIR)
+    appendLog('code-agent', 'ThemeToggle.tsx 생성', TEST_DIR)
+    const result = readState('code-agent', TEST_DIR)
+    expect(result.log).toHaveLength(1)
+    expect(result.log[0].msg).toBe('ThemeToggle.tsx 생성')
+  })
+})