zyflow 0.6.4

package/packages/zyflow-remote-plugin/src/types.ts

@@ -0,0 +1,149 @@
+/**
+ * Remote Connection Types
+ * 원격 서버 연결 및 프로젝트 관리를 위한 타입 정의
+ */
+
+// 원격 연결 타입
+export type RemoteConnectionType = 'ssh' | 'docker' | 'wsl'
+
+// 인증 방식
+export type RemoteAuthType = 'password' | 'privateKey' | 'agent'
+
+// 연결 상태
+export type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'error'
+
+// SSH 인증 설정
+export interface SSHAuthConfig {
+  type: RemoteAuthType
+  username: string
+  password?: string // password auth
+  privateKeyPath?: string // privateKey auth
+  passphrase?: string // privateKey passphrase
+}
+
+// 원격 서버 설정
+export interface RemoteServer {
+  id: string
+  name: string // 표시 이름 (예: "Production Server")
+  host: string // 호스트명 또는 IP
+  port: number // SSH 포트 (기본 22)
+  auth: SSHAuthConfig
+  // 메타데이터
+  createdAt: string
+  lastConnectedAt?: string
+  // 상태 (런타임)
+  status?: ConnectionStatus
+  error?: string
+}
+
+// 원격 프로젝트 (로컬 프로젝트 확장)
+export interface RemoteProject {
+  id: string
+  name: string
+  path: string // 원격 서버 내 경로
+  serverId: string // 연결된 서버 ID
+  addedAt: string
+  // 원격 전용 필드
+  remote: {
+    type: 'ssh'
+    host: string
+    user: string
+  }
+}
+
+// 기존 Project와 통합된 타입
+export interface Project {
+  id: string
+  name: string
+  path: string
+  addedAt: string
+  // 원격 연결 정보 (optional - 로컬 프로젝트는 없음)
+  remote?: {
+    type: RemoteConnectionType
+    serverId: string
+    host: string
+    user: string
+  }
+}
+
+// 원격 서버 목록 설정
+export interface RemoteConfig {
+  servers: RemoteServer[]
+}
+
+// 파일 시스템 항목
+export interface RemoteFileEntry {
+  name: string
+  path: string
+  type: 'file' | 'directory' | 'symlink'
+  size: number
+  modifiedAt: string
+  permissions: string
+}
+
+// 디렉토리 목록 응답
+export interface RemoteDirectoryListing {
+  path: string
+  entries: RemoteFileEntry[]
+}
+
+// Git 상태 응답
+export interface RemoteGitStatus {
+  branch: string
+  ahead: number
+  behind: number
+  staged: string[]
+  modified: string[]
+  untracked: string[]
+}
+
+// 명령어 실행 결과
+export interface RemoteCommandResult {
+  stdout: string
+  stderr: string
+  exitCode: number
+}
+
+// API 요청/응답 타입
+export interface AddRemoteServerRequest {
+  name: string
+  host: string
+  port?: number
+  auth: SSHAuthConfig
+}
+
+export interface AddRemoteProjectRequest {
+  serverId: string
+  name: string
+  path: string
+}
+
+export interface TestConnectionRequest {
+  serverId: string
+}
+
+export interface TestConnectionResponse {
+  success: boolean
+  message: string
+  serverInfo?: {
+    os: string
+    hostname: string
+  }
+}
+
+export interface BrowseRemoteRequest {
+  serverId: string
+  path: string
+}
+
+export interface BrowseRemoteResponse {
+  listing: RemoteDirectoryListing
+}
+
+export interface RemoteServersResponse {
+  servers: RemoteServer[]
+}
+
+export interface RemoteProjectsResponse {
+  projects: RemoteProject[]
+}

package/plugin/manifest.json

@@ -0,0 +1,26 @@
+{
+  "name": "zyflow",
+  "version": "0.5.0",
+  "description": "ZyFlow - OpenSpec task management and workflow automation",
+  "author": "Hansoo",
+  "mcpServers": {
+    "zyflow": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["${PLUGIN_DIR}/scripts/mcp-server.cjs"],
+      "env": {
+        "ZYFLOW_PROJECT": "${PROJECT_ROOT}"
+      }
+    }
+  },
+  "agents": [
+    "agents/coder.md",
+    "agents/planner.md",
+    "agents/researcher.md",
+    "agents/reviewer.md",
+    "agents/tester.md"
+  ],
+  "skills": [
+    "skills/openspec/SKILL.md"
+  ]
+}

