zyflow 0.6.4

package/mcp-server/triggers/scheduler.ts

@@ -0,0 +1,289 @@
+/**
+ * Scheduler Trigger
+ *
+ * Cron 기반 스케줄러로 Post-Task 작업 트리거
+ */
+
+import type { TaskType, ScheduleConfig } from '../post-task-types.js';
+import { loadTriggerConfig, parseInterval } from '../trigger-config.js';
+import { getPostTaskRunner } from '../post-task-runner.js';
+
+/**
+ * 스케줄러 상태
+ */
+interface SchedulerState {
+  isRunning: boolean;
+  jobs: Map<string, NodeJS.Timeout>;
+  lastRun: Map<string, Date>;
+}
+
+/**
+ * 전역 스케줄러 상태
+ */
+const schedulerState: SchedulerState = {
+  isRunning: false,
+  jobs: new Map(),
+  lastRun: new Map(),
+};
+
+/**
+ * Cron 표현식 파싱 (간단한 구현)
+ */
+interface CronSchedule {
+  minute: number | '*';
+  hour: number | '*';
+  dayOfMonth: number | '*';
+  month: number | '*';
+  dayOfWeek: number | '*';
+}
+
+function parseCron(expression: string): CronSchedule | null {
+  const parts = expression.split(' ');
+  if (parts.length !== 5) return null;
+
+  return {
+    minute: parts[0] === '*' ? '*' : parseInt(parts[0], 10),
+    hour: parts[1] === '*' ? '*' : parseInt(parts[1], 10),
+    dayOfMonth: parts[2] === '*' ? '*' : parseInt(parts[2], 10),
+    month: parts[3] === '*' ? '*' : parseInt(parts[3], 10),
+    dayOfWeek: parts[4] === '*' ? '*' : parseInt(parts[4], 10),
+  };
+}
+
+/**
+ * 다음 실행 시간 계산 (간단한 구현)
+ */
+function getNextRunTime(cron: CronSchedule): Date {
+  const now = new Date();
+  const next = new Date(now);
+
+  // 분 설정
+  if (cron.minute !== '*') {
+    next.setMinutes(cron.minute);
+    if (next <= now) {
+      next.setHours(next.getHours() + 1);
+    }
+  } else {
+    next.setMinutes(next.getMinutes() + 1);
+  }
+
+  // 시 설정
+  if (cron.hour !== '*') {
+    next.setHours(cron.hour);
+    if (next <= now) {
+      next.setDate(next.getDate() + 1);
+    }
+  }
+
+  // 요일 설정
+  if (cron.dayOfWeek !== '*') {
+    while (next.getDay() !== cron.dayOfWeek) {
+      next.setDate(next.getDate() + 1);
+    }
+  }
+
+  // 일 설정
+  if (cron.dayOfMonth !== '*') {
+    next.setDate(cron.dayOfMonth);
+    if (next <= now) {
+      next.setMonth(next.getMonth() + 1);
+    }
+  }
+
+  // 월 설정
+  if (cron.month !== '*') {
+    next.setMonth(cron.month - 1); // 0-indexed
+    if (next <= now) {
+      next.setFullYear(next.getFullYear() + 1);
+    }
+  }
+
+  next.setSeconds(0);
+  next.setMilliseconds(0);
+
+  return next;
+}
+
+/**
+ * 밀리초 단위로 다음 실행까지의 시간 계산
+ */
+function getMillisecondsUntilNextRun(cron: CronSchedule): number {
+  const next = getNextRunTime(cron);
+  return Math.max(0, next.getTime() - Date.now());
+}
+
+/**
+ * 스케줄 작업 실행
+ */
+async function executeScheduledTasks(
+  projectPath: string,
+  schedule: ScheduleConfig
+): Promise<void> {
+  console.log(`[Scheduler] Running scheduled tasks: ${schedule.tasks.join(', ')}`);
+
+  const runner = getPostTaskRunner(projectPath);
+
+  try {
+    const result = await runner.run({
+      tasks: schedule.tasks,
+      projectPath,
+    });
+
+    console.log(`[Scheduler] Completed: ${result.tasksSucceeded}/${result.tasksRun} tasks succeeded`);
+  } catch (error) {
+    console.error('[Scheduler] Failed to run scheduled tasks:', error);
+  }
+
+  // 마지막 실행 시간 업데이트
+  schedulerState.lastRun.set(schedule.cron, new Date());
+}
+
+/**
+ * 스케줄 작업 등록
+ */
+function scheduleJob(projectPath: string, schedule: ScheduleConfig): void {
+  const cron = parseCron(schedule.cron);
+  if (!cron) {
+    console.error(`[Scheduler] Invalid cron expression: ${schedule.cron}`);
+    return;
+  }
+
+  // 기존 작업 취소
+  if (schedulerState.jobs.has(schedule.cron)) {
+    clearTimeout(schedulerState.jobs.get(schedule.cron)!);
+  }
+
+  const scheduleNext = () => {
+    const delay = getMillisecondsUntilNextRun(cron);
+    console.log(`[Scheduler] Next run for "${schedule.description || schedule.cron}" in ${Math.round(delay / 60000)} minutes`);
+
+    const timeout = setTimeout(async () => {
+      await executeScheduledTasks(projectPath, schedule);
+
+      // 다음 실행 스케줄
+      if (schedulerState.isRunning) {
+        scheduleNext();
+      }
+    }, delay);
+
+    schedulerState.jobs.set(schedule.cron, timeout);
+  };
+
+  scheduleNext();
+}
+
+/**
+ * 스케줄러 시작
+ */
+export async function startScheduler(projectPath: string): Promise<{
+  success: boolean;
+  message: string;
+  schedules: string[];
+}> {
+  if (schedulerState.isRunning) {
+    return {
+      success: false,
+      message: 'Scheduler is already running',
+      schedules: Array.from(schedulerState.jobs.keys()),
+    };
+  }
+
+  const config = await loadTriggerConfig(projectPath);
+  const schedules: string[] = [];
+
+  if (!config.schedule || config.schedule.length === 0) {
+    return {
+      success: false,
+      message: 'No schedules configured',
+      schedules: [],
+    };
+  }
+
+  schedulerState.isRunning = true;
+
+  for (const schedule of config.schedule) {
+    scheduleJob(projectPath, schedule);
+    schedules.push(schedule.description || schedule.cron);
+  }
+
+  return {
+    success: true,
+    message: `Scheduler started with ${schedules.length} schedules`,
+    schedules,
+  };
+}
+
+/**
+ * 스케줄러 중지
+ */
+export function stopScheduler(): { success: boolean; message: string } {
+  if (!schedulerState.isRunning) {
+    return {
+      success: false,
+      message: 'Scheduler is not running',
+    };
+  }
+
+  // 모든 작업 취소
+  for (const timeout of schedulerState.jobs.values()) {
+    clearTimeout(timeout);
+  }
+
+  schedulerState.jobs.clear();
+  schedulerState.isRunning = false;
+
+  return {
+    success: true,
+    message: 'Scheduler stopped',
+  };
+}
+
+/**
+ * 스케줄러 상태 조회
+ */
+export function getSchedulerStatus(): {
+  isRunning: boolean;
+  activeSchedules: number;
+  schedules: { cron: string; lastRun?: string; description?: string }[];
+} {
+  const schedules: { cron: string; lastRun?: string; description?: string }[] = [];
+
+  for (const cron of schedulerState.jobs.keys()) {
+    const lastRun = schedulerState.lastRun.get(cron);
+    schedules.push({
+      cron,
+      lastRun: lastRun?.toISOString(),
+    });
+  }
+
+  return {
+    isRunning: schedulerState.isRunning,
+    activeSchedules: schedulerState.jobs.size,
+    schedules,
+  };
+}
+
+/**
+ * 스케줄 즉시 실행 (테스트용)
+ */
+export async function runScheduleNow(
+  projectPath: string,
+  cronExpression: string
+): Promise<{ success: boolean; message: string }> {
+  const config = await loadTriggerConfig(projectPath);
+  const schedule = config.schedule?.find((s) => s.cron === cronExpression);
+
+  if (!schedule) {
+    return {
+      success: false,
+      message: `Schedule not found: ${cronExpression}`,
+    };
+  }
+
+  await executeScheduledTasks(projectPath, schedule);
+
+  return {
+    success: true,
+    message: `Executed tasks: ${schedule.tasks.join(', ')}`,
+  };
+}

