prjct-cli 1.22.0 → 1.23.0

package/core/infrastructure/update-checker.ts

@@ -1,246 +0,0 @@
-/**
- * UpdateChecker - Checks for package updates from npm registry
- *
- * @version 0.5.0
- */
-
-import fs from 'node:fs/promises'
-import https from 'node:https'
-import os from 'node:os'
-import path from 'node:path'
-import chalk from 'chalk'
-import { getErrorMessage } from '../types/fs'
-import { fileExists } from '../utils/fs-helpers'
-
-interface UpdateCache {
-  lastCheck: number
-  latestVersion: string
-}
-
-interface UpdateResult {
-  updateAvailable: boolean
-  currentVersion: string
-  latestVersion: string
-}
-
-class UpdateChecker {
-  packageName: string
-  cacheDir: string
-  cacheFile: string
-  checkInterval: number
-
-  constructor() {
-    this.packageName = 'prjct-cli'
-    this.cacheDir = path.join(os.homedir(), '.prjct-cli', 'config')
-    this.cacheFile = path.join(this.cacheDir, 'update-cache.json')
-    this.checkInterval = 24 * 60 * 60 * 1000 // 24 hours in milliseconds
-  }
-
-  /**
-   * Get current installed version from package.json
-   */
-  async getCurrentVersion(): Promise<string | null> {
-    try {
-      const packageJsonPath = path.join(__dirname, '..', '..', 'package.json')
-      const packageJson = JSON.parse(await fs.readFile(packageJsonPath, 'utf8'))
-      return packageJson.version
-    } catch (error) {
-      console.error('Error reading package version:', getErrorMessage(error))
-      return null
-    }
-  }
-
-  /**
-   * Fetch latest version from npm registry
-   */
-  async getLatestVersion(): Promise<string> {
-    return new Promise((resolve, reject) => {
-      const options = {
-        hostname: 'registry.npmjs.org',
-        path: `/${this.packageName}/latest`,
-        method: 'GET',
-        headers: {
-          'User-Agent': 'prjct-cli-update-checker',
-          Accept: 'application/json',
-        },
-      }
-
-      const req = https.request(options, (res) => {
-        let data = ''
-
-        res.on('data', (chunk) => {
-          data += chunk
-        })
-
-        res.on('end', () => {
-          try {
-            if (res.statusCode === 200) {
-              const packageData = JSON.parse(data)
-              resolve(packageData.version)
-            } else {
-              reject(new Error(`npm registry returned status ${res.statusCode}`))
-            }
-          } catch (error) {
-            reject(error)
-          }
-        })
-      })
-
-      req.on('error', (error) => {
-        reject(error)
-      })
-
-      req.setTimeout(5000, () => {
-        req.destroy()
-        reject(new Error('Request timeout'))
-      })
-
-      req.end()
-    })
-  }
-
-  /**
-   * Compare two semantic versions
-   * Returns: 1 if v1 > v2, -1 if v1 < v2, 0 if equal
-   */
-  compareVersions(v1: string, v2: string): number {
-    const parts1 = v1.split('.').map(Number)
-    const parts2 = v2.split('.').map(Number)
-
-    for (let i = 0; i < 3; i++) {
-      const part1 = parts1[i] || 0
-      const part2 = parts2[i] || 0
-
-      if (part1 > part2) return 1
-      if (part1 < part2) return -1
-    }
-
-    return 0
-  }
-
-  /**
-   * Read cache file
-   */
-  async readCache(): Promise<UpdateCache | null> {
-    try {
-      if (await fileExists(this.cacheFile)) {
-        const cache = JSON.parse(await fs.readFile(this.cacheFile, 'utf8'))
-        return cache
-      }
-    } catch (_error) {
-      // Cache file doesn't exist or is corrupted - expected
-    }
-    return null
-  }
-
-  /**
-   * Write cache file
-   */
-  async writeCache(data: UpdateCache): Promise<void> {
-    try {
-      // Ensure cache directory exists
-      if (!(await fileExists(this.cacheDir))) {
-        await fs.mkdir(this.cacheDir, { recursive: true })
-      }
-
-      await fs.writeFile(this.cacheFile, JSON.stringify(data, null, 2), 'utf8')
-    } catch (_error) {
-      // Fail silently - cache is not critical
-    }
-  }
-
-  /**
-   * Check if update is available (respects 24-hour cache)
-   * Returns: { updateAvailable: boolean, currentVersion: string, latestVersion: string } or null
-   */
-  async checkForUpdates(): Promise<UpdateResult | null> {
-    try {
-      const currentVersion = await this.getCurrentVersion()
-      if (!currentVersion) {
-        return null
-      }
-
-      // Check cache first
-      const cache = await this.readCache()
-      const now = Date.now()
-
-      if (cache?.lastCheck && now - cache.lastCheck < this.checkInterval) {
-        // Cache is still valid
-        if (cache.latestVersion && this.compareVersions(cache.latestVersion, currentVersion) > 0) {
-          return {
-            updateAvailable: true,
-            currentVersion,
-            latestVersion: cache.latestVersion,
-          }
-        }
-        return {
-          updateAvailable: false,
-          currentVersion,
-          latestVersion: currentVersion,
-        }
-      }
-
-      // Cache expired or doesn't exist, fetch from npm
-      const latestVersion = await this.getLatestVersion()
-
-      // Update cache
-      await this.writeCache({
-        lastCheck: now,
-        latestVersion,
-      })
-
-      // Compare versions
-      const updateAvailable = this.compareVersions(latestVersion, currentVersion) > 0
-
-      return {
-        updateAvailable,
-        currentVersion,
-        latestVersion,
-      }
-    } catch (_error) {
-      // Network error or other issue - fail silently (expected)
-      // Return null to indicate check couldn't be performed
-      return null
-    }
-  }
-
-  /**
-   * Get formatted update notification message
-   */
-  async getUpdateNotification(): Promise<string | null> {
-    const result = await this.checkForUpdates()
-
-    if (!result || !result.updateAvailable) {
-      return null
-    }
-
-    return (
-      '\n' +
-      chalk.yellow('┌───────────────────────────────────────────────────────────┐') +
-      '\n' +
-      chalk.yellow('│') +
-      '  ' +
-      chalk.bold('Update available!') +
-      ' ' +
-      chalk.dim(`${result.currentVersion} → ${result.latestVersion}`) +
-      '  ' +
-      chalk.yellow('│') +
-      '\n' +
-      chalk.yellow('│') +
-      '                                                           ' +
-      chalk.yellow('│') +
-      '\n' +
-      chalk.yellow('│') +
-      '  Run: ' +
-      chalk.cyan('npm update -g prjct-cli') +
-      '                       ' +
-      chalk.yellow('│') +
-      '\n' +
-      chalk.yellow('└───────────────────────────────────────────────────────────┘') +
-      '\n'
-    )
-  }
-}
-
-export default UpdateChecker
-export { UpdateChecker }

