zyflow 0.6.4

package/server/moai-specs.ts

@@ -0,0 +1,487 @@
+/**
+ * MoAI SPEC Utilities
+ *
+ * Helper functions for scanning and managing MoAI SPEC files (.moai/specs/ directory).
+ * Provides a unified interface for MoAI SPEC operations alongside OpenSpec compatibility.
+ */
+
+import { readdir, readFile, access } from 'fs/promises'
+import { join } from 'path'
+import { parsePlanFile } from '@zyflow/parser'
+
+/**
+ * Count markdown checklists in content for progress calculation.
+ * Used as fallback when no TAG-XXX format tags are found.
+ */
+function countMarkdownChecklists(content: string): { completed: number; total: number; percentage: number } | null {
+  const checklistRegex = /^[\s]*-\s*\[([ xX])\]/gm
+  let completed = 0
+  let total = 0
+
+  let match
+  while ((match = checklistRegex.exec(content)) !== null) {
+    total++
+    if (match[1].toLowerCase() === 'x') {
+      completed++
+    }
+  }
+
+  if (total === 0) return null
+  return { completed, total, percentage: Math.round((completed / total) * 100) }
+}
+
+export interface MoaiSpec {
+  id: string // SPEC-DOMAIN-NUM format
+  title: string
+  path: string // .moai/specs/SPEC-DOMAIN-NUM
+  tagCount: number // Total tags in plan.md
+  completedTags: number // Completed tags
+  status: 'draft' | 'active' | 'complete' | 'archived'
+  createdAt?: string
+  updatedAt?: string
+}
+
+/**
+ * Scan for MoAI SPEC directories in .moai/specs/
+ *
+ * Returns array of SPEC metadata extracted from spec.md headers and plan.md TAG items
+ */
+export async function scanMoaiSpecs(projectPath: string): Promise<MoaiSpec[]> {
+  const specsDir = join(projectPath, '.moai', 'specs')
+  const specs: MoaiSpec[] = []
+
+  try {
+    await access(specsDir)
+  } catch {
+    // .moai/specs/ does not exist, return empty array
+    return specs
+  }
+
+  let entries
+  try {
+    entries = await readdir(specsDir, { withFileTypes: true })
+  } catch {
+    return specs
+  }
+
+  // Filter for SPEC-{DOMAIN}-{NUM} pattern directories
+  // Supports compound domain names like SPEC-E2E-MIGRATION-001
+  const specDirs = entries.filter(
+    (entry) =>
+      entry.isDirectory() &&
+      entry.name.match(/^SPEC-[A-Z0-9]+(?:-[A-Z0-9]+)*-\d+$/) &&
+      entry.name !== '.archived'
+  )
+
+  const specPromises = specDirs.map(async (entry) => {
+    const specId = entry.name
+    const specPath = join(specsDir, specId)
+
+    // Extract title from spec.md
+    let title = specId
+    let status: MoaiSpec['status'] = 'draft'
+
+    try {
+      const specContent = await readFile(join(specPath, 'spec.md'), 'utf-8')
+      const titleMatch = specContent.match(/^#\s+(.+)$/m)
+      if (titleMatch) {
+        title = titleMatch[1].trim()
+      }
+
+      // Extract status from multiple formats:
+      // 1. YAML frontmatter: "status: active" or "status: 'completed'"
+      // 2. Markdown table: "| Status | Completed |"
+      // 3. Korean format: "- **상태**: In Progress"
+      const yamlStatusMatch = specContent.match(/^status:\s*["']?(\w+)["']?/mi)
+      const tableStatusMatch = specContent.match(/\|\s*\*?\*?(?:Status|상태)\*?\*?\s*\|\s*([^|]+)\s*\|/i)
+      const koreanStatusMatch = specContent.match(/^[-*]\s*\*?\*?(?:상태|Status)\*?\*?:\s*(.+)$/mi)
+
+      // Status mapping (shared across all formats)
+      const statusMap: Record<string, MoaiSpec['status']> = {
+        'draft': 'draft',
+        'planned': 'draft',
+        'planning': 'draft',
+        '초안': 'draft',
+        '계획': 'draft',
+        'active': 'active',
+        'in progress': 'active',
+        'in-progress': 'active',
+        'progress': 'active',
+        '진행 중': 'active',
+        '진행중': 'active',
+        'complete': 'complete',
+        'completed': 'complete',
+        'implemented': 'complete',
+        'done': 'complete',
+        '완료': 'complete',
+        'archived': 'archived',
+        '아카이브': 'archived',
+      }
+
+      if (yamlStatusMatch) {
+        const rawStatus = yamlStatusMatch[1].toLowerCase().trim()
+        status = statusMap[rawStatus] || 'draft'
+      } else if (tableStatusMatch) {
+        const rawStatus = tableStatusMatch[1].toLowerCase().trim()
+        status = statusMap[rawStatus] || 'draft'
+      } else if (koreanStatusMatch) {
+        const rawStatus = koreanStatusMatch[1].toLowerCase().trim()
+        status = statusMap[rawStatus] || 'draft'
+      }
+    } catch {
+      // spec.md not found or parse error, use defaults
+    }
+
+    // Count TAG items in plan.md using parsePlanFile for accurate completion status
+    let tagCount = 0
+    let completedTags = 0
+
+    try {
+      const planContent = await readFile(join(specPath, 'plan.md'), 'utf-8')
+      const parsed = parsePlanFile(planContent)
+      if (parsed.tags.length > 0) {
+        tagCount = parsed.tags.length
+        completedTags = parsed.tags.filter((t) => t.completed).length
+      } else {
+        // Fallback: use acceptance.md checklists if no TAGs found
+        try {
+          const acceptanceContent = await readFile(join(specPath, 'acceptance.md'), 'utf-8')
+          const checklistProgress = countMarkdownChecklists(acceptanceContent)
+          if (checklistProgress) {
+            tagCount = checklistProgress.total
+            completedTags = checklistProgress.completed
+          }
+        } catch {
+          // acceptance.md not found
+        }
+      }
+    } catch {
+      // plan.md not found or parse error, use defaults
+    }
+
+    // If status is 'complete', show 100% progress (override any checklist count)
+    if (status === 'complete') {
+      if (tagCount === 0) {
+        tagCount = 1
+      }
+      completedTags = tagCount
+    }
+
+    return {
+      id: specId,
+      title,
+      path: specPath,
+      status,
+      tagCount,
+      completedTags,
+    }
+  })
+
+  const results = await Promise.all(specPromises)
+  return results.filter((spec) => spec !== null) as MoaiSpec[]
+}
+
+/**
+ * Get single SPEC metadata by ID
+ */
+export async function getMoaiSpec(projectPath: string, specId: string): Promise<MoaiSpec | null> {
+  const specsDir = join(projectPath, '.moai', 'specs')
+  const specPath = join(specsDir, specId)
+
+  try {
+    await access(specPath)
+  } catch {
+    return null
+  }
+
+  let title = specId
+  let status: MoaiSpec['status'] = 'draft'
+
+  try {
+    const specContent = await readFile(join(specPath, 'spec.md'), 'utf-8')
+    const titleMatch = specContent.match(/^#\s+(.+)$/m)
+    if (titleMatch) {
+      title = titleMatch[1].trim()
+    }
+
+    // Updated regex to handle quoted values: status: completed, status: "completed", status: 'completed'
+    const statusMatch = specContent.match(/^status:\s*["']?(\w+)["']?/mi)
+    if (statusMatch) {
+      const rawStatus = statusMatch[1].toLowerCase()
+      // Map status values including 'completed' → 'complete'
+      const statusMap: Record<string, MoaiSpec['status']> = {
+        'draft': 'draft',
+        'planned': 'draft',
+        'active': 'active',
+        'complete': 'complete',
+        'completed': 'complete',
+        'implemented': 'complete',
+        'done': 'complete',
+        'archived': 'archived',
+      }
+      status = statusMap[rawStatus] || 'draft'
+    }
+  } catch {
+    // spec.md not found
+  }
+
+  let tagCount = 0
+  let completedTags = 0
+
+  try {
+    const planContent = await readFile(join(specPath, 'plan.md'), 'utf-8')
+
+    // Support multiple TAG formats (same logic as scanMoaiSpecs)
+    const checklistTags = planContent.match(/^[-*]\s+\[.*?\]\s+TAG-\d+/gm) || []
+    const completedChecklistTags = planContent.match(/^[-*]\s+\[x\]\s+TAG-\d+/gim) || []
+    const headingTags = planContent.match(/^#{2,3}\s+TAG-\d+[^#\n]*/gm) || []
+    const completedHeadingTags = headingTags.filter(
+      (tag) => tag.includes('✓') || tag.includes('COMPLETE') || tag.includes('완료')
+    )
+
+    const allTagIds = new Set<string>()
+    const completedTagIds = new Set<string>()
+
+    for (const tag of checklistTags) {
+      const match = tag.match(/TAG-(\d+)/)
+      if (match) allTagIds.add(match[1])
+    }
+    for (const tag of completedChecklistTags) {
+      const match = tag.match(/TAG-(\d+)/)
+      if (match) completedTagIds.add(match[1])
+    }
+    for (const tag of headingTags) {
+      const match = tag.match(/TAG-(\d+)/)
+      if (match) allTagIds.add(match[1])
+    }
+    for (const tag of completedHeadingTags) {
+      const match = tag.match(/TAG-(\d+)/)
+      if (match) completedTagIds.add(match[1])
+    }
+
+    tagCount = allTagIds.size
+    completedTags = completedTagIds.size
+  } catch {
+    // plan.md not found
+  }
+
+  return {
+    id: specId,
+    title,
+    path: specPath,
+    status,
+    tagCount,
+    completedTags,
+  }
+}
+
+/**
+ * Count total and completed tags across all SPECs in a project
+ */
+export async function countMoaiTags(projectPath: string): Promise<{ total: number; completed: number }> {
+  const specs = await scanMoaiSpecs(projectPath)
+  let total = 0
+  let completed = 0
+
+  for (const spec of specs) {
+    total += spec.tagCount
+    completed += spec.completedTags
+  }
+
+  return { total, completed }
+}
+
+/**
+ * Check if a SPEC ID is valid (matches SPEC-{DOMAIN}-{NUM} format)
+ */
+export function isValidSpecId(specId: string): boolean {
+  return /^SPEC-[A-Z]+-\d+$/.test(specId)
+}
+
+// =============================================
+// Remote SSH Support
+// =============================================
+
+/**
+ * Remote plugin interface for SSH operations
+ */
+export interface RemotePlugin {
+  listDirectory: (server: unknown, path: string) => Promise<{ entries: Array<{ name: string; type: string }> }>
+  readRemoteFile: (server: unknown, path: string) => Promise<string>
+}
+
+/**
+ * Scan for MoAI SPEC directories on a remote server via SSH
+ *
+ * Returns array of SPEC metadata extracted from spec.md headers and plan.md TAG items
+ */
+export async function scanRemoteMoaiSpecs(
+  projectPath: string,
+  server: unknown,
+  plugin: RemotePlugin
+): Promise<MoaiSpec[]> {
+  const specsDir = `${projectPath}/.moai/specs`
+  const specs: MoaiSpec[] = []
+
+  let listing: { entries: Array<{ name: string; type: string }> }
+  try {
+    listing = await plugin.listDirectory(server, specsDir)
+  } catch {
+    // .moai/specs/ does not exist on remote, return empty array
+    return specs
+  }
+
+  // Filter for SPEC-{DOMAIN}-{NUM} pattern directories
+  const specDirs = listing.entries.filter(
+    (entry) =>
+      (entry.type === 'directory' || entry.type === 'd' || entry.type === 'Directory') &&
+      entry.name.match(/^SPEC-[A-Z]+-\d+$/) &&
+      entry.name !== '.archived'
+  )
+
+  const specPromises = specDirs.map(async (entry) => {
+    const specId = entry.name
+    const specPath = `${specsDir}/${specId}`
+
+    // Extract title from spec.md
+    let title = specId
+    let status: MoaiSpec['status'] = 'draft'
+
+    try {
+      const specContent = await plugin.readRemoteFile(server, `${specPath}/spec.md`)
+
+      const titleMatch = specContent.match(/^#\s+(.+)$/m)
+      if (titleMatch) {
+        title = titleMatch[1].trim()
+      }
+
+      // Extract status from multiple formats:
+      // 1. YAML frontmatter: "status: active" or "status: 'completed'"
+      // 2. Markdown table: "| Status | Completed |"
+      // 3. Korean format: "- **상태**: In Progress"
+      const yamlStatusMatch = specContent.match(/^status:\s*["']?(\w+)["']?/mi)
+      const tableStatusMatch = specContent.match(/\|\s*\*?\*?(?:Status|상태)\*?\*?\s*\|\s*([^|]+)\s*\|/i)
+      const koreanStatusMatch = specContent.match(/^[-*]\s*\*?\*?(?:상태|Status)\*?\*?:\s*(.+)$/mi)
+
+      // Status mapping (shared across all formats)
+      const statusMap: Record<string, MoaiSpec['status']> = {
+        'draft': 'draft',
+        'planned': 'draft',
+        'planning': 'draft',
+        '초안': 'draft',
+        '계획': 'draft',
+        'active': 'active',
+        'in progress': 'active',
+        'in-progress': 'active',
+        'progress': 'active',
+        '진행 중': 'active',
+        '진행중': 'active',
+        'complete': 'complete',
+        'completed': 'complete',
+        'implemented': 'complete',
+        'done': 'complete',
+        '완료': 'complete',
+        'archived': 'archived',
+        '아카이브': 'archived',
+      }
+
+      if (yamlStatusMatch) {
+        const rawStatus = yamlStatusMatch[1].toLowerCase().trim()
+        status = statusMap[rawStatus] || 'draft'
+      } else if (tableStatusMatch) {
+        const rawStatus = tableStatusMatch[1].toLowerCase().trim()
+        status = statusMap[rawStatus] || 'draft'
+      } else if (koreanStatusMatch) {
+        const rawStatus = koreanStatusMatch[1].toLowerCase().trim()
+        status = statusMap[rawStatus] || 'draft'
+      }
+    } catch {
+      // spec.md not found or parse error, use defaults
+    }
+
+    // Count TAG items in plan.md using parsePlanFile for accurate completion status
+    let tagCount = 0
+    let completedTags = 0
+
+    try {
+      const planPath = `${specPath}/plan.md`
+      const planContent = await plugin.readRemoteFile(server, planPath)
+
+      // Try standard MoAI TAG Chain format first
+      const parsed = parsePlanFile(planContent)
+      if (parsed.tags.length > 0) {
+        tagCount = parsed.tags.length
+        completedTags = parsed.tags.filter((t) => t.completed).length
+      } else {
+        // Fallback: use acceptance.md checklists if no TAGs found
+        try {
+          const acceptancePath = `${specPath}/acceptance.md`
+          const acceptanceContent = await plugin.readRemoteFile(server, acceptancePath)
+          const checklistProgress = countMarkdownChecklists(acceptanceContent)
+          if (checklistProgress) {
+            tagCount = checklistProgress.total
+            completedTags = checklistProgress.completed
+          }
+        } catch {
+          // acceptance.md not found, try Phase/Task format
+          const taskMatches = planContent.match(/^#{3,4}\s+Task\s+\d+\.\d+/gim) || []
+          const checkboxItems = planContent.match(/^[-*]\s+\[[ xX]\]/gm) || []
+          const completedCheckboxes = planContent.match(/^[-*]\s+\[[xX]\]/gm) || []
+
+          if (taskMatches.length > 0) {
+            tagCount = taskMatches.length
+            if (checkboxItems.length > 0) {
+              const checkboxCompletion = completedCheckboxes.length / checkboxItems.length
+              completedTags = Math.round(tagCount * checkboxCompletion)
+            }
+          } else if (checkboxItems.length > 0) {
+            tagCount = checkboxItems.length
+            completedTags = completedCheckboxes.length
+          }
+        }
+      }
+    } catch (planErr) {
+      console.warn(`[MoAI Specs] Failed to read/parse plan.md for ${specId}:`, planErr)
+    }
+
+    // If status is 'complete', show 100% progress (override any checklist count)
+    if (status === 'complete') {
+      if (tagCount === 0) {
+        tagCount = 1
+      }
+      completedTags = tagCount
+    }
+
+    return {
+      id: specId,
+      title,
+      path: specPath,
+      status,
+      tagCount,
+      completedTags,
+    }
+  })
+
+  const results = await Promise.all(specPromises)
+  return results.filter((spec) => spec !== null) as MoaiSpec[]
+}
+
+/**
+ * Count total and completed tags across all remote SPECs in a project
+ */
+export async function countRemoteMoaiTags(
+  projectPath: string,
+  server: unknown,
+  plugin: RemotePlugin
+): Promise<{ total: number; completed: number }> {
+  const specs = await scanRemoteMoaiSpecs(projectPath, server, plugin)
+  let total = 0
+  let completed = 0
+
+  for (const spec of specs) {
+    total += spec.tagCount
+    completed += spec.completedTags
+  }
+
+  return { total, completed }
+}

package/server/moai-watcher.ts

@@ -0,0 +1,145 @@
+/**
+ * MoAI SPEC Watcher
+ * .moai/specs/ 디렉토리 변경 감지 후 DB 동기화 및 WebSocket 알림
+ */
+
+import chokidar from 'chokidar'
+import { join } from 'path'
+import type { WSEvent } from './websocket.js'
+import { broadcast } from './websocket.js'
+import { scanMoaiSpecs } from './flow-sync.js'
+
+let moaiWatcher: ReturnType<typeof chokidar.watch> | null = null
+let currentProjectPath: string | null = null
+let currentProjectId: string | null = null
+
+// Debounce timer to prevent multiple syncs for rapid file changes
+let debounceTimer: ReturnType<typeof setTimeout> | null = null
+const DEBOUNCE_DELAY = 500 // ms
+
+export function startMoaiWatcher(projectPath: string, projectId: string) {
+  if (moaiWatcher) {
+    console.log('[MoAI Watcher] Already watching, restarting with new path...')
+    stopMoaiWatcher()
+  }
+
+  currentProjectPath = projectPath
+  currentProjectId = projectId
+
+  const specsDir = join(projectPath, '.moai', 'specs')
+
+  moaiWatcher = chokidar.watch(specsDir, {
+    ignoreInitial: true,
+    persistent: true,
+    usePolling: true,
+    interval: 300,
+    depth: 2,
+  })
+
+  // Handle file changes with debouncing
+  const handleFileChange = async (filePath: string, eventType: string) => {
+    // Only process spec.md, plan.md, acceptance.md files
+    if (!filePath.match(/\/(spec|plan|acceptance)\.md$/)) return
+
+    console.log(`[MoAI Watcher] File ${eventType}: ${filePath}`)
+
+    // Debounce to prevent multiple syncs
+    if (debounceTimer) {
+      clearTimeout(debounceTimer)
+    }
+
+    debounceTimer = setTimeout(async () => {
+      try {
+        const result = await scanMoaiSpecs(projectPath, projectId)
+        console.log(
+          `[MoAI Watcher] Synced: processed=${result.specsProcessed}, created=${result.totalCreated}, updated=${result.totalUpdated}`
+        )
+
+        // Broadcast WebSocket event to clients
+        const event: WSEvent = {
+          type: 'spec:synced' as const,
+          payload: {
+            projectPath,
+            projectId,
+            specsProcessed: result.specsProcessed,
+            created: result.totalCreated,
+            updated: result.totalUpdated,
+          },
+          timestamp: Date.now(),
+        }
+
+        broadcast(event)
+      } catch (error) {
+        console.error(`[MoAI Watcher] Sync error:`, error)
+      }
+    }, DEBOUNCE_DELAY)
+  }
+
+  moaiWatcher.on('change', (filePath) => handleFileChange(filePath, 'changed'))
+  moaiWatcher.on('add', (filePath) => handleFileChange(filePath, 'added'))
+  moaiWatcher.on('unlink', (filePath) => handleFileChange(filePath, 'deleted'))
+
+  // Handle new SPEC directory creation
+  moaiWatcher.on('addDir', async (dirPath) => {
+    if (!dirPath.match(/\.moai\/specs\/SPEC-[A-Z0-9-]+$/)) return
+
+    console.log(`[MoAI Watcher] New SPEC directory: ${dirPath}`)
+
+    // Wait a bit for files to be created
+    setTimeout(async () => {
+      try {
+        const result = await scanMoaiSpecs(projectPath, projectId)
+        console.log(`[MoAI Watcher] New SPEC synced: created=${result.totalCreated}`)
+
+        const event: WSEvent = {
+          type: 'spec:synced' as const,
+          payload: {
+            projectPath,
+            projectId,
+            specsProcessed: result.specsProcessed,
+            created: result.totalCreated,
+            updated: result.totalUpdated,
+          },
+          timestamp: Date.now(),
+        }
+
+        broadcast(event)
+      } catch (error) {
+        console.error(`[MoAI Watcher] New SPEC sync error:`, error)
+      }
+    }, 1000) // Wait 1 second for files to be written
+  })
+
+  moaiWatcher.on('error', (error) => {
+    console.error('[MoAI Watcher] Error:', error)
+  })
+
+  moaiWatcher.on('ready', () => {
+    console.log(`[MoAI Watcher] Ready, watching: ${specsDir}`)
+  })
+
+  console.log(`[MoAI Watcher] Started watching .moai/specs in: ${projectPath}`)
+}
+
+export function stopMoaiWatcher() {
+  if (debounceTimer) {
+    clearTimeout(debounceTimer)
+    debounceTimer = null
+  }
+
+  if (moaiWatcher) {
+    moaiWatcher.close()
+    moaiWatcher = null
+    currentProjectPath = null
+    currentProjectId = null
+    console.log('[MoAI Watcher] Stopped')
+  }
+}
+
+export function getMoaiWatcherStatus() {
+  return {
+    watching: moaiWatcher !== null,
+    projectPath: currentProjectPath,
+    projectId: currentProjectId,
+  }
+}

package/server/parser-debug.ts

@@ -0,0 +1,37 @@
+import { parseTasksFileFlexible } from './parser-utils.js'
+
+// 테스트용 디버그 함수
+export function debugParseTest() {
+  const content = `## 1. Main Section
+
+### 1.1 Subsection A
+
+- [ ] Task A1
+- [ ] Task A2
+
+### 1.2 Subsection B
+
+- [ ] Task B1
+`
+
+  console.log('=== DEBUG PARSE TEST ===')
+  console.log('Input content:')
+  console.log(content)
+  console.log('\n=== PARSE RESULT ===')
+  
+  try {
+    const result = parseTasksFileFlexible('debug-test', content)
+    console.log('Groups found:', result.groups.length)
+    result.groups.forEach((group, index) => {
+      console.log(`Group ${index}:`, {
+        id: group.id,
+        title: group.title,
+        tasksCount: group.tasks.length
+      })
+    })
+    return result
+  } catch (error) {
+    console.error('Parse error:', error)
+    throw error
+  }
+}