package/plugin/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "zyflow-plugin",
+  "version": "1.0.0",
+  "private": true,
+  "description": "ZyFlow MCP Server Plugin",
+  "type": "commonjs",
+  "dependencies": {
+    "better-sqlite3": "^12.4.6"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/public/favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
+  <rect width="32" height="32" rx="4" fill="#000000"/>
+  <text x="16" y="24" font-family="Inter, system-ui, sans-serif" font-size="18" font-weight="700" fill="#ffffff" text-anchor="middle">ZF</text>
+</svg>

package/server/adk/agents/error-analyzer.ts

@@ -0,0 +1,223 @@
+/**
+ * Error Analyzer Agent
+ *
+ * CI/CD 에러 로그를 분석하고 근본 원인을 파악하는 에이전트
+ */
+
+import { LlmAgent, InMemoryRunner, createPartFromText } from '@google/adk'
+import { fileTools } from '../tools/file-tools'
+import { gitTools } from '../tools/git-tools'
+import { loadConfig } from '../config'
+
+const config = loadConfig()
+
+export interface ErrorAnalysisResult {
+  errorType: 'syntax' | 'type' | 'runtime' | 'lint' | 'test' | 'build' | 'unknown'
+  severity: 'critical' | 'high' | 'medium' | 'low'
+  summary: string
+  rootCause: string
+  affectedFiles: Array<{
+    path: string
+    line?: number
+    column?: number
+    issue: string
+  }>
+  suggestedFix: string
+  confidence: number
+  context: string
+}
+
+export const errorAnalyzerAgent = new LlmAgent({
+  name: 'error-analyzer',
+  description: 'CI/CD 에러 로그를 분석하고 근본 원인을 파악합니다.',
+  model: config.model,
+  instruction: `당신은 소프트웨어 에러 분석 전문가입니다.
+
+주어진 에러 로그와 코드베이스를 분석하여:
+1. 에러의 타입을 분류합니다 (syntax, type, runtime, lint, test, build)
+2. 근본 원인을 파악합니다
+3. 영향받는 파일과 라인을 정확히 식별합니다
+4. 수정 방향을 제안합니다
+
+분석 결과는 반드시 다음 JSON 형식으로 반환하세요:
+{
+  "errorType": "type|syntax|runtime|lint|test|build|unknown",
+  "severity": "critical|high|medium|low",
+  "summary": "에러 요약",
+  "rootCause": "근본 원인 설명",
+  "affectedFiles": [{"path": "파일경로", "line": 번호, "issue": "문제 설명"}],
+  "suggestedFix": "수정 방향 제안",
+  "confidence": 0.0-1.0,
+  "context": "추가 컨텍스트"
+}`,
+  tools: [...fileTools, ...gitTools.slice(0, 3)],
+})
+
+export async function analyzeError(
+  errorLog: string,
+  projectPath?: string
+): Promise<ErrorAnalysisResult> {
+  const runner = new InMemoryRunner({
+    agent: errorAnalyzerAgent,
+    appName: 'ZyFlowAutoFix',
+  })
+
+  const session = await runner.sessionService.getOrCreateSession({
+    appName: 'ZyFlowAutoFix',
+    userId: 'system',
+    sessionId: 'error-analysis-' + Date.now(),
+  })
+
+  const pathInfo = projectPath ? '\n\nProject: ' + projectPath : ''
+  const prompt = 'Analyze this error:\n```\n' + errorLog + '\n```' + pathInfo
+
+  let responseText = ''
+
+  for await (const event of runner.runAsync({
+    userId: 'system',
+    sessionId: session.id,
+    newMessage: { parts: [createPartFromText(prompt)] },
+  })) {
+    if (event.content?.parts) {
+      for (const part of event.content.parts) {
+        if ('text' in part && part.text) {
+          responseText += part.text
+        }
+      }
+    }
+  }
+
+  try {
+    const jsonMatch = responseText.match(/\{[\s\S]*\}/)
+    if (jsonMatch) {
+      return JSON.parse(jsonMatch[0]) as ErrorAnalysisResult
+    }
+  } catch {
+    // parsing failed
+  }
+
+  return {
+    errorType: 'unknown',
+    severity: 'medium',
+    summary: 'Analysis failed',
+    rootCause: responseText || 'No response from agent',
+    affectedFiles: [],
+    suggestedFix: 'Manual check required',
+    confidence: 0.1,
+    context: errorLog.slice(0, 500),
+  }
+}
+
+export function extractErrorsFromCILog(log: string): string[] {
+  const errors: string[] = []
+  const lines = log.split('\n')
+  let inErrorBlock = false
+  let currentError: string[] = []
+
+  for (const line of lines) {
+    if (line.includes('error') || line.includes('Error') || line.includes('FAILED')) {
+      if (currentError.length > 0) {
+        errors.push(currentError.join('\n'))
+        currentError = []
+      }
+      inErrorBlock = true
+    }
+
+    if (inErrorBlock) {
+      currentError.push(line)
+      if (line.trim() === '' && currentError.length > 3) {
+        errors.push(currentError.join('\n'))
+        currentError = []
+        inErrorBlock = false
+      }
+    }
+  }
+
+  if (currentError.length > 0) {
+    errors.push(currentError.join('\n'))
+  }
+
+  return errors
+}
+
+export function parseTypeScriptErrors(log: string): Array<{
+  file: string
+  line: number
+  column: number
+  code: string
+  message: string
+}> {
+  const errors: Array<{
+    file: string
+    line: number
+    column: number
+    code: string
+    message: string
+  }> = []
+
+  const regex = /(.+)\((\d+),(\d+)\): error (TS\d+): (.+)/g
+  let match
+  while ((match = regex.exec(log)) !== null) {
+    errors.push({
+      file: match[1],
+      line: parseInt(match[2], 10),
+      column: parseInt(match[3], 10),
+      code: match[4],
+      message: match[5],
+    })
+  }
+  return errors
+}
+
+export function parseESLintErrors(log: string): Array<{
+  file: string
+  line: number
+  column: number
+  rule: string
+  message: string
+}> {
+  const errors: Array<{
+    file: string
+    line: number
+    column: number
+    rule: string
+    message: string
+  }> = []
+
+  try {
+    const jsonMatch = log.match(/\[[\s\S]*\]/)
+    if (jsonMatch) {
+      const parsed = JSON.parse(jsonMatch[0])
+      for (const file of parsed) {
+        for (const msg of file.messages || []) {
+          if (msg.severity === 2) {
+            errors.push({
+              file: file.filePath,
+              line: msg.line,
+              column: msg.column,
+              rule: msg.ruleId || '',
+              message: msg.message,
+            })
+          }
+        }
+      }
+      return errors
+    }
+  } catch {
+    // JSON parsing failed
+  }
+
+  const regex = /(.+):(\d+):(\d+):\s+error\s+(.+)/g
+  let match
+  while ((match = regex.exec(log)) !== null) {
+    const parts = match[4].split(/\s{2,}/)
+    errors.push({
+      file: match[1],
+      line: parseInt(match[2], 10),
+      column: parseInt(match[3], 10),
+      rule: parts[1] || '',
+      message: parts[0] || match[4],
+    })
+  }
+  return errors
+}

package/server/adk/agents/fix-generator.ts

@@ -0,0 +1,187 @@
+/**
+ * Fix Generator Agent
+ *
+ * 에러 분석 결과를 바탕으로 코드 수정을 생성하는 에이전트
+ */
+
+import { LlmAgent, InMemoryRunner, createPartFromText } from '@google/adk'
+import { fileTools, writeFileTool } from '../tools/file-tools'
+import { loadConfig } from '../config'
+import type { ErrorAnalysisResult } from './error-analyzer'
+
+const config = loadConfig()
+
+export interface CodeFix {
+  filePath: string
+  originalContent?: string
+  fixedContent: string
+  description: string
+  patches?: Array<{
+    type: 'replace' | 'insert' | 'delete'
+    startLine?: number
+    endLine?: number
+    searchPattern?: string
+    content?: string
+  }>
+}
+
+export interface FixGenerationResult {
+  success: boolean
+  fixes: CodeFix[]
+  summary: string
+  confidence: number
+  warnings?: string[]
+}
+
+export const fixGeneratorAgent = new LlmAgent({
+  name: 'fix-generator',
+  description: '에러 분석 결과를 바탕으로 코드 수정을 생성합니다.',
+  model: config.model,
+  instruction: `당신은 코드 수정 전문가입니다.
+
+에러 분석 결과를 바탕으로:
+1. 영향받는 파일을 읽습니다
+2. 문제를 해결하는 최소한의 수정을 생성합니다
+3. 기존 코드 스타일을 유지합니다
+4. 수정 내용을 명확하게 설명합니다
+
+수정 결과는 JSON 형식으로 반환하세요:
+{
+  "success": true,
+  "fixes": [
+    {
+      "filePath": "경로",
+      "fixedContent": "수정된 전체 내용",
+      "description": "수정 설명"
+    }
+  ],
+  "summary": "전체 수정 요약",
+  "confidence": 0.9
+}
+
+주의사항:
+- 불필요한 변경을 하지 마세요
+- 기존 로직을 유지하세요
+- 타입 안전성을 확보하세요`,
+  tools: fileTools,
+})
+
+export async function generateFix(
+  analysis: ErrorAnalysisResult
+): Promise<FixGenerationResult> {
+  const runner = new InMemoryRunner({
+    agent: fixGeneratorAgent,
+    appName: 'ZyFlowAutoFix',
+  })
+
+  const session = await runner.sessionService.getOrCreateSession({
+    appName: 'ZyFlowAutoFix',
+    userId: 'system',
+    sessionId: 'fix-generation-' + Date.now(),
+  })
+
+  const filesInfo = analysis.affectedFiles
+    .map(f => 'File: ' + f.path + (f.line ? ' Line: ' + f.line : '') + ' Issue: ' + f.issue)
+    .join('\n')
+
+  const prompt = `다음 에러를 수정해주세요:
+
+에러 타입: ${analysis.errorType}
+심각도: ${analysis.severity}
+요약: ${analysis.summary}
+근본 원인: ${analysis.rootCause}
+수정 제안: ${analysis.suggestedFix}
+
+영향받는 파일:
+${filesInfo}
+
+각 파일을 읽고 수정된 코드를 생성해주세요.
+수정 결과를 JSON 형식으로 반환해주세요.`
+
+  let responseText = ''
+
+  for await (const event of runner.runAsync({
+    userId: 'system',
+    sessionId: session.id,
+    newMessage: { parts: [createPartFromText(prompt)] },
+  })) {
+    if (event.content?.parts) {
+      for (const part of event.content.parts) {
+        if ('text' in part && part.text) {
+          responseText += part.text
+        }
+      }
+    }
+  }
+
+  try {
+    const jsonMatch = responseText.match(/\{[\s\S]*\}/)
+    if (jsonMatch) {
+      return JSON.parse(jsonMatch[0]) as FixGenerationResult
+    }
+  } catch {
+    // parsing failed
+  }
+
+  return {
+    success: false,
+    fixes: [],
+    summary: 'Fix generation failed',
+    confidence: 0,
+    warnings: [responseText || 'No response from agent'],
+  }
+}
+
+export async function applyFixes(fixes: CodeFix[]): Promise<{
+  applied: string[]
+  failed: Array<{ file: string; error: string }>
+}> {
+  const applied: string[] = []
+  const failed: Array<{ file: string; error: string }> = []
+
+  for (const fix of fixes) {
+    try {
+      const writeResult = await writeFileTool.execute({
+        filePath: fix.filePath,
+        content: fix.fixedContent,
+        createDirectories: true,
+      })
+
+      if (writeResult.success) {
+        applied.push(fix.filePath)
+      } else {
+        failed.push({ file: fix.filePath, error: writeResult.error || 'Unknown error' })
+      }
+    } catch (err) {
+      failed.push({ file: fix.filePath, error: String(err) })
+    }
+  }
+
+  return { applied, failed }
+}
+
+export function generateDiff(original: string, fixed: string): string {
+  const originalLines = original.split('\n')
+  const fixedLines = fixed.split('\n')
+  const diff: string[] = []
+
+  const maxLen = Math.max(originalLines.length, fixedLines.length)
+
+  for (let i = 0; i < maxLen; i++) {
+    const origLine = originalLines[i]
+    const fixLine = fixedLines[i]
+
+    if (origLine !== fixLine) {
+      if (origLine !== undefined) {
+        diff.push('- ' + origLine)
+      }
+      if (fixLine !== undefined) {
+        diff.push('+ ' + fixLine)
+      }
+    } else if (origLine !== undefined) {
+      diff.push('  ' + origLine)
+    }
+  }
+
+  return diff.join('\n')
+}