prjct-cli 1.22.0 → 1.24.0

package/core/services/git-analyzer.ts

@@ -1,293 +0,0 @@
-/**
- * GitAnalyzer - Git repository analysis
- *
- * Extracted from sync-service.ts for single responsibility.
- * Analyzes git state: branch, commits, contributors, changes, etc.
- *
- * Uses graceful degradation for git availability (PRJ-114).
- * Avoids shell pipes for better cross-platform compatibility.
- *
- * @version 1.1.0
- */
-
-import { exec } from 'node:child_process'
-import { promisify } from 'node:util'
-import { getTimeout } from '../constants'
-import { dependencyValidator } from './dependency-validator'
-
-const execAsync = promisify(exec)
-
-// ============================================================================
-// TYPES
-// ============================================================================
-
-export interface GitData {
-  branch: string
-  commits: number
-  contributors: number
-  hasChanges: boolean
-  stagedFiles: string[]
-  modifiedFiles: string[]
-  untrackedFiles: string[]
-  recentCommits: { hash: string; message: string; date: string }[]
-  weeklyCommits: number
-}
-
-// ============================================================================
-// GIT ANALYZER CLASS
-// ============================================================================
-
-export class GitAnalyzer {
-  private projectPath: string
-
-  constructor(projectPath: string) {
-    this.projectPath = projectPath
-  }
-
-  /**
-   * Analyze git repository state
-   * Returns defaults if git is not available (graceful degradation)
-   */
-  async analyze(): Promise<GitData> {
-    const data: GitData = {
-      branch: 'main',
-      commits: 0,
-      contributors: 0,
-      hasChanges: false,
-      stagedFiles: [],
-      modifiedFiles: [],
-      untrackedFiles: [],
-      recentCommits: [],
-      weeklyCommits: 0,
-    }
-
-    // PRJ-114: Check git availability first (graceful degradation)
-    if (!dependencyValidator.isAvailable('git')) {
-      return data
-    }
-
-    try {
-      // Run independent git commands in parallel for speed
-      const [branch, commits, contributors, status, log, weekly] = await Promise.all([
-        this.getBranch(),
-        this.getCommitCount(),
-        this.getContributorCount(),
-        this.getStatus(),
-        this.getRecentCommits(),
-        this.getWeeklyCommitCount(),
-      ])
-
-      data.branch = branch
-      data.commits = commits
-      data.contributors = contributors
-      data.hasChanges = status.hasChanges
-      data.stagedFiles = status.stagedFiles
-      data.modifiedFiles = status.modifiedFiles
-      data.untrackedFiles = status.untrackedFiles
-      data.recentCommits = log
-      data.weeklyCommits = weekly
-    } catch {
-      // Not a git repo - use defaults
-    }
-
-    return data
-  }
-
-  /**
-   * Get current branch name
-   */
-  async getBranch(): Promise<string> {
-    try {
-      const { stdout } = await execAsync('git branch --show-current', {
-        cwd: this.projectPath,
-        timeout: getTimeout('GIT_OPERATION'),
-      })
-      return stdout.trim() || 'main'
-    } catch {
-      return 'main'
-    }
-  }
-
-  /**
-   * Get total commit count
-   */
-  async getCommitCount(): Promise<number> {
-    try {
-      const { stdout } = await execAsync('git rev-list --count HEAD', {
-        cwd: this.projectPath,
-        timeout: getTimeout('GIT_OPERATION'),
-      })
-      return parseInt(stdout.trim(), 10) || 0
-    } catch {
-      return 0
-    }
-  }
-
-  /**
-   * Get contributor count
-   * PRJ-114: Avoids shell pipe by counting lines in JS
-   */
-  async getContributorCount(): Promise<number> {
-    try {
-      const { stdout } = await execAsync('git shortlog -sn --all', {
-        cwd: this.projectPath,
-        timeout: getTimeout('GIT_OPERATION'),
-      })
-      // Count non-empty lines instead of piping to wc -l
-      const lines = stdout.trim().split('\n').filter(Boolean)
-      return lines.length
-    } catch {
-      return 0
-    }
-  }
-
-  /**
-   * Get working tree status
-   */
-  async getStatus(): Promise<{
-    hasChanges: boolean
-    stagedFiles: string[]
-    modifiedFiles: string[]
-    untrackedFiles: string[]
-  }> {
-    const result = {
-      hasChanges: false,
-      stagedFiles: [] as string[],
-      modifiedFiles: [] as string[],
-      untrackedFiles: [] as string[],
-    }
-
-    try {
-      const { stdout } = await execAsync('git status --porcelain', {
-        cwd: this.projectPath,
-        timeout: getTimeout('GIT_OPERATION'),
-      })
-      const lines = stdout.trim().split('\n').filter(Boolean)
-      result.hasChanges = lines.length > 0
-
-      for (const line of lines) {
-        const code = line.substring(0, 2)
-        const file = line.substring(3)
-
-        if (code.startsWith('A') || code.startsWith('M ')) {
-          result.stagedFiles.push(file)
-        } else if (code.includes('M')) {
-          result.modifiedFiles.push(file)
-        } else if (code.startsWith('??')) {
-          result.untrackedFiles.push(file)
-        }
-      }
-    } catch {
-      // Not a git repo
-    }
-
-    return result
-  }
-
-  /**
-   * Get recent commits
-   */
-  async getRecentCommits(
-    count: number = 20
-  ): Promise<{ hash: string; message: string; date: string }[]> {
-    try {
-      const { stdout } = await execAsync(
-        `git log --oneline -${count} --pretty=format:"%h|%s|%ad" --date=short`,
-        { cwd: this.projectPath, timeout: getTimeout('GIT_OPERATION') }
-      )
-
-      return stdout
-        .split('\n')
-        .filter(Boolean)
-        .map((line) => {
-          const [hash, message, date] = line.split('|')
-          return { hash, message, date }
-        })
-    } catch {
-      return []
-    }
-  }
-
-  /**
-   * Get commit count in the last week
-   * PRJ-114: Avoids shell pipe by counting lines in JS
-   */
-  async getWeeklyCommitCount(): Promise<number> {
-    try {
-      const { stdout } = await execAsync('git log --oneline --since="1 week ago"', {
-        cwd: this.projectPath,
-        timeout: getTimeout('GIT_OPERATION'),
-      })
-      // Count non-empty lines instead of piping to wc -l
-      const lines = stdout.trim().split('\n').filter(Boolean)
-      return lines.length
-    } catch {
-      return 0
-    }
-  }
-
-  /**
-   * Check if directory is a git repository
-   */
-  async isGitRepo(): Promise<boolean> {
-    try {
-      await execAsync('git rev-parse --is-inside-work-tree', {
-        cwd: this.projectPath,
-        timeout: getTimeout('GIT_OPERATION'),
-      })
-      return true
-    } catch {
-      return false
-    }
-  }
-
-  /**
-   * Get default main branch name (main or master)
-   * PRJ-114: Avoids shell pipe by using JS string replace
-   */
-  async getDefaultBranch(): Promise<string> {
-    try {
-      // Try to get from remote
-      const { stdout } = await execAsync('git symbolic-ref refs/remotes/origin/HEAD', {
-        cwd: this.projectPath,
-        timeout: getTimeout('GIT_OPERATION'),
-      })
-      // Use JS replace instead of piping to sed
-      const branch = stdout.trim().replace(/^refs\/remotes\/origin\//, '')
-      if (branch) return branch
-    } catch {
-      // Ignore - remote may not exist
-    }
-
-    // Fallback: check if main or master exists
-    try {
-      await execAsync('git show-ref --verify --quiet refs/heads/main', {
-        cwd: this.projectPath,
-        timeout: getTimeout('GIT_OPERATION'),
-      })
-      return 'main'
-    } catch {
-      return 'master'
-    }
-  }
-}
-
-/**
- * Get empty GitData for non-git repos or errors
- */
-export function getEmptyGitData(): GitData {
-  return {
-    branch: 'main',
-    commits: 0,
-    contributors: 0,
-    hasChanges: false,
-    stagedFiles: [],
-    modifiedFiles: [],
-    untrackedFiles: [],
-    recentCommits: [],
-    weeklyCommits: 0,
-  }
-}
-
-export const gitAnalyzer = (projectPath: string) => new GitAnalyzer(projectPath)
-export default GitAnalyzer

package/core/services/hierarchical-agent-resolver.ts

@@ -1,236 +0,0 @@
-/**
- * HierarchicalAgentResolver - Resolves agents from hierarchical AGENTS.md files
- *
- * This service bridges:
- * - NestedContextResolver (discovers AGENTS.md files in directory tree)
- * - AgentLoader (loads generated agent files from global storage)
- *
- * Pattern: "Scope = directory tree. Deeper files take precedence."
- */
-
-import path from 'node:path'
-import NestedContextResolver, {
-  type AgentDefinition,
-  type NestedAgents,
-  type ResolvedAgents,
-} from './nested-context-resolver'
-
-// ============================================================================
-// TYPES
-// ============================================================================
-
-export interface HierarchicalAgent {
-  /** Agent name (e.g., "frontend", "backend") */
-  name: string
-  /** Resolved description from hierarchy */
-  description: string
-  /** Domain specialization */
-  domain: string | null
-  /** Merged triggers from all levels */
-  triggers: string[]
-  /** Merged rules from all levels */
-  rules: string[]
-  /** Merged patterns from all levels */
-  patterns: string[]
-  /** Sources that contributed to this agent (paths) */
-  sources: string[]
-  /** Whether this agent was overridden at some level */
-  wasOverridden: boolean
-  /** Effort level hint for Claude's adaptive reasoning depth */
-  effort?: 'low' | 'medium' | 'high' | 'max'
-}
-
-export interface AgentResolutionResult {
-  /** Resolved agents for the target path */
-  agents: HierarchicalAgent[]
-  /** Root path of the resolution */
-  rootPath: string
-  /** Target path that was resolved */
-  targetPath: string
-  /** All AGENTS.md files discovered */
-  discoveredFiles: string[]
-  /** Agents that were overridden during resolution */
-  overriddenAgents: string[]
-}
-
-// ============================================================================
-// HIERARCHICAL AGENT RESOLVER
-// ============================================================================
-
-export class HierarchicalAgentResolver {
-  private resolver: NestedContextResolver
-  private rootPath: string
-  private initialized = false
-
-  constructor(rootPath: string) {
-    this.rootPath = path.resolve(rootPath)
-    this.resolver = new NestedContextResolver(this.rootPath)
-  }
-
-  /**
-   * Initialize the resolver (detects monorepo structure)
-   */
-  async initialize(): Promise<void> {
-    if (!this.initialized) {
-      await this.resolver.initialize()
-      this.initialized = true
-    }
-  }
-
-  /**
-   * Resolve agents for a specific directory path
-   * Returns merged agents following hierarchical inheritance
-   */
-  async resolveAgentsForPath(targetPath: string): Promise<AgentResolutionResult> {
-    await this.initialize()
-
-    const resolved = await this.resolver.resolveAgentsForPath(targetPath)
-    const allAgentFiles = await this.resolver.discoverAgentFiles()
-
-    return {
-      agents: resolved.agents.map((agent) => this.toHierarchicalAgent(agent, resolved)),
-      rootPath: this.rootPath,
-      targetPath: path.resolve(targetPath),
-      discoveredFiles: allAgentFiles.map((af) => af.path),
-      overriddenAgents: resolved.overrides.map((o) => o.split(':')[1]),
-    }
-  }
-
-  /**
-   * Resolve agents for the root project
-   */
-  async resolveRootAgents(): Promise<AgentResolutionResult> {
-    return this.resolveAgentsForPath(this.rootPath)
-  }
-
-  /**
-   * Get a specific agent by name for a path
-   */
-  async getAgentByName(agentName: string, targetPath?: string): Promise<HierarchicalAgent | null> {
-    const result = await this.resolveAgentsForPath(targetPath || this.rootPath)
-    return result.agents.find((a) => a.name.toLowerCase() === agentName.toLowerCase()) || null
-  }
-
-  /**
-   * Get all available agent names across the hierarchy
-   */
-  async getAllAgentNames(): Promise<string[]> {
-    await this.initialize()
-
-    const agentFiles = await this.resolver.discoverAgentFiles()
-    const names = new Set<string>()
-
-    for (const file of agentFiles) {
-      for (const agent of file.agents) {
-        names.add(agent.name)
-      }
-    }
-
-    return Array.from(names).sort()
-  }
-
-  /**
-   * Check if a specific agent exists anywhere in the hierarchy
-   */
-  async agentExists(agentName: string): Promise<boolean> {
-    const names = await this.getAllAgentNames()
-    return names.some((n) => n.toLowerCase() === agentName.toLowerCase())
-  }
-
-  /**
-   * Get the raw AGENTS.md file tree structure
-   */
-  async getAgentFileTree(): Promise<NestedAgents[]> {
-    await this.initialize()
-    return this.resolver.discoverAgentFiles()
-  }
-
-  /**
-   * Convert AgentDefinition to HierarchicalAgent
-   */
-  private toHierarchicalAgent(agent: AgentDefinition, resolved: ResolvedAgents): HierarchicalAgent {
-    const wasOverridden = resolved.overrides.some((o) => o.split(':')[1] === agent.name)
-
-    return {
-      name: agent.name,
-      description: agent.description,
-      domain: agent.domain || null,
-      triggers: agent.triggers || [],
-      rules: agent.rules || [],
-      patterns: agent.patterns || [],
-      sources: resolved.sources,
-      wasOverridden,
-    }
-  }
-
-  /**
-   * Generate markdown content for an agent (for use with AgentLoader)
-   */
-  generateAgentMarkdown(agent: HierarchicalAgent): string {
-    const parts: string[] = []
-
-    // Header
-    parts.push(`# ${agent.name} Agent`)
-    parts.push('')
-
-    // Description
-    if (agent.description) {
-      parts.push(agent.description)
-      parts.push('')
-    }
-
-    // Domain
-    if (agent.domain) {
-      parts.push(`## DOMAIN AUTHORITY`)
-      parts.push('')
-      parts.push(`This agent specializes in the ${agent.domain} domain.`)
-      parts.push('')
-    }
-
-    // Triggers
-    if (agent.triggers.length > 0) {
-      parts.push(`## Triggers`)
-      parts.push('')
-      for (const trigger of agent.triggers) {
-        parts.push(`- ${trigger}`)
-      }
-      parts.push('')
-    }
-
-    // Rules
-    if (agent.rules.length > 0) {
-      parts.push(`## Rules`)
-      parts.push('')
-      for (const rule of agent.rules) {
-        parts.push(`- ${rule}`)
-      }
-      parts.push('')
-    }
-
-    // Patterns
-    if (agent.patterns.length > 0) {
-      parts.push(`## Patterns`)
-      parts.push('')
-      for (const pattern of agent.patterns) {
-        parts.push('```')
-        parts.push(pattern)
-        parts.push('```')
-        parts.push('')
-      }
-    }
-
-    // Source attribution
-    if (agent.sources.length > 0) {
-      parts.push(`---`)
-      parts.push(`*Resolved from: ${agent.sources.join(' → ')}*`)
-    }
-
-    return parts.join('\n')
-  }
-}
-
-// ============================================================================
-// EXPORTS
-// ============================================================================
-
-export default HierarchicalAgentResolver