prjct-cli 1.22.0 → 1.23.0

package/core/services/dependency-validator.ts

@@ -1,318 +0,0 @@
-/**
- * Dependency Validator
- *
- * Provides graceful degradation for missing system dependencies.
- * Checks tool availability before operations and provides helpful
- * recovery hints when tools are missing.
- *
- * Pattern from Google Gemini CLI: "Never assumes library availability.
- * Checks --help before using unknown flags."
- *
- * @see PRJ-114
- */
-
-import { execSync } from 'node:child_process'
-import { createError, type ErrorWithHint } from '../utils/error-messages'
-
-// ============================================================================
-// TYPES
-// ============================================================================
-
-export interface ToolDefinition {
-  name: string
-  command: string // Command to check availability (e.g., 'git --version')
-  versionRegex?: RegExp // Regex to extract version from output
-  required: boolean // If false, missing tool is a warning, not error
-  installHint: string // How to install if missing
-  docs?: string // Documentation URL
-}
-
-export interface ToolStatus {
-  available: boolean
-  version?: string
-  error?: ErrorWithHint
-}
-
-// ============================================================================
-// TOOL DEFINITIONS
-// ============================================================================
-
-/**
- * Known tools that prjct depends on
- */
-export const TOOLS: Record<string, ToolDefinition> = {
-  git: {
-    name: 'git',
-    command: 'git --version',
-    versionRegex: /git version ([\d.]+)/,
-    required: true,
-    installHint: 'Install Git: https://git-scm.com/downloads',
-    docs: 'https://git-scm.com/doc',
-  },
-  node: {
-    name: 'node',
-    command: 'node --version',
-    versionRegex: /v([\d.]+)/,
-    required: true,
-    installHint: 'Install Node.js: https://nodejs.org',
-    docs: 'https://nodejs.org/docs',
-  },
-  bun: {
-    name: 'bun',
-    command: 'bun --version',
-    versionRegex: /([\d.]+)/,
-    required: false,
-    installHint: 'Install Bun: curl -fsSL https://bun.sh/install | bash',
-    docs: 'https://bun.sh/docs',
-  },
-  gh: {
-    name: 'gh',
-    command: 'gh --version',
-    versionRegex: /gh version ([\d.]+)/,
-    required: false,
-    installHint: 'Install GitHub CLI: https://cli.github.com',
-    docs: 'https://cli.github.com/manual',
-  },
-  npm: {
-    name: 'npm',
-    command: 'npm --version',
-    versionRegex: /([\d.]+)/,
-    required: false,
-    installHint: 'npm comes with Node.js: https://nodejs.org',
-  },
-  claude: {
-    name: 'claude',
-    command: 'claude --version',
-    versionRegex: /claude ([\d.]+)/,
-    required: false,
-    installHint: 'Install Claude Code: npm install -g @anthropic-ai/claude-code',
-    docs: 'https://docs.anthropic.com/claude-code',
-  },
-  gemini: {
-    name: 'gemini',
-    command: 'gemini --version',
-    versionRegex: /gemini ([\d.]+)/,
-    required: false,
-    installHint: 'Install Gemini CLI: npm install -g @google/gemini-cli',
-    docs: 'https://ai.google.dev/gemini-api/docs',
-  },
-}
-
-// ============================================================================
-// DEPENDENCY VALIDATOR
-// ============================================================================
-
-class DependencyValidator {
-  private cache = new Map<string, ToolStatus>()
-  private cacheTimeout = 60_000 // 1 minute cache
-  private cacheTimestamps = new Map<string, number>()
-
-  /**
-   * Check if a tool is available
-   * Uses caching to avoid repeated execSync calls
-   */
-  checkTool(toolName: string): ToolStatus {
-    // Check cache first
-    const cached = this.getCached(toolName)
-    if (cached) return cached
-
-    const definition = TOOLS[toolName]
-    if (!definition) {
-      // Unknown tool - try to check directly
-      return this.checkUnknownTool(toolName)
-    }
-
-    const status = this.executeCheck(definition)
-    this.setCache(toolName, status)
-    return status
-  }
-
-  /**
-   * Ensure a tool is available, throw helpful error if not
-   * Use this before operations that require a specific tool
-   */
-  ensureTool(toolName: string): void {
-    const status = this.checkTool(toolName)
-
-    if (!status.available) {
-      const definition = TOOLS[toolName]
-      const error = status.error || {
-        message: `${toolName} is not available`,
-        hint: definition?.installHint || `Install ${toolName} and try again`,
-        docs: definition?.docs,
-      }
-
-      throw new DependencyError(error)
-    }
-  }
-
-  /**
-   * Ensure multiple tools are available
-   */
-  ensureTools(toolNames: string[]): void {
-    const missing: string[] = []
-
-    for (const name of toolNames) {
-      const status = this.checkTool(name)
-      if (!status.available) {
-        missing.push(name)
-      }
-    }
-
-    if (missing.length > 0) {
-      const hints = missing
-        .map((name) => {
-          const def = TOOLS[name]
-          return def ? `  ${name}: ${def.installHint}` : `  ${name}: Install and try again`
-        })
-        .join('\n')
-
-      throw new DependencyError({
-        message: `Missing required tools: ${missing.join(', ')}`,
-        hint: `Install the following:\n${hints}`,
-      })
-    }
-  }
-
-  /**
-   * Check if tool is available (boolean convenience method)
-   */
-  isAvailable(toolName: string): boolean {
-    return this.checkTool(toolName).available
-  }
-
-  /**
-   * Get tool version if available
-   */
-  getVersion(toolName: string): string | undefined {
-    return this.checkTool(toolName).version
-  }
-
-  /**
-   * Check multiple tools and return summary
-   */
-  checkAll(toolNames?: string[]): Map<string, ToolStatus> {
-    const names = toolNames || Object.keys(TOOLS)
-    const results = new Map<string, ToolStatus>()
-
-    for (const name of names) {
-      results.set(name, this.checkTool(name))
-    }
-
-    return results
-  }
-
-  /**
-   * Clear the cache (useful for tests or after installations)
-   */
-  clearCache(): void {
-    this.cache.clear()
-    this.cacheTimestamps.clear()
-  }
-
-  // ==========================================================================
-  // PRIVATE METHODS
-  // ==========================================================================
-
-  private executeCheck(definition: ToolDefinition): ToolStatus {
-    try {
-      const output = execSync(definition.command, {
-        encoding: 'utf-8',
-        stdio: ['pipe', 'pipe', 'pipe'],
-        timeout: 5000, // 5 second timeout
-      })
-
-      let version: string | undefined
-      if (definition.versionRegex) {
-        const match = output.match(definition.versionRegex)
-        version = match ? match[1] : undefined
-      }
-
-      return { available: true, version }
-    } catch {
-      return {
-        available: false,
-        error: createError(
-          `${definition.name} is not installed or not in PATH`,
-          definition.installHint,
-          { docs: definition.docs }
-        ),
-      }
-    }
-  }
-
-  private checkUnknownTool(toolName: string): ToolStatus {
-    try {
-      // Try running with --version (common convention)
-      execSync(`${toolName} --version`, {
-        encoding: 'utf-8',
-        stdio: ['pipe', 'pipe', 'pipe'],
-        timeout: 5000,
-      })
-      return { available: true }
-    } catch {
-      // Try running with -v
-      try {
-        execSync(`${toolName} -v`, {
-          encoding: 'utf-8',
-          stdio: ['pipe', 'pipe', 'pipe'],
-          timeout: 5000,
-        })
-        return { available: true }
-      } catch {
-        return {
-          available: false,
-          error: createError(
-            `${toolName} is not installed or not in PATH`,
-            `Install ${toolName} and try again`
-          ),
-        }
-      }
-    }
-  }
-
-  private getCached(toolName: string): ToolStatus | null {
-    const timestamp = this.cacheTimestamps.get(toolName)
-    if (!timestamp) return null
-
-    // Check if cache is expired
-    if (Date.now() - timestamp > this.cacheTimeout) {
-      this.cache.delete(toolName)
-      this.cacheTimestamps.delete(toolName)
-      return null
-    }
-
-    return this.cache.get(toolName) || null
-  }
-
-  private setCache(toolName: string, status: ToolStatus): void {
-    this.cache.set(toolName, status)
-    this.cacheTimestamps.set(toolName, Date.now())
-  }
-}
-
-// ============================================================================
-// CUSTOM ERROR
-// ============================================================================
-
-/**
- * Error thrown when a required dependency is missing
- */
-export class DependencyError extends Error {
-  readonly hint?: string
-  readonly docs?: string
-
-  constructor(error: ErrorWithHint) {
-    super(error.message)
-    this.name = 'DependencyError'
-    this.hint = error.hint
-    this.docs = error.docs
-  }
-}
-
-// ============================================================================
-// EXPORTS
-// ============================================================================
-
-export const dependencyValidator = new DependencyValidator()
-export default dependencyValidator

