prjct-cli 1.22.0 → 1.23.0

package/core/context-tools/types.ts

@@ -1,253 +0,0 @@
-/**
- * Context Tools Types
- *
- * Shared interfaces for all context filtering tools.
- * These tools are designed for AI agents to efficiently explore
- * codebases WITHOUT consuming tokens for filtering.
- *
- * @module context-tools/types
- * @version 1.0.0
- */
-
-// =============================================================================
-// Token Measurement Types
-// =============================================================================
-
-/**
- * Cost savings breakdown by model
- */
-export interface CostBreakdown {
-  model: string
-  inputSaved: number // $ saved on input tokens
-  outputPotential: number // $ potential savings on output (estimated)
-  total: number // Combined savings
-}
-
-/**
- * Token measurement result
- */
-export interface TokenMetrics {
-  tokens: {
-    original: number
-    filtered: number
-    saved: number
-  }
-  compression: number // 0-1 (e.g., 0.90 = 90% reduction)
-  cost: {
-    saved: number // $ saved (using default model)
-    formatted: string // Human-readable (e.g., "$0.02")
-    byModel: CostBreakdown[] // Breakdown by popular models
-  }
-}
-
-// =============================================================================
-// Files Tool Types
-// =============================================================================
-
-/**
- * Relevance score reasons
- */
-export type ScoreReason =
-  | `keyword:${string}` // Matched keyword in path
-  | `domain:${string}` // Matched domain pattern
-  | `recent:${string}` // Recently modified (e.g., "3d" = 3 days)
-  | `import:${number}` // Import distance from entry point
-  | `extension:${string}` // File extension match
-
-/**
- * File with relevance score
- */
-export interface ScoredFile {
-  path: string
-  score: number // 0-1
-  reasons: ScoreReason[]
-}
-
-/**
- * Files tool output
- */
-export interface FilesToolOutput {
-  files: ScoredFile[]
-  metrics: {
-    filesScanned: number
-    filesReturned: number
-    scanDuration: number // ms
-  }
-}
-
-// =============================================================================
-// Signatures Tool Types
-// =============================================================================
-
-/**
- * Code signature types
- */
-export type SignatureType =
-  | 'function'
-  | 'method'
-  | 'class'
-  | 'interface'
-  | 'type'
-  | 'enum'
-  | 'const'
-  | 'variable'
-  | 'export'
-  | 'import'
-
-/**
- * Extracted code signature
- */
-export interface CodeSignature {
-  type: SignatureType
-  name: string
-  signature: string // Full signature string (e.g., "(token: string) => Promise<User>")
-  exported: boolean
-  line: number
-  docstring?: string
-}
-
-/**
- * Signatures tool output
- */
-export interface SignaturesToolOutput {
-  file: string
-  language: string
-  signatures: CodeSignature[]
-  fallback: boolean // True if full file was returned (no grammar)
-  fallbackReason?: string
-  metrics: TokenMetrics
-}
-
-// =============================================================================
-// Imports Tool Types
-// =============================================================================
-
-/**
- * Import relationship
- */
-export interface ImportRelation {
-  source: string // Import path (e.g., "./types", "lodash")
-  resolved: string | null // Resolved file path (null for external)
-  isExternal: boolean
-  importedNames?: string[] // Named imports
-  isDefault?: boolean
-  isNamespace?: boolean // import * as X
-}
-
-/**
- * File that imports the target
- */
-export interface ImportedBy {
-  file: string
-  importedNames?: string[]
-}
-
-/**
- * Dependency tree node
- */
-export interface DependencyNode {
-  file: string
-  imports: DependencyNode[]
-  depth: number
-}
-
-/**
- * Imports tool output
- */
-export interface ImportsToolOutput {
-  file: string
-  imports: ImportRelation[]
-  importedBy: ImportedBy[]
-  dependencyTree?: DependencyNode
-  metrics: {
-    totalImports: number
-    externalImports: number
-    internalImports: number
-    importedByCount: number
-  }
-}
-
-// =============================================================================
-// Recent Tool Types
-// =============================================================================
-
-/**
- * Hot file from git analysis
- */
-export interface HotFile {
-  path: string
-  changes: number // Number of commits touching this file
-  heatScore: number // 0-1 normalized score
-  lastChanged: string // Human-readable (e.g., "2h ago", "3d ago")
-  lastChangedAt: string // ISO timestamp
-}
-
-/**
- * Recent tool output
- */
-export interface RecentToolOutput {
-  hotFiles: HotFile[]
-  branchOnlyFiles: string[] // Files only changed in current branch
-  metrics: {
-    commitsAnalyzed: number
-    totalFilesChanged: number
-    filesReturned: number
-    analysisWindow: string // e.g., "30 commits", "main..HEAD"
-  }
-}
-
-// =============================================================================
-// Summary Tool Types
-// =============================================================================
-
-/**
- * Public API entry
- */
-export interface PublicAPIEntry {
-  name: string
-  type: SignatureType
-  signature: string
-  description?: string // From JSDoc/docstring
-}
-
-/**
- * Summary tool output
- */
-export interface SummaryToolOutput {
-  file: string
-  purpose: string // Short description of file purpose
-  publicAPI: PublicAPIEntry[]
-  dependencies: string[] // Key dependencies
-  metrics: TokenMetrics
-}
-
-// =============================================================================
-// Context Tool Usage Tracking
-// =============================================================================
-
-/**
- * Tool usage record for metrics
- */
-export interface ContextToolUsage {
-  tool: 'files' | 'signatures' | 'imports' | 'recent' | 'summary'
-  timestamp: string
-  inputArgs: string
-  tokensSaved: number
-  compressionRate: number
-  duration: number // ms
-}
-
-// =============================================================================
-// Main Tool Result Type
-// =============================================================================
-
-/**
- * Union type for all tool outputs
- */
-export type ContextToolOutput =
-  | { tool: 'files'; result: FilesToolOutput }
-  | { tool: 'signatures'; result: SignaturesToolOutput }
-  | { tool: 'imports'; result: ImportsToolOutput }
-  | { tool: 'recent'; result: RecentToolOutput }
-  | { tool: 'summary'; result: SummaryToolOutput }
-  | { tool: 'error'; result: { error: string; code: string } }

