prjct-cli 1.22.0 → 1.24.0

package/core/services/sync-verifier.ts

@@ -1,253 +0,0 @@
-/**
- * SyncVerifier - Programmatic verification checks for sync workflow
- *
- * Runs configurable checks after sync to validate generated output.
- * Supports built-in checks and custom user commands.
- *
- * @see PRJ-106
- */
-
-import { exec } from 'node:child_process'
-import fs from 'node:fs/promises'
-import path from 'node:path'
-import { promisify } from 'node:util'
-import type {
-  VerificationCheck,
-  VerificationCheckResult,
-  VerificationConfig,
-  VerificationReport,
-} from '../types'
-import { getErrorMessage, isNotFoundError } from '../types/fs'
-
-const execAsync = promisify(exec)
-
-export type {
-  VerificationCheck,
-  VerificationCheckResult,
-  VerificationConfig,
-  VerificationReport,
-} from '../types'
-
-// =============================================================================
-// BUILT-IN CHECKS
-// =============================================================================
-
-const BUILTIN_CHECKS = {
-  /**
-   * Verify all expected context files exist after sync
-   */
-  async contextFilesExist(globalPath: string): Promise<VerificationCheckResult> {
-    const start = Date.now()
-    const expected = ['context/CLAUDE.md']
-    const missing: string[] = []
-
-    for (const file of expected) {
-      const filePath = path.join(globalPath, file)
-      try {
-        await fs.access(filePath)
-      } catch {
-        missing.push(file)
-      }
-    }
-
-    return {
-      name: 'Context files exist',
-      passed: missing.length === 0,
-      output: missing.length === 0 ? `${expected.length} files verified` : undefined,
-      error: missing.length > 0 ? `Missing: ${missing.join(', ')}` : undefined,
-      durationMs: Date.now() - start,
-    }
-  },
-
-  /**
-   * Verify generated JSON files are valid
-   */
-  async jsonFilesValid(globalPath: string): Promise<VerificationCheckResult> {
-    const start = Date.now()
-    const jsonFiles = ['storage/state.json']
-    const invalid: string[] = []
-
-    for (const file of jsonFiles) {
-      const filePath = path.join(globalPath, file)
-      try {
-        const content = await fs.readFile(filePath, 'utf-8')
-        JSON.parse(content)
-      } catch (error) {
-        if (!isNotFoundError(error)) {
-          invalid.push(`${file}: ${error instanceof SyntaxError ? 'invalid JSON' : 'read error'}`)
-        }
-      }
-    }
-
-    return {
-      name: 'JSON files valid',
-      passed: invalid.length === 0,
-      output: invalid.length === 0 ? `${jsonFiles.length} files validated` : undefined,
-      error: invalid.length > 0 ? invalid.join('; ') : undefined,
-      durationMs: Date.now() - start,
-    }
-  },
-
-  /**
-   * Verify no sensitive data leaked into context files
-   */
-  async noSensitiveData(globalPath: string): Promise<VerificationCheckResult> {
-    const start = Date.now()
-    const contextDir = path.join(globalPath, 'context')
-    const patterns = [
-      /(?:api[_-]?key|apikey)\s*[:=]\s*['"][^'"]{10,}/i,
-      /(?:password|passwd|pwd)\s*[:=]\s*['"][^'"]{4,}/i,
-      /(?:secret|token)\s*[:=]\s*['"][^'"]{10,}/i,
-    ]
-    const violations: string[] = []
-
-    try {
-      const files = await fs.readdir(contextDir)
-      for (const file of files) {
-        if (!file.endsWith('.md')) continue
-        const content = await fs.readFile(path.join(contextDir, file), 'utf-8')
-        for (const pattern of patterns) {
-          if (pattern.test(content)) {
-            violations.push(`${file}: potential sensitive data detected`)
-            break
-          }
-        }
-      }
-    } catch (error) {
-      if (!isNotFoundError(error)) {
-        return {
-          name: 'No sensitive data',
-          passed: false,
-          error: `Could not scan: ${getErrorMessage(error)}`,
-          durationMs: Date.now() - start,
-        }
-      }
-    }
-
-    return {
-      name: 'No sensitive data',
-      passed: violations.length === 0,
-      output: violations.length === 0 ? 'No sensitive patterns found' : undefined,
-      error: violations.length > 0 ? violations.join('; ') : undefined,
-      durationMs: Date.now() - start,
-    }
-  },
-}
-
-// =============================================================================
-// SYNC VERIFIER
-// =============================================================================
-
-class SyncVerifier {
-  /**
-   * Run all verification checks (built-in + custom)
-   */
-  async verify(
-    projectPath: string,
-    globalPath: string,
-    config?: VerificationConfig
-  ): Promise<VerificationReport> {
-    const totalStart = Date.now()
-    const checks: VerificationCheckResult[] = []
-    const failFast = config?.failFast ?? false
-    let skipped = 0
-
-    // 1. Run built-in checks
-    const builtinChecks = [
-      BUILTIN_CHECKS.contextFilesExist(globalPath),
-      BUILTIN_CHECKS.jsonFilesValid(globalPath),
-      BUILTIN_CHECKS.noSensitiveData(globalPath),
-    ]
-
-    for (const checkPromise of builtinChecks) {
-      const result = await checkPromise
-      checks.push(result)
-      if (!result.passed && failFast) {
-        skipped = config?.checks?.filter((c) => c.enabled !== false).length ?? 0
-        break
-      }
-    }
-
-    // 2. Run custom checks (if configured and not fail-fast-stopped)
-    const shouldContinue = !failFast || checks.every((c) => c.passed)
-    if (shouldContinue && config?.checks) {
-      for (const check of config.checks) {
-        if (check.enabled === false) {
-          skipped++
-          continue
-        }
-
-        const result = await this.runCustomCheck(check, projectPath)
-        checks.push(result)
-
-        if (!result.passed && failFast) {
-          // Count remaining enabled checks as skipped
-          const remaining = config.checks.slice(config.checks.indexOf(check) + 1)
-          skipped += remaining.filter((c) => c.enabled !== false).length
-          break
-        }
-      }
-    }
-
-    const failedCount = checks.filter((c) => !c.passed).length
-    const passedCount = checks.filter((c) => c.passed).length
-
-    return {
-      passed: failedCount === 0,
-      checks,
-      totalMs: Date.now() - totalStart,
-      failedCount,
-      passedCount,
-      skippedCount: skipped,
-    }
-  }
-
-  /**
-   * Run a single custom verification check
-   */
-  private async runCustomCheck(
-    check: VerificationCheck,
-    projectPath: string
-  ): Promise<VerificationCheckResult> {
-    const start = Date.now()
-    const command = check.command || (check.script ? `sh ${check.script}` : null)
-
-    if (!command) {
-      return {
-        name: check.name,
-        passed: false,
-        error: 'No command or script specified',
-        durationMs: Date.now() - start,
-      }
-    }
-
-    try {
-      const { stdout, stderr } = await execAsync(command, {
-        cwd: projectPath,
-        timeout: 30_000,
-      })
-
-      return {
-        name: check.name,
-        passed: true,
-        output: (stdout.trim() || stderr.trim()).slice(0, 200) || undefined,
-        durationMs: Date.now() - start,
-      }
-    } catch (error) {
-      const execError = error as { stdout?: string; stderr?: string; message: string }
-      return {
-        name: check.name,
-        passed: false,
-        error: (execError.stderr?.trim() || execError.message).slice(0, 200),
-        durationMs: Date.now() - start,
-      }
-    }
-  }
-}
-
-// =============================================================================
-// EXPORTS
-// =============================================================================
-
-export const syncVerifier = new SyncVerifier()
-export default syncVerifier

package/core/services/watch-service.ts

@@ -1,312 +0,0 @@
-/**
- * WatchService - Smart file watcher for auto-sync
- *
- * Monitors project files and triggers sync on meaningful changes.
- * Features:
- * - Debouncing to batch rapid changes
- * - Smart filtering of meaningful files
- * - Graceful shutdown
- * - Low CPU/memory footprint
- */
-
-import path from 'node:path'
-import chalk from 'chalk'
-import chokidar, { type FSWatcher } from 'chokidar'
-import configManager from '../infrastructure/config-manager'
-import { getErrorMessage } from '../types/fs'
-import * as dateHelper from '../utils/date-helper'
-import { syncService } from './sync-service'
-
-// ============================================================================
-// TYPES
-// ============================================================================
-
-interface WatchOptions {
-  debounceMs?: number // Debounce window (default: 2000ms)
-  minIntervalMs?: number // Minimum sync interval (default: 30000ms)
-  verbose?: boolean // Show detailed output
-  quiet?: boolean // Suppress all output except errors
-}
-
-interface WatchResult {
-  success: boolean
-  error?: string
-}
-
-// ============================================================================
-// DEFAULT CONFIGURATION
-// ============================================================================
-
-// Files that trigger a sync when changed
-const TRIGGER_PATTERNS = [
-  'package.json',
-  'package-lock.json',
-  'bun.lockb',
-  'pnpm-lock.yaml',
-  'yarn.lock',
-  'tsconfig.json',
-  'tsconfig.*.json',
-  '.env',
-  '.env.*',
-  'Cargo.toml',
-  'go.mod',
-  'pyproject.toml',
-  'requirements.txt',
-  // Source files (new files trigger sync)
-  'src/**/*.ts',
-  'src/**/*.tsx',
-  'src/**/*.js',
-  'src/**/*.jsx',
-  'lib/**/*.ts',
-  'core/**/*.ts',
-  'app/**/*.ts',
-  'app/**/*.tsx',
-  'pages/**/*.ts',
-  'pages/**/*.tsx',
-]
-
-// Patterns to always ignore
-const IGNORE_PATTERNS = [
-  '**/node_modules/**',
-  '**/.git/**',
-  '**/dist/**',
-  '**/build/**',
-  '**/.next/**',
-  '**/.nuxt/**',
-  '**/coverage/**',
-  '**/*.log',
-  '**/*.tmp',
-  '**/CLAUDE.md', // Don't trigger on our own output
-  '**/.cursorrules',
-  '**/.windsurfrules',
-  '**/.prjct/**',
-  '**/.prjct-cli/**',
-]
-
-// ============================================================================
-// WATCH SERVICE
-// ============================================================================
-
-class WatchService {
-  private watcher: FSWatcher | null = null
-  private projectPath: string = ''
-  private projectId: string | null = null
-  private debounceTimer: ReturnType<typeof setTimeout> | null = null
-  private lastSyncTime: number = 0
-  private pendingChanges: Set<string> = new Set()
-  private options: Required<WatchOptions> = {
-    debounceMs: 2000,
-    minIntervalMs: 30000,
-    verbose: false,
-    quiet: false,
-  }
-  private isRunning: boolean = false
-  private syncCount: number = 0
-  private sigintHandler: (() => void) | null = null
-  private sigtermHandler: (() => void) | null = null
-
-  /**
-   * Start watching for file changes
-   */
-  async start(
-    projectPath: string = process.cwd(),
-    options: WatchOptions = {}
-  ): Promise<WatchResult> {
-    this.projectPath = projectPath
-    this.options = { ...this.options, ...options }
-
-    // Get project ID
-    this.projectId = await configManager.getProjectId(projectPath)
-    if (!this.projectId) {
-      return { success: false, error: 'No prjct project. Run "prjct init" first.' }
-    }
-
-    // Check if already running
-    if (this.isRunning) {
-      return { success: false, error: 'Watch mode is already running' }
-    }
-
-    this.isRunning = true
-
-    // Print startup message
-    if (!this.options.quiet) {
-      this.printStartup()
-    }
-
-    // Initialize watcher
-    this.watcher = chokidar.watch(TRIGGER_PATTERNS, {
-      cwd: this.projectPath,
-      ignored: IGNORE_PATTERNS,
-      persistent: true,
-      ignoreInitial: true, // Don't trigger on initial scan
-      awaitWriteFinish: {
-        // Wait for writes to complete
-        stabilityThreshold: 500,
-        pollInterval: 100,
-      },
-    })
-
-    // Set up event handlers
-    this.watcher
-      .on('add', (filePath: string) => this.handleChange('add', filePath))
-      .on('change', (filePath: string) => this.handleChange('change', filePath))
-      .on('unlink', (filePath: string) => this.handleChange('unlink', filePath))
-      .on('error', (error: unknown) => this.handleError(error as Error))
-
-    // Handle graceful shutdown — store references for proper removal
-    if (this.sigintHandler) process.off('SIGINT', this.sigintHandler)
-    if (this.sigtermHandler) process.off('SIGTERM', this.sigtermHandler)
-    this.sigintHandler = () => this.stop()
-    this.sigtermHandler = () => this.stop()
-    process.on('SIGINT', this.sigintHandler)
-    process.on('SIGTERM', this.sigtermHandler)
-
-    return { success: true }
-  }
-
-  /**
-   * Stop watching
-   */
-  async stop(): Promise<void> {
-    if (!this.options.quiet) {
-      console.log('')
-      console.log(chalk.dim(`\n👋 Stopped watching (${this.syncCount} syncs performed)`))
-    }
-
-    if (this.debounceTimer) {
-      clearTimeout(this.debounceTimer)
-      this.debounceTimer = null
-    }
-
-    if (this.watcher) {
-      await this.watcher.close()
-      this.watcher = null
-    }
-
-    // Remove signal handlers to prevent accumulation
-    if (this.sigintHandler) {
-      process.off('SIGINT', this.sigintHandler)
-      this.sigintHandler = null
-    }
-    if (this.sigtermHandler) {
-      process.off('SIGTERM', this.sigtermHandler)
-      this.sigtermHandler = null
-    }
-
-    this.pendingChanges.clear()
-    this.isRunning = false
-    process.exit(0)
-  }
-
-  /**
-   * Handle file change event
-   */
-  private handleChange(event: 'add' | 'change' | 'unlink', filePath: string): void {
-    // Add to pending changes
-    this.pendingChanges.add(filePath)
-
-    if (this.options.verbose && !this.options.quiet) {
-      const eventIcon = event === 'add' ? '➕' : event === 'unlink' ? '➖' : '📝'
-      console.log(chalk.dim(`  ${eventIcon} ${filePath}`))
-    }
-
-    // Debounce the sync
-    this.scheduleSyncIfNeeded()
-  }
-
-  /**
-   * Schedule a sync with debouncing and rate limiting
-   */
-  private scheduleSyncIfNeeded(): void {
-    // Clear existing timer
-    if (this.debounceTimer) {
-      clearTimeout(this.debounceTimer)
-    }
-
-    // Schedule new sync
-    this.debounceTimer = setTimeout(async () => {
-      // Check rate limit
-      const now = Date.now()
-      const timeSinceLastSync = now - this.lastSyncTime
-
-      if (timeSinceLastSync < this.options.minIntervalMs && this.lastSyncTime > 0) {
-        // Too soon, reschedule
-        const waitTime = this.options.minIntervalMs - timeSinceLastSync
-        if (this.options.verbose && !this.options.quiet) {
-          console.log(chalk.dim(`  ⏳ Rate limited, waiting ${Math.round(waitTime / 1000)}s...`))
-        }
-        this.debounceTimer = setTimeout(() => this.performSync(), waitTime)
-        return
-      }
-
-      await this.performSync()
-    }, this.options.debounceMs)
-  }
-
-  /**
-   * Perform the actual sync
-   */
-  private async performSync(): Promise<void> {
-    const changedFiles = Array.from(this.pendingChanges)
-    this.pendingChanges.clear()
-
-    if (changedFiles.length === 0) return
-
-    const timestamp = dateHelper.getTimestamp().split('T')[1].split('.')[0]
-
-    if (!this.options.quiet) {
-      const filesSummary =
-        changedFiles.length === 1 ? changedFiles[0] : `${changedFiles.length} files`
-      console.log(
-        `\n${chalk.dim(`[${timestamp}]`)} ${chalk.cyan('⟳')} ${filesSummary} changed → syncing...`
-      )
-    }
-
-    try {
-      const result = await syncService.sync(this.projectPath, { changedFiles })
-
-      this.lastSyncTime = Date.now()
-      this.syncCount++
-
-      if (result.success) {
-        if (!this.options.quiet) {
-          const agents = result.agents.filter((a) => a.type === 'domain').map((a) => a.name)
-          const agentStr = agents.length > 0 ? ` [${agents.join(', ')}]` : ''
-          console.log(`${chalk.dim(`[${timestamp}]`)} ${chalk.green('✓')} Synced${agentStr}`)
-        }
-      } else {
-        console.error(
-          `${chalk.dim(`[${timestamp}]`)} ${chalk.red('✗')} Sync failed: ${result.error}`
-        )
-      }
-    } catch (error) {
-      console.error(
-        `${chalk.dim(`[${timestamp}]`)} ${chalk.red('✗')} Error: ${getErrorMessage(error)}`
-      )
-    }
-  }
-
-  /**
-   * Handle watcher errors
-   */
-  private handleError(error: Error): void {
-    console.error(chalk.red(`Watch error: ${error.message}`))
-  }
-
-  /**
-   * Print startup message
-   */
-  private printStartup(): void {
-    console.log('')
-    console.log(chalk.cyan('👁️  Watching for changes...'))
-    console.log(chalk.dim(`   Project: ${path.basename(this.projectPath)}`))
-    console.log(chalk.dim(`   Debounce: ${this.options.debounceMs}ms`))
-    console.log(chalk.dim(`   Min interval: ${this.options.minIntervalMs / 1000}s`))
-    console.log('')
-    console.log(chalk.dim('   Press Ctrl+C to stop'))
-    console.log('')
-  }
-}
-
-export const watchService = new WatchService()
-export { WatchService, type WatchOptions, type WatchResult }