package/core/services/diff-generator.ts

@@ -1,313 +0,0 @@
-/**
- * Diff Generator for Sync Preview
- *
- * Generates human-readable diffs between old and new context files.
- * Shows what will change before sync applies.
- *
- * @see PRJ-125
- * @module services/diff-generator
- */
-
-import chalk from 'chalk'
-import type { DiffOptions, ParsedMarkdownSection, SyncDiff } from '../types'
-
-export type {
-  DiffOptions,
-  DiffSection,
-  ParsedMarkdownSection,
-  PreservedInfo,
-  SyncDiff,
-} from '../types'
-
-// =============================================================================
-// Constants
-// =============================================================================
-
-const CHARS_PER_TOKEN = 4
-
-// =============================================================================
-// Token Estimation
-// =============================================================================
-
-/**
- * Estimate token count for content
- */
-export function estimateTokens(content: string): number {
-  return Math.ceil(content.length / CHARS_PER_TOKEN)
-}
-
-// =============================================================================
-// Section Parsing
-// =============================================================================
-
-/**
- * Parse markdown into sections based on headers
- */
-export function parseMarkdownSections(content: string): ParsedMarkdownSection[] {
-  const lines = content.split('\n')
-  const sections: ParsedMarkdownSection[] = []
-  let currentSection: ParsedMarkdownSection | null = null
-
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i]
-    const headerMatch = line.match(/^(#{1,3})\s+(.+)$/)
-
-    if (headerMatch) {
-      // Save previous section
-      if (currentSection) {
-        currentSection.endLine = i - 1
-        sections.push(currentSection)
-      }
-
-      // Start new section
-      currentSection = {
-        name: headerMatch[2].trim(),
-        content: line,
-        startLine: i,
-        endLine: i,
-      }
-    } else if (currentSection) {
-      currentSection.content += `\n${line}`
-    }
-  }
-
-  // Save last section
-  if (currentSection) {
-    currentSection.endLine = lines.length - 1
-    sections.push(currentSection)
-  }
-
-  return sections
-}
-
-/**
- * Check if content is within a preserve block
- */
-function isPreservedSection(content: string): boolean {
-  return content.includes('<!-- prjct:preserve')
-}
-
-// =============================================================================
-// Diff Generation
-// =============================================================================
-
-/**
- * Generate diff between old and new content
- */
-export function generateSyncDiff(oldContent: string, newContent: string): SyncDiff {
-  const oldSections = parseMarkdownSections(oldContent)
-  const newSections = parseMarkdownSections(newContent)
-
-  const diff: SyncDiff = {
-    hasChanges: false,
-    added: [],
-    modified: [],
-    removed: [],
-    preserved: [],
-    tokensBefore: estimateTokens(oldContent),
-    tokensAfter: estimateTokens(newContent),
-    tokenDelta: 0,
-  }
-
-  diff.tokenDelta = diff.tokensAfter - diff.tokensBefore
-
-  // Create maps for quick lookup
-  const oldMap = new Map(oldSections.map((s) => [s.name.toLowerCase(), s]))
-  const newMap = new Map(newSections.map((s) => [s.name.toLowerCase(), s]))
-
-  // Find preserved sections in old content
-  for (const section of oldSections) {
-    if (isPreservedSection(section.content)) {
-      diff.preserved.push({
-        name: section.name,
-        lineCount: section.content.split('\n').length,
-      })
-    }
-  }
-
-  // Find added and modified sections
-  for (const newSection of newSections) {
-    const key = newSection.name.toLowerCase()
-    const oldSection = oldMap.get(key)
-
-    if (!oldSection) {
-      // New section
-      diff.added.push({
-        name: newSection.name,
-        type: 'added',
-        after: newSection.content,
-        lineCount: newSection.content.split('\n').length,
-      })
-      diff.hasChanges = true
-    } else if (oldSection.content.trim() !== newSection.content.trim()) {
-      // Modified section (skip if preserved)
-      if (!isPreservedSection(oldSection.content)) {
-        diff.modified.push({
-          name: newSection.name,
-          type: 'modified',
-          before: oldSection.content,
-          after: newSection.content,
-          lineCount: newSection.content.split('\n').length,
-        })
-        diff.hasChanges = true
-      }
-    }
-  }
-
-  // Find removed sections
-  for (const oldSection of oldSections) {
-    const key = oldSection.name.toLowerCase()
-    if (!newMap.has(key) && !isPreservedSection(oldSection.content)) {
-      diff.removed.push({
-        name: oldSection.name,
-        type: 'removed',
-        before: oldSection.content,
-        lineCount: oldSection.content.split('\n').length,
-      })
-      diff.hasChanges = true
-    }
-  }
-
-  return diff
-}
-
-// =============================================================================
-// Diff Formatting
-// =============================================================================
-
-/**
- * Format diff for terminal display
- */
-export function formatDiffPreview(diff: SyncDiff, options: DiffOptions = {}): string {
-  const { colorize = true } = options
-  const lines: string[] = []
-
-  const green = colorize ? chalk.green : (s: string) => s
-  const red = colorize ? chalk.red : (s: string) => s
-  const yellow = colorize ? chalk.yellow : (s: string) => s
-  const dim = colorize ? chalk.dim : (s: string) => s
-  const bold = colorize ? chalk.bold : (s: string) => s
-
-  if (!diff.hasChanges) {
-    lines.push(dim('No changes detected (context is up to date)'))
-    return lines.join('\n')
-  }
-
-  lines.push('')
-  lines.push(bold('📋 Changes to context files:'))
-  lines.push('')
-
-  // Added sections
-  if (diff.added.length > 0) {
-    for (const section of diff.added) {
-      lines.push(green(`+ │ + ${section.name} (new)`))
-    }
-  }
-
-  // Modified sections
-  if (diff.modified.length > 0) {
-    for (const section of diff.modified) {
-      lines.push(yellow(`~ │   ${section.name} (modified)`))
-    }
-  }
-
-  // Removed sections
-  if (diff.removed.length > 0) {
-    for (const section of diff.removed) {
-      lines.push(red(`- │ - ${section.name} (removed)`))
-    }
-  }
-
-  // Preserved sections
-  if (diff.preserved.length > 0) {
-    lines.push('')
-    lines.push(dim('  ## Your Customizations'))
-    for (const section of diff.preserved) {
-      lines.push(dim(`  │ ✓ ${section.name} (${section.lineCount} lines preserved)`))
-    }
-  }
-
-  // Summary
-  lines.push('')
-  lines.push(dim('────────────────────────────────'))
-
-  const summaryParts: string[] = []
-  if (diff.added.length > 0) summaryParts.push(green(`+${diff.added.length} added`))
-  if (diff.modified.length > 0) summaryParts.push(yellow(`~${diff.modified.length} modified`))
-  if (diff.removed.length > 0) summaryParts.push(red(`-${diff.removed.length} removed`))
-
-  lines.push(`Summary: ${summaryParts.join(', ') || 'no changes'}`)
-
-  // Token delta
-  const tokenSign = diff.tokenDelta >= 0 ? '+' : ''
-  const tokenColor = diff.tokenDelta >= 0 ? green : red
-  lines.push(
-    `Tokens: ${diff.tokensBefore.toLocaleString()} → ${diff.tokensAfter.toLocaleString()} (${tokenColor(tokenSign + diff.tokenDelta.toLocaleString())})`
-  )
-
-  lines.push('')
-
-  return lines.join('\n')
-}
-
-/**
- * Format full git-style diff
- */
-export function formatFullDiff(diff: SyncDiff, options: DiffOptions = {}): string {
-  const { colorize = true } = options
-  const lines: string[] = []
-
-  const green = colorize ? chalk.green : (s: string) => s
-  const red = colorize ? chalk.red : (s: string) => s
-  const cyan = colorize ? chalk.cyan : (s: string) => s
-  const dim = colorize ? chalk.dim : (s: string) => s
-
-  // Added sections
-  for (const section of diff.added) {
-    lines.push(cyan(`@@ +${section.name} @@`))
-    if (section.after) {
-      for (const line of section.after.split('\n')) {
-        lines.push(green(`+ ${line}`))
-      }
-    }
-    lines.push('')
-  }
-
-  // Modified sections
-  for (const section of diff.modified) {
-    lines.push(cyan(`@@ ${section.name} @@`))
-    if (section.before) {
-      for (const line of section.before.split('\n').slice(0, 5)) {
-        lines.push(red(`- ${line}`))
-      }
-      if (section.before.split('\n').length > 5) {
-        lines.push(dim(`  ... ${section.before.split('\n').length - 5} more lines`))
-      }
-    }
-    if (section.after) {
-      for (const line of section.after.split('\n').slice(0, 5)) {
-        lines.push(green(`+ ${line}`))
-      }
-      if (section.after.split('\n').length > 5) {
-        lines.push(dim(`  ... ${section.after.split('\n').length - 5} more lines`))
-      }
-    }
-    lines.push('')
-  }
-
-  // Removed sections
-  for (const section of diff.removed) {
-    lines.push(cyan(`@@ -${section.name} @@`))
-    if (section.before) {
-      for (const line of section.before.split('\n').slice(0, 5)) {
-        lines.push(red(`- ${line}`))
-      }
-      if (section.before.split('\n').length > 5) {
-        lines.push(dim(`  ... ${section.before.split('\n').length - 5} more lines`))
-      }
-    }
-    lines.push('')
-  }
-
-  return lines.join('\n')
-}