package/mcp-server/types.ts

@@ -0,0 +1,55 @@
+// MCP Server specific types
+
+export interface Task {
+  id: string
+  title: string
+  completed: boolean
+  groupId: string
+  lineNumber: number
+  indent?: number // 들여쓰기 레벨 (0=상위, 2+=하위 태스크)
+  displayId?: string // 표시용 ID (예: "1.1.1") - 순서 기반 자동 생성
+}
+
+export interface TaskGroup {
+  id: string
+  title: string
+  tasks: Task[]
+  displayId?: string // 표시용 그룹 ID (예: "1.1") - 순서 기반 자동 생성
+  phaseIndex?: number // Phase 내 순서 (0-based)
+  groupIndex?: number // 전체 그룹 순서 (0-based)
+}
+
+export interface TasksFile {
+  changeId: string
+  groups: TaskGroup[]
+}
+
+export interface Change {
+  id: string
+  title: string
+  description?: string
+  progress: number
+  totalTasks: number
+  completedTasks: number
+}
+
+export interface TaskContext {
+  changeId: string
+  proposal: string
+  relatedSpec?: string
+  suggestedFiles: string[]
+  completedTasks: string[]
+  remainingTasks: number
+}
+
+export interface NextTaskResponse {
+  task: Task | null
+  context: TaskContext
+  group: string
+}
+
+export interface TaskContextResponse {
+  task: Task
+  context: TaskContext
+  group: string
+}

