prjct-cli 1.22.0 → 1.24.0

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

@@ -1,286 +0,0 @@
-/**
- * Issue Tracker Manager
- * Orchestrates multiple issue tracker providers and enrichment.
- */
-
-import { getErrorMessage } from '../../types/fs'
-import { jiraProvider } from '../jira/client'
-import { linearProvider } from '../linear/client'
-import {
-  buildEnrichedIssue,
-  type EnrichmentResult,
-  formatEnrichmentAsMarkdown,
-  generateEnrichmentPrompt,
-  generateQuickEnrichment,
-  type ProjectContext,
-} from './enricher'
-import type {
-  CreateIssueInput,
-  EnrichedIssue,
-  FetchOptions,
-  Issue,
-  IssueProvider,
-  IssueTrackerConfig,
-  IssueTrackerProvider,
-  SyncResult,
-} from './types'
-
-// =============================================================================
-// Manager Class
-// =============================================================================
-
-export class IssueTrackerManager {
-  private providers: Map<IssueProvider, IssueTrackerProvider> = new Map()
-  private activeProvider: IssueTrackerProvider | null = null
-  private config: IssueTrackerConfig | null = null
-
-  constructor() {
-    // Register available providers
-    this.providers.set('linear', linearProvider)
-    this.providers.set('jira', jiraProvider)
-    // Future: this.providers.set('monday', mondayProvider)
-  }
-
-  /**
-   * Initialize manager with config
-   */
-  async initialize(config: IssueTrackerConfig): Promise<void> {
-    this.config = config
-
-    if (!config.enabled) {
-      console.log('[issue-tracker] Integration disabled')
-      return
-    }
-
-    const provider = this.providers.get(config.provider)
-    if (!provider) {
-      throw new Error(`Unknown issue tracker provider: ${config.provider}`)
-    }
-
-    await provider.initialize(config)
-    this.activeProvider = provider
-
-    console.log(`[issue-tracker] Initialized ${provider.displayName}`)
-  }
-
-  /**
-   * Check if manager is ready
-   */
-  isReady(): boolean {
-    return this.activeProvider?.isConfigured() === true
-  }
-
-  /**
-   * Get the active provider
-   */
-  getProvider(): IssueTrackerProvider | null {
-    return this.activeProvider
-  }
-
-  /**
-   * Get provider name
-   */
-  getProviderName(): string {
-    return this.activeProvider?.displayName || 'None'
-  }
-
-  // ===========================================================================
-  // Issue Operations
-  // ===========================================================================
-
-  /**
-   * Fetch assigned issues
-   */
-  async fetchAssignedIssues(options?: FetchOptions): Promise<Issue[]> {
-    if (!this.activeProvider) {
-      throw new Error('No issue tracker configured')
-    }
-    return this.activeProvider.fetchAssignedIssues(options)
-  }
-
-  /**
-   * Fetch single issue
-   */
-  async fetchIssue(id: string): Promise<Issue | null> {
-    if (!this.activeProvider) {
-      throw new Error('No issue tracker configured')
-    }
-    return this.activeProvider.fetchIssue(id)
-  }
-
-  /**
-   * Create issue
-   */
-  async createIssue(input: CreateIssueInput): Promise<Issue> {
-    if (!this.activeProvider) {
-      throw new Error('No issue tracker configured')
-    }
-    return this.activeProvider.createIssue(input)
-  }
-
-  /**
-   * Mark issue in progress
-   */
-  async markInProgress(id: string): Promise<void> {
-    if (!this.activeProvider) {
-      throw new Error('No issue tracker configured')
-    }
-    return this.activeProvider.markInProgress(id)
-  }
-
-  /**
-   * Mark issue done
-   */
-  async markDone(id: string): Promise<void> {
-    if (!this.activeProvider) {
-      throw new Error('No issue tracker configured')
-    }
-    return this.activeProvider.markDone(id)
-  }
-
-  // ===========================================================================
-  // Enrichment Operations
-  // ===========================================================================
-
-  /**
-   * Enrich an issue with AI-generated context
-   * Returns the enrichment prompt for Claude to execute
-   */
-  getEnrichmentPrompt(issue: Issue, projectContext: ProjectContext): string {
-    return generateEnrichmentPrompt(issue, projectContext)
-  }
-
-  /**
-   * Build enriched issue from AI result
-   */
-  buildEnrichedIssue(issue: Issue, enrichment: EnrichmentResult): EnrichedIssue {
-    return buildEnrichedIssue(issue, enrichment)
-  }
-
-  /**
-   * Format enrichment as markdown for provider update
-   */
-  formatEnrichment(enrichment: EnrichmentResult): string {
-    return formatEnrichmentAsMarkdown(enrichment)
-  }
-
-  /**
-   * Quick enrichment without AI
-   */
-  quickEnrich(issue: Issue): EnrichedIssue {
-    const enrichment = generateQuickEnrichment(issue)
-    return buildEnrichedIssue(issue, enrichment)
-  }
-
-  /**
-   * Update issue with enrichment in provider
-   */
-  async pushEnrichment(issue: Issue, enrichment: EnrichmentResult): Promise<Issue> {
-    if (!this.activeProvider) {
-      throw new Error('No issue tracker configured')
-    }
-
-    if (!this.config?.enrichment.updateProvider) {
-      console.log('[issue-tracker] Skipping provider update (disabled)')
-      return issue
-    }
-
-    const markdown = formatEnrichmentAsMarkdown(enrichment)
-    return this.activeProvider.updateIssue(issue.id, {
-      description: markdown,
-    })
-  }
-
-  // ===========================================================================
-  // Sync Operations
-  // ===========================================================================
-
-  /**
-   * Sync and optionally enrich assigned issues
-   */
-  async syncAssignedIssues(
-    projectContext: ProjectContext,
-    options?: {
-      enrich?: boolean
-      limit?: number
-    }
-  ): Promise<SyncResult> {
-    if (!this.activeProvider) {
-      throw new Error('No issue tracker configured')
-    }
-
-    const result: SyncResult = {
-      provider: this.activeProvider.name,
-      fetched: 0,
-      enriched: 0,
-      updated: 0,
-      errors: [],
-      timestamp: new Date().toISOString(),
-    }
-
-    try {
-      // Fetch issues
-      const issues = await this.activeProvider.fetchAssignedIssues({
-        limit: options?.limit || 20,
-        includeCompleted: false,
-      })
-      result.fetched = issues.length
-
-      console.log(`[issue-tracker] Fetched ${issues.length} issues`)
-
-      // Enrich if requested
-      if (options?.enrich && this.config?.enrichment.enabled) {
-        for (const issue of issues) {
-          try {
-            // Generate prompt (actual AI execution is external)
-            const _prompt = this.getEnrichmentPrompt(issue, projectContext)
-            console.log(`[issue-tracker] Enrichment prompt ready for ${issue.externalId}`)
-
-            // For now, use quick enrichment as placeholder
-            // Real enrichment happens through Claude Code execution
-            result.enriched++
-          } catch (error) {
-            result.errors.push({
-              issueId: issue.externalId,
-              error: getErrorMessage(error),
-            })
-          }
-        }
-      }
-
-      return result
-    } catch (error) {
-      result.errors.push({
-        issueId: 'sync',
-        error: getErrorMessage(error),
-      })
-      return result
-    }
-  }
-
-  // ===========================================================================
-  // Team/Project Operations
-  // ===========================================================================
-
-  /**
-   * Get available teams
-   */
-  async getTeams(): Promise<Array<{ id: string; name: string; key?: string }>> {
-    if (!this.activeProvider) return []
-    return this.activeProvider.getTeams()
-  }
-
-  /**
-   * Get available projects
-   */
-  async getProjects(): Promise<Array<{ id: string; name: string }>> {
-    if (!this.activeProvider) return []
-    return this.activeProvider.getProjects()
-  }
-}
-
-// =============================================================================
-// Singleton Instance
-// =============================================================================
-
-export const issueTrackerManager = new IssueTrackerManager()

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