package/core/integrations/issue-tracker/enricher.ts

@@ -1,271 +0,0 @@
-/**
- * Issue Enricher
- * Generates rich context for issues using AI analysis of the codebase.
- *
- * This module provides prompts and templates for Claude to enrich issues.
- * The actual AI call happens through Claude Code's execution context.
- */
-
-import { getErrorMessage } from '../../types/fs'
-import type { EnrichedIssue, Issue } from './types'
-
-// =============================================================================
-// Enrichment Templates
-// =============================================================================
-
-/**
- * Generate enrichment prompt
- * This prompt can be used with any AI assistant (Claude, ChatGPT, Copilot, Gemini, etc.)
- */
-export function generateEnrichmentPrompt(issue: Issue, projectContext: ProjectContext): string {
-  return `
-# Issue Enrichment Request
-
-## Original Issue
-- **ID**: ${issue.externalId}
-- **Title**: ${issue.title}
-- **Type**: ${issue.type}
-- **Priority**: ${issue.priority}
-- **Current Description**: ${issue.description || '(no description provided)'}
-- **Labels**: ${issue.labels.join(', ') || 'none'}
-- **Team**: ${issue.team?.name || 'unknown'}
-
-## Project Context
-- **Project**: ${projectContext.name}
-- **Tech Stack**: ${projectContext.techStack.join(', ')}
-- **Key Directories**: ${projectContext.keyDirectories.join(', ')}
-
-## Your Task
-
-Analyze this issue and the codebase to generate comprehensive enrichment.
-
-### 1. Enhanced Description
-Write a clear, detailed description that includes:
-- What the user/stakeholder is trying to achieve
-- Why this change is needed
-- Any relevant context from similar features in the codebase
-
-### 2. Acceptance Criteria
-Generate 3-7 specific, testable acceptance criteria in the format:
-- [ ] When [action], then [expected result]
-
-### 3. Affected Files
-Based on the issue title and codebase analysis, identify files likely to be modified:
-- List specific file paths
-- Explain why each file is relevant
-
-### 4. Technical Notes
-Provide implementation hints:
-- Relevant existing patterns to follow
-- Potential gotchas or edge cases
-- Dependencies or related code
-
-### 5. Complexity Estimate
-Rate as: trivial | small | medium | large | epic
-Explain your reasoning.
-
-### 6. Suggested Approach (optional)
-If there are multiple ways to implement this, suggest the recommended approach.
-
----
-
-**Format your response as JSON matching the EnrichedIssue.enrichment schema.**
-`.trim()
-}
-
-/**
- * Generate copy-paste ready LLM prompt
- * Compatible with Claude, ChatGPT, Copilot, Gemini, Cursor, etc.
- */
-export function generateLLMPrompt(
-  issue: Issue,
-  projectContext: ProjectContext,
-  enrichment: EnrichmentResult
-): string {
-  const filesList = enrichment.affectedFiles.map((f) => `- ${f}`).join('\n')
-
-  const acList = enrichment.acceptanceCriteria.map((ac) => `- [ ] ${ac}`).join('\n')
-
-  return `## Task: ${issue.title}
-
-### Context
-I'm working on a codebase with the following structure:
-- Stack: ${projectContext.techStack.join(', ')}
-- Key directories: ${projectContext.keyDirectories.join(', ')}
-
-### Problem
-${enrichment.description}
-
-### What needs to be done
-${enrichment.technicalNotes}
-
-### Files to modify
-${filesList || '(analyze codebase to identify)'}
-
-### Reference implementation
-${enrichment.suggestedApproach || 'Follow existing patterns in the codebase.'}
-
-### Acceptance criteria
-${acList}
-
-### How to verify
-1. Run tests to ensure nothing is broken
-2. Manually test the affected functionality
-3. Review code for edge cases
-
----
-*Generated by prjct - Use with any AI assistant*
-`.trim()
-}
-
-// =============================================================================
-// Types
-// =============================================================================
-
-export interface ProjectContext {
-  name: string
-  techStack: string[]
-  keyDirectories: string[]
-  recentCommits?: string[]
-  patterns?: Record<string, string>
-}
-
-export interface EnrichmentResult {
-  description: string
-  acceptanceCriteria: string[]
-  affectedFiles: string[]
-  technicalNotes: string
-  estimatedComplexity: 'trivial' | 'small' | 'medium' | 'large' | 'epic'
-  suggestedApproach?: string
-  relatedCode?: Array<{ file: string; relevance: string }>
-}
-
-// =============================================================================
-// Enrichment Helpers
-// =============================================================================
-
-/**
- * Build enriched issue from result
- */
-export function buildEnrichedIssue(issue: Issue, enrichment: EnrichmentResult): EnrichedIssue {
-  return {
-    ...issue,
-    enrichment: {
-      ...enrichment,
-      generatedAt: new Date().toISOString(),
-    },
-  }
-}
-
-/**
- * Format enrichment as markdown for updating issue description
- */
-export function formatEnrichmentAsMarkdown(enrichment: EnrichmentResult): string {
-  const sections: string[] = []
-
-  // Description
-  sections.push(enrichment.description)
-  sections.push('')
-
-  // Acceptance Criteria
-  sections.push('## Acceptance Criteria')
-  for (const ac of enrichment.acceptanceCriteria) {
-    sections.push(`- [ ] ${ac}`)
-  }
-  sections.push('')
-
-  // Technical Notes
-  if (enrichment.technicalNotes) {
-    sections.push('## Technical Notes')
-    sections.push(enrichment.technicalNotes)
-    sections.push('')
-  }
-
-  // Affected Files
-  if (enrichment.affectedFiles.length > 0) {
-    sections.push('## Affected Files')
-    for (const file of enrichment.affectedFiles) {
-      sections.push(`- \`${file}\``)
-    }
-    sections.push('')
-  }
-
-  // Complexity
-  sections.push(`**Estimated Complexity**: ${enrichment.estimatedComplexity}`)
-
-  // Footer
-  sections.push('')
-  sections.push('---')
-  sections.push('*Enriched by prjct*')
-
-  return sections.join('\n')
-}
-
-/**
- * Parse JSON enrichment response from Claude
- */
-export function parseEnrichmentResponse(response: string): EnrichmentResult | null {
-  try {
-    // Extract JSON from response (may be wrapped in markdown code block)
-    const jsonMatch =
-      response.match(/```(?:json)?\s*([\s\S]*?)```/) || response.match(/\{[\s\S]*\}/)
-
-    if (!jsonMatch) {
-      console.error('[enricher] No JSON found in response')
-      return null
-    }
-
-    const jsonStr = jsonMatch[1] || jsonMatch[0]
-    const parsed = JSON.parse(jsonStr)
-
-    // Validate required fields
-    if (!parsed.description || !parsed.acceptanceCriteria || !parsed.estimatedComplexity) {
-      console.error('[enricher] Missing required fields in enrichment')
-      return null
-    }
-
-    return {
-      description: parsed.description,
-      acceptanceCriteria: Array.isArray(parsed.acceptanceCriteria) ? parsed.acceptanceCriteria : [],
-      affectedFiles: Array.isArray(parsed.affectedFiles) ? parsed.affectedFiles : [],
-      technicalNotes: parsed.technicalNotes || '',
-      estimatedComplexity: parsed.estimatedComplexity,
-      suggestedApproach: parsed.suggestedApproach,
-      relatedCode: parsed.relatedCode,
-    }
-  } catch (error) {
-    console.error('[enricher] Failed to parse enrichment:', getErrorMessage(error))
-    return null
-  }
-}
-
-// =============================================================================
-// Quick Enrichment (Minimal AI)
-// =============================================================================
-
-/**
- * Generate basic enrichment without full AI analysis
- * Useful for quick syncs or when AI is unavailable
- */
-export function generateQuickEnrichment(issue: Issue): EnrichmentResult {
-  const typeToComplexity: Record<string, 'trivial' | 'small' | 'medium' | 'large'> = {
-    bug: 'small',
-    chore: 'trivial',
-    task: 'small',
-    improvement: 'medium',
-    feature: 'medium',
-    epic: 'large',
-  }
-
-  return {
-    description: issue.description || `Implement: ${issue.title}`,
-    acceptanceCriteria: [
-      `The ${issue.type} "${issue.title}" is implemented`,
-      'All existing tests pass',
-      'New functionality is tested',
-    ],
-    affectedFiles: [],
-    technicalNotes: 'Analyze codebase to identify affected files and implementation approach.',
-    estimatedComplexity: typeToComplexity[issue.type] || 'medium',
-  }
-}

package/core/integrations/issue-tracker/index.ts

@@ -1,8 +0,0 @@
-/**
- * Issue Tracker Integration
- * Unified interface for Linear, Jira, Monday, and other issue trackers.
- */
-
-export * from './enricher'
-export { IssueTrackerManager, issueTrackerManager } from './manager'
-export * from './types'