package/memory/claude-flow@alpha-data.json

@@ -0,0 +1,5 @@
+{
+  "agents": [],
+  "tasks": [],
+  "lastUpdated": 1765992331359
+}

package/nginx/zyflow.conf

@@ -0,0 +1,144 @@
+# ==============================================
+# ZyFlow Nginx Reverse Proxy Configuration
+# ==============================================
+# Copy this file to /etc/nginx/sites-available/zyflow.conf
+# Then symlink: ln -s /etc/nginx/sites-available/zyflow.conf /etc/nginx/sites-enabled/
+# ==============================================
+
+# Upstream for ZyFlow server
+upstream zyflow_backend {
+    server 127.0.0.1:3100;
+    keepalive 32;
+}
+
+# Rate limiting
+limit_req_zone $binary_remote_addr zone=api_limit:10m rate=30r/s;
+limit_req_zone $binary_remote_addr zone=webhook_limit:10m rate=10r/s;
+
+# HTTP to HTTPS redirect
+server {
+    listen 80;
+    server_name monitor.ism.kr monitor.jayoo.io;
+
+    location /.well-known/acme-challenge/ {
+        root /var/www/certbot;
+    }
+
+    location / {
+        return 301 https://$host$request_uri;
+    }
+}
+
+# HTTPS server
+server {
+    listen 443 ssl http2;
+    server_name monitor.ism.kr monitor.jayoo.io;
+
+    # SSL Configuration
+    ssl_certificate /etc/letsencrypt/live/monitor.ism.kr/fullchain.pem;
+    ssl_certificate_key /etc/letsencrypt/live/monitor.ism.kr/privkey.pem;
+    ssl_session_timeout 1d;
+    ssl_session_cache shared:SSL:50m;
+    ssl_session_tickets off;
+
+    # Modern SSL settings
+    ssl_protocols TLSv1.2 TLSv1.3;
+    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
+    ssl_prefer_server_ciphers off;
+
+    # HSTS
+    add_header Strict-Transport-Security "max-age=63072000" always;
+
+    # Logging
+    access_log /var/log/nginx/zyflow_access.log;
+    error_log /var/log/nginx/zyflow_error.log;
+
+    # Security headers
+    add_header X-Frame-Options "SAMEORIGIN" always;
+    add_header X-Content-Type-Options "nosniff" always;
+    add_header X-XSS-Protection "1; mode=block" always;
+    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
+
+    # Gzip compression
+    gzip on;
+    gzip_vary on;
+    gzip_proxied any;
+    gzip_comp_level 6;
+    gzip_types text/plain text/css text/xml application/json application/javascript application/rss+xml application/atom+xml image/svg+xml;
+
+    # Static files (frontend)
+    location / {
+        proxy_pass http://zyflow_backend;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection 'upgrade';
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_cache_bypass $http_upgrade;
+
+        # Static file caching
+        location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2)$ {
+            proxy_pass http://zyflow_backend;
+            proxy_cache_valid 200 7d;
+            add_header Cache-Control "public, max-age=604800, immutable";
+        }
+    }
+
+    # API endpoints
+    location /api/ {
+        limit_req zone=api_limit burst=50 nodelay;
+
+        proxy_pass http://zyflow_backend;
+        proxy_http_version 1.1;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+
+        # Timeouts for long-running requests
+        proxy_connect_timeout 60s;
+        proxy_send_timeout 60s;
+        proxy_read_timeout 300s;
+    }
+
+    # Webhook endpoints (separate rate limit)
+    location /api/alerts/webhooks/ {
+        limit_req zone=webhook_limit burst=20 nodelay;
+
+        proxy_pass http://zyflow_backend;
+        proxy_http_version 1.1;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+
+        # Allow larger payloads for webhooks
+        client_max_body_size 10m;
+    }
+
+    # WebSocket endpoint
+    location /ws {
+        proxy_pass http://zyflow_backend;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+
+        # WebSocket timeout
+        proxy_read_timeout 86400s;
+        proxy_send_timeout 86400s;
+    }
+
+    # Health check (no rate limit)
+    location /api/health {
+        proxy_pass http://zyflow_backend;
+        proxy_http_version 1.1;
+        proxy_set_header Host $host;
+        access_log off;
+    }
+}