@@ -1,310 +0,0 @@
-/**
- * Issue Tracker Abstraction Types
- * Unified interface for Linear, Jira, Monday, and other issue trackers.
- */
-
-// =============================================================================
-// Core Issue Types
-// =============================================================================
-
-/**
- * Normalized issue from any tracker
- */
-export interface Issue {
-  id: string
-  externalId: string // Original ID from provider (e.g., "ENG-123")
-  provider: IssueProvider
-  title: string
-  description?: string
-  status: IssueStatus
-  priority: IssuePriority
-  type: IssueType
-  assignee?: {
-    id: string
-    name: string
-    email?: string
-  }
-  labels: string[]
-  project?: {
-    id: string
-    name: string
-  }
-  team?: {
-    id: string
-    name: string
-    key?: string
-  }
-  url: string
-  createdAt: string
-  updatedAt: string
-  // Original data from provider
-  raw?: unknown
-}
-
-/**
- * Enriched issue with AI-generated context
- */
-export interface EnrichedIssue extends Issue {
-  enrichment: {
-    description: string // Enhanced description
-    acceptanceCriteria: string[] // Generated ACs
-    affectedFiles: string[] // Files likely to change
-    technicalNotes: string // Implementation hints
-    estimatedComplexity: 'trivial' | 'small' | 'medium' | 'large' | 'epic'
-    suggestedApproach?: string // High-level approach
-    relatedCode?: {
-      file: string
-      relevance: string
-    }[]
-    generatedAt: string
-  }
-}
-
-/**
- * Input for creating issues
- */
-export interface CreateIssueInput {
-  title: string
-  description?: string
-  priority?: IssuePriority
-  type?: IssueType
-  labels?: string[]
-  projectId?: string
-  teamId?: string
-  assigneeId?: string
-}
-
-/**
- * Update input for issues
- */
-export interface UpdateIssueInput {
-  title?: string
-  description?: string
-  priority?: IssuePriority
-  assigneeId?: string | null // null to unassign
-  stateId?: string
-  projectId?: string
-  labels?: string[]
-  // Provider-specific: may update custom fields for AC, etc.
-  customFields?: Record<string, unknown>
-}
-
-// =============================================================================
-// Enums
-// =============================================================================
-
-export type IssueProvider = 'linear' | 'jira' | 'monday' | 'github' | 'asana' | 'none'
-
-export type IssueStatus = 'backlog' | 'todo' | 'in_progress' | 'in_review' | 'done' | 'cancelled'
-
-export type IssuePriority = 'none' | 'urgent' | 'high' | 'medium' | 'low'
-
-export type IssueType = 'feature' | 'bug' | 'improvement' | 'task' | 'chore' | 'epic'
-
-// =============================================================================
-// Provider Interface
-// =============================================================================
-
-/**
- * Interface for issue tracker providers
- * Implement this for each provider (Linear, Jira, Monday, etc.)
- */
-export interface IssueTrackerProvider {
-  readonly name: IssueProvider
-  readonly displayName: string
-
-  /**
-   * Check if provider is configured and ready
-   */
-  isConfigured(): boolean
-
-  /**
-   * Initialize the provider with config
-   */
-  initialize(config: IssueTrackerConfig): Promise<void>
-
-  /**
-   * Get issues assigned to current user
-   */
-  fetchAssignedIssues(options?: FetchOptions): Promise<Issue[]>
-
-  /**
-   * Get issues from a specific team/project
-   */
-  fetchTeamIssues(teamId: string, options?: FetchOptions): Promise<Issue[]>
-
-  /**
-   * Get a single issue by ID
-   */
-  fetchIssue(id: string): Promise<Issue | null>
-
-  /**
-   * Create a new issue
-   */
-  createIssue(input: CreateIssueInput): Promise<Issue>
-
-  /**
-   * Update an issue (for enrichment)
-   */
-  updateIssue(id: string, input: UpdateIssueInput): Promise<Issue>
-
-  /**
-   * Mark issue as in progress
-   */
-  markInProgress(id: string): Promise<void>
-
-  /**
-   * Mark issue as done/completed
-   */
-  markDone(id: string): Promise<void>
-
-  /**
-   * Get available teams
-   */
-  getTeams(): Promise<Array<{ id: string; name: string; key?: string }>>
-
-  /**
-   * Get available projects
-   */
-  getProjects(): Promise<Array<{ id: string; name: string }>>
-}
-
-// =============================================================================
-// Configuration Types
-// =============================================================================
-
-/**
- * Base config for all providers
- */
-export interface IssueTrackerConfig {
-  enabled: boolean
-  provider: IssueProvider
-  // API authentication
-  apiKey?: string
-  accessToken?: string
-  // Default team/project for new issues
-  defaultTeamId?: string
-  defaultProjectId?: string
-  // Sync preferences
-  syncOn: {
-    task: boolean // Sync on p. task
-    done: boolean // Sync on p. done
-    ship: boolean // Sync on p. ship
-  }
-  // Enrichment settings
-  enrichment: {
-    enabled: boolean
-    updateProvider: boolean // Push enriched description back to provider
-  }
-  // Metadata
-  setupAt?: string
-  lastSyncAt?: string
-}
-
-/**
- * Linear-specific config
- */
-export interface LinearConfig extends IssueTrackerConfig {
-  provider: 'linear'
-  // Linear-specific settings
-  teamKey?: string // e.g., "ENG"
-}
-
-/**
- * Jira-specific config (future)
- */
-export interface JiraConfig extends IssueTrackerConfig {
-  provider: 'jira'
-  baseUrl: string // e.g., "https://company.atlassian.net"
-  projectKey?: string
-}
-
-/**
- * Monday-specific config (future)
- */
-export interface MondayConfig extends IssueTrackerConfig {
-  provider: 'monday'
-  boardId?: string
-}
-
-/**
- * GitHub Issues config (future)
- */
-export interface GitHubConfig extends IssueTrackerConfig {
-  provider: 'github'
-  owner: string // e.g., "anthropics"
-  repo: string // e.g., "claude-code"
-}
-
-// =============================================================================
-// Fetch Options
-// =============================================================================
-
-export interface FetchOptions {
-  limit?: number
-  status?: IssueStatus[]
-  includeCompleted?: boolean
-  since?: string // ISO date
-
-  /**
-   * Scope filter - who's issues to fetch
-   * Default: 'mine' (only issues assigned to current user)
-   */
-  scope?: 'mine' | 'team' | 'project' | 'unassigned'
-
-  /**
-   * Project filter (when scope is 'project')
-   */
-  projectId?: string
-
-  /**
-   * Team filter (when scope is 'team')
-   */
-  teamId?: string
-}
-
-// =============================================================================
-// Sync Result
-// =============================================================================
-
-export interface SyncResult {
-  provider: IssueProvider
-  fetched: number
-  enriched: number
-  updated: number
-  errors: Array<{ issueId: string; error: string }>
-  timestamp: string
-}
-
-// =============================================================================
-// Default Configs
-// =============================================================================
-
-export const DEFAULT_LINEAR_CONFIG: LinearConfig = {
-  enabled: false,
-  provider: 'linear',
-  syncOn: {
-    task: true,
-    done: true,
-    ship: true,
-  },
-  enrichment: {
-    enabled: true,
-    updateProvider: true,
-  },
-}
-
-export const DEFAULT_JIRA_CONFIG: JiraConfig = {
-  enabled: false,
-  provider: 'jira',
-  baseUrl: '',
-  syncOn: {
-    task: true,
-    done: true,
-    ship: true,
-  },
-  enrichment: {
-    enabled: true,
-    updateProvider: true,
-  },
-}