package/core/domain/agent-generator.ts

@@ -1,186 +0,0 @@
-/**
- * AgentGenerator - Universal Dynamic Agent Generation
- * Optimized for minimal context usage
- * @version 1.0.0
- */
-
-import fs from 'node:fs/promises'
-import os from 'node:os'
-import path from 'node:path'
-import { getErrorMessage } from '../types/fs'
-import log from '../utils/logger'
-import AgentLoader from './agent-loader'
-
-interface AgentConfig {
-  role?: string
-  domain?: string
-  projectContext?: Record<string, unknown> | string
-  expertise?: string
-  contextFilter?: string
-}
-
-// TechSummary and GenerateContext interfaces REMOVED.
-// Agent generation is AGENTIC - Claude reads raw data and decides.
-
-interface Agent {
-  name: string
-  content?: string
-  path?: string
-  role?: string | null
-  domain?: string
-  skills?: string[]
-  modified?: Date
-}
-
-class AgentGenerator {
-  projectId: string | null
-  outputDir: string
-  loader: AgentLoader
-
-  constructor(projectId: string | null = null) {
-    this.projectId = projectId
-    // Write to agents/ for MD storage (matches AgentLoader)
-    this.outputDir = projectId
-      ? path.join(os.homedir(), '.prjct-cli', 'projects', projectId, 'agents')
-      : path.join(os.homedir(), '.prjct-cli', 'agents')
-    this.loader = new AgentLoader(projectId)
-  }
-
-  /**
-   * Generate specialized agent with deep expertise
-   * Universal - works with ANY technology stack
-   * Writes JSON to data/agents/{name}.json
-   */
-  async generateDynamicAgent(agentName: string, config: AgentConfig): Promise<{ name: string }> {
-    log.debug(`Generating ${agentName} agent...`)
-    await fs.mkdir(this.outputDir, { recursive: true })
-
-    // Write as MD (matches AgentLoader which reads .md files)
-    const content = this.buildAgentPrompt(agentName, config)
-    const outputPath = path.join(this.outputDir, `${agentName}.md`)
-    await fs.writeFile(outputPath, content, 'utf-8')
-    log.debug(`${agentName} agent created`)
-
-    return { name: agentName }
-  }
-
-  // NOTE: generateAgentsFromTech() was REMOVED intentionally.
-  // Agent generation is AGENTIC - Claude reads analysis/repo-summary.md
-  // and DECIDES what specialists to create by calling generateDynamicAgent().
-  // DO NOT add any automatic agent generation logic here.
-
-  /**
-   * Build comprehensive agent prompt
-   */
-  buildAgentPrompt(agentName: string, config: AgentConfig): string {
-    const domain = config.domain || 'general'
-
-    const projectContext =
-      typeof config.projectContext === 'object'
-        ? JSON.stringify(config.projectContext || {}, null, 2)
-        : config.projectContext || 'No specific project context provided.'
-
-    return `# AGENT: ${agentName.toUpperCase()}
-Role: ${config.role || agentName}
-
-## META-INSTRUCTION
-You are an intelligent agent responsible for this domain.
-Your first task is to ANALYZE the provided PROJECT CONTEXT to determine:
-1. The technology stack being used.
-2. The architectural patterns in place.
-3. The specific best practices relevant to this stack.
-
-## DOMAIN AUTHORITY
-You are the owner of the ${domain} domain.
-You have full authority to make technical decisions within this scope.
-
-## DYNAMIC STANDARDS
-Instead of following a hardcoded list, you must:
-- **DETECT**: Identify the languages, frameworks, and tools from the file extensions and content.
-- **ADAPT**: Adopt the persona of a Senior Engineer specializing in the detected stack.
-- **ENFORCE**: Apply the idiomatic best practices, naming conventions, and patterns of that stack.
-
-## ORCHESTRATION PROTOCOL
-1. **ANALYZE**: Read the context. Determine the stack.
-2. **PLAN**: Create a plan that fits the detected architecture.
-3. **EXECUTE**: Implement using the detected tools and patterns.
-4. **VERIFY**: Ensure code matches the project's existing style.
-
-## PROJECT CONTEXT
-${projectContext}
-
-## CONTEXT FOCUS
-${config.contextFilter || 'Only relevant files'}
-
-## RULES
-- Stay in your domain (${domain})
-- Do not assume a specific stack until you see the code.
-- Optimize for production.
-- No explanations unless asked.
-`
-  }
-
-  /**
-   * Remove agents that are no longer needed
-   */
-  async cleanupObsoleteAgents(requiredAgents: string[]): Promise<string[]> {
-    const removed: string[] = []
-
-    try {
-      const files = await fs.readdir(this.outputDir)
-      const agentFiles = files.filter((f) => f.endsWith('.md') && !f.startsWith('.'))
-
-      for (const file of agentFiles) {
-        const type = file.replace('.md', '')
-
-        if (!requiredAgents.includes(type)) {
-          const filePath = path.join(this.outputDir, file)
-          await fs.unlink(filePath)
-          removed.push(type)
-          log.debug(`${type} agent removed`)
-        }
-      }
-    } catch (error) {
-      log.error('Agent cleanup failed:', getErrorMessage(error))
-    }
-
-    return removed
-  }
-
-  /**
-   * List all existing agents
-   */
-  async listAgents(): Promise<string[]> {
-    try {
-      const files = await fs.readdir(this.outputDir)
-      return files
-        .filter((f) => f.endsWith('.md') && !f.startsWith('.'))
-        .map((f) => f.replace('.md', ''))
-    } catch (_error) {
-      return []
-    }
-  }
-
-  /**
-   * Load an agent from its file
-   */
-  async loadAgent(agentName: string): Promise<Agent | null> {
-    return await this.loader.loadAgent(agentName)
-  }
-
-  /**
-   * Load all agents for the project
-   */
-  async loadAllAgents(): Promise<Agent[]> {
-    return await this.loader.loadAllAgents()
-  }
-
-  /**
-   * Check if an agent exists
-   */
-  async agentExists(agentName: string): Promise<boolean> {
-    return await this.loader.agentExists(agentName)
-  }
-}
-
-export default AgentGenerator