package/openspec/config.yaml

@@ -0,0 +1,78 @@
+schema: spec-driven
+
+context: |
+  # ZyFlow - OpenSpec Workflow Dashboard
+
+  ## Purpose
+  Local dashboard for OpenSpec workflow visualization and task management.
+  - Visualize OpenSpec change tasks.md in kanban format
+  - Manage detailed plans per task (generated by Claude)
+  - TDD test status integration
+  - Personal development dashboard (not SaaS)
+
+  ## Tech Stack
+  Frontend:
+  - React 19 - UI library
+  - Vite 6 - Build tool
+  - TypeScript - Type system
+  - ShadcnUI (Radix UI based) - UI components
+  - TailwindCSS 4 - Styling
+  - TanStack Query - Server state management
+  - @dnd-kit - Drag and drop
+
+  Backend (Local):
+  - Node.js + Express - File system access
+  - File-based data (backlog/*.md, openspec/*.md)
+
+  ## Code Conventions
+  - ESLint + Prettier
+  - File names: kebab-case (task-card.tsx)
+  - Component names: PascalCase (TaskCard)
+  - Functions/variables: camelCase (handleDrop)
+  - Type names: PascalCase with suffix (TaskProps, TaskState)
+  - Absolute imports: @/ prefix
+
+  ## Architecture
+  - Feature-based folder structure: src/features/tasks/, src/features/specs/
+  - Container/Presentational separation
+  - Colocation: related files in same folder
+  - Barrel exports via index.ts
+
+  ## Domain Concepts
+  - Change: OpenSpec change proposal (openspec/changes/*/)
+  - Task: Checklist item from tasks.md
+  - Plan: Detailed implementation plan (.zyflow/plans/)
+  - Spec: Implemented feature specification (openspec/specs/)
+
+  ## Constraints
+  - Local only: No server deployment, localhost only
+  - File system dependent: Requires Node.js fs module
+  - Browser security: Local API server required for file access
+  - No over-abstraction: Refactor only when needed
+  - Open source, no commercialization goal
+
+rules:
+  proposal:
+    - Keep proposals focused on single change scope
+    - Include clear Why section explaining motivation
+    - List affected specs and code explicitly
+    - Mark breaking changes with **BREAKING** prefix
+
+  specs:
+    - Use Given/When/Then format for scenarios
+    - One scenario per requirement minimum
+    - Cross-reference related capabilities
+    - Use delta operators (ADDED/MODIFIED/REMOVED)
+
+  design:
+    - Include only for cross-cutting changes
+    - Document new external dependencies
+    - Cover security/performance/migration complexity
+    - Add architecture diagrams when helpful
+
+  tasks:
+    - Break into small, verifiable work items
+    - Use Phase N: and N.N section format
+    - Include validation steps (tests, tooling)
+    - Mark dependencies and parallelizable work
+    - Use exactly 2-space indent for subtasks