package/core/integrations/jira/cache.ts

@@ -1,57 +0,0 @@
-/**
- * JIRA Cache Module
- * 5-minute TTL cache for JIRA API responses to reduce API calls
- */
-
-import { TTLCache } from '../../utils/cache'
-import type { Issue } from '../issue-tracker/types'
-
-// 5-minute TTL for JIRA API responses
-const JIRA_CACHE_TTL = 5 * 60 * 1000 // 300000ms
-
-/**
- * Cache for individual issues (by key like "ENG-123" or ID)
- * Key format: "issue:{key}" or "issue:{id}"
- */
-export const issueCache = new TTLCache<Issue>({
-  ttl: JIRA_CACHE_TTL,
-  maxSize: 100,
-})
-
-/**
- * Cache for assigned issues list
- * Key format: "assigned:{userId}" or "assigned:me"
- */
-export const assignedIssuesCache = new TTLCache<Issue[]>({
-  ttl: JIRA_CACHE_TTL,
-  maxSize: 10,
-})
-
-/**
- * Cache for projects list
- * Key format: "projects"
- */
-export const projectsCache = new TTLCache<Array<{ id: string; name: string; key?: string }>>({
-  ttl: JIRA_CACHE_TTL,
-  maxSize: 5,
-})
-
-/**
- * Clear all JIRA caches
- */
-export function clearJiraCache(): void {
-  issueCache.clear()
-  assignedIssuesCache.clear()
-  projectsCache.clear()
-}
-
-/**
- * Get cache statistics for debugging
- */
-export function getJiraCacheStats() {
-  return {
-    issues: issueCache.stats(),
-    assignedIssues: assignedIssuesCache.stats(),
-    projects: projectsCache.stats(),
-  }
-}