prjct-cli 0.44.1 → 0.45.3

package/core/context-tools/types.ts

@@ -0,0 +1,253 @@
+/**
+ * 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

@@ -4,11 +4,11 @@
  * @version 1.0.0
  */
 
-import fs from 'fs/promises'
-import path from 'path'
-import os from 'os'
-import AgentLoader from './agent-loader'
+import fs from 'node:fs/promises'
+import os from 'node:os'
+import path from 'node:path'
 import log from '../utils/logger'
+import AgentLoader from './agent-loader'
 
 interface AgentConfig {
   role?: string
@@ -152,7 +152,9 @@ ${config.contextFilter || 'Only relevant files'}
   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', ''))
+      return files
+        .filter((f) => f.endsWith('.md') && !f.startsWith('.'))
+        .map((f) => f.replace('.md', ''))
     } catch (_error) {
       return []
     }

package/core/domain/agent-loader.ts

@@ -6,8 +6,8 @@
  * @version 1.0.0
  */
 
-import fs from 'fs/promises'
-import path from 'path'
+import fs from 'node:fs/promises'
+import path from 'node:path'
 import pathManager from '../infrastructure/path-manager'
 import { isNotFoundError } from '../types/fs'
 

package/core/domain/analyzer.ts

@@ -10,10 +10,10 @@
  * @version 0.6.0 - Fully agentic refactor
  */
 
-import fs from 'fs/promises'
-import path from 'path'
-import { promisify } from 'util'
-import { exec as execCallback } from 'child_process'
+import { exec as execCallback } from 'node:child_process'
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import { promisify } from 'node:util'
 import { isNotFoundError } from '../types/fs'
 
 const exec = promisify(execCallback)
@@ -209,11 +209,11 @@ class CodebaseAnalyzer {
         .forEach((line) => {
           const match = line.trim().match(/^\s*(\d+)\s+(\.\w+)$/)
           if (match) {
-            extensions[match[2]] = parseInt(match[1])
+            extensions[match[2]] = parseInt(match[1], 10)
           }
         })
       return extensions
-    } catch (error) {
+    } catch (_error) {
       // exec errors (find command not available, etc.) - return empty
       return {}
     }
@@ -278,7 +278,7 @@ class CodebaseAnalyzer {
         cwd: this.projectPath!,
       })
       return stdout
-    } catch (error) {
+    } catch (_error) {
       // Git errors (not a repo, git not installed) - return empty
       return ''
     }
@@ -297,16 +297,19 @@ class CodebaseAnalyzer {
         cwd: this.projectPath!,
       })
 
-      const { stdout: firstCommit } = await exec('git log --reverse --pretty=format:"%ar" | head -1', {
-        cwd: this.projectPath!,
-      })
+      const { stdout: firstCommit } = await exec(
+        'git log --reverse --pretty=format:"%ar" | head -1',
+        {
+          cwd: this.projectPath!,
+        }
+      )
 
       return {
-        totalCommits: parseInt(totalCommits.trim()) || 0,
-        contributors: parseInt(contributors.trim()) || 0,
+        totalCommits: parseInt(totalCommits.trim(), 10) || 0,
+        contributors: parseInt(contributors.trim(), 10) || 0,
         age: firstCommit.trim() || 'unknown',
       }
-    } catch (error) {
+    } catch (_error) {
       // Git errors (not a repo, git not installed) - return defaults
       return {
         totalCommits: 0,
@@ -325,8 +328,8 @@ class CodebaseAnalyzer {
         'find . -type f ! -path "*/node_modules/*" ! -path "*/.git/*" ! -path "*/dist/*" | wc -l',
         { cwd: this.projectPath! }
       )
-      return parseInt(stdout.trim()) || 0
-    } catch (error) {
+      return parseInt(stdout.trim(), 10) || 0
+    } catch (_error) {
       // exec errors (find command not available, etc.) - return 0
       return 0
     }
@@ -372,7 +375,7 @@ class CodebaseAnalyzer {
         { cwd: this.projectPath! }
       )
       return stdout.trim().split('\n').filter(Boolean)
-    } catch (error) {
+    } catch (_error) {
       // exec errors (find command not available, etc.) - return empty
       return []
     }

package/core/domain/architecture-generator.ts

@@ -4,8 +4,8 @@
  * This file only provides structure - real content from Claude
  */
 
-import path from 'path'
-import fs from 'fs/promises'
+import fs from 'node:fs/promises'
+import path from 'node:path'
 
 interface ArchitectureContext {
   [key: string]: unknown
@@ -40,7 +40,10 @@ class ArchitectureGenerator {
    * Generate architecture skeleton
    * AGENTIC: Claude fills in content using templates
    */
-  async generateArchitecture(idea: string, context: ArchitectureContext = {}): Promise<Architecture> {
+  async generateArchitecture(
+    idea: string,
+    _context: ArchitectureContext = {}
+  ): Promise<Architecture> {
     // Return skeleton - Claude generates actual content via templates
     return {
       id: `arch-${Date.now()}`,

package/core/domain/context-estimator.ts

@@ -7,7 +7,6 @@
  * @version 1.0.0
  */
 
-import path from 'path'
 import { glob } from 'glob'
 import log from '../utils/logger'
 
@@ -79,7 +78,7 @@ class ContextEstimator {
    * 100% AGENTIC: Uses REAL project data, not hardcoded patterns.
    * No domain-specific assumptions or language→extension mapping.
    */
-  getPatternsForDomain(domain: string, projectData: ProjectTech): FilePatterns {
+  getPatternsForDomain(_domain: string, projectData: ProjectTech): FilePatterns {
     const patterns: FilePatterns = {
       include: [],
       extensions: [],
@@ -87,7 +86,7 @@ class ContextEstimator {
     }
 
     // Use REAL extensions from project (if provided in projectData)
-    if (projectData && projectData.extensions) {
+    if (projectData?.extensions) {
       // projectData.extensions is {'.js': 45, '.ts': 23, ...}
       patterns.extensions = Object.keys(projectData.extensions)
         .filter((ext) => ext.startsWith('.'))
@@ -95,7 +94,7 @@ class ContextEstimator {
     }
 
     // Use REAL directories from project (if provided in projectData)
-    if (projectData && projectData.directories) {
+    if (projectData?.directories) {
       patterns.include = projectData.directories.filter((dir) => !patterns.exclude.includes(dir))
     }
 

package/core/domain/snapshot-manager.ts

@@ -9,13 +9,13 @@
  * @version 1.0.0
  */
 
-import fs from 'fs/promises'
-import path from 'path'
-import { exec } from 'child_process'
-import { promisify } from 'util'
-import pathManager from '../infrastructure/path-manager'
-import configManager from '../infrastructure/config-manager'
+import { exec } from 'node:child_process'
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import { promisify } from 'node:util'
 import { emit } from '../bus'
+import configManager from '../infrastructure/config-manager'
+import pathManager from '../infrastructure/path-manager'
 import { isNotFoundError } from '../types/fs'
 
 const execAsync = promisify(exec)
@@ -100,7 +100,9 @@ class SnapshotManager {
     await execAsync(`git config user.name "prjct-snapshots"`, { cwd: this.snapshotDir! })
 
     // Create initial empty commit
-    await execAsync(`git commit --allow-empty -m "init: snapshot system"`, { cwd: this.snapshotDir! })
+    await execAsync(`git commit --allow-empty -m "init: snapshot system"`, {
+      cwd: this.snapshotDir!,
+    })
   }
 
   /**
@@ -236,9 +238,12 @@ class SnapshotManager {
     if (!this.initialized) await this.initialize()
 
     // Get files changed in that commit
-    const { stdout: filesOutput } = await execAsync(`git diff-tree --no-commit-id --name-only -r ${hash}`, {
-      cwd: this.snapshotDir!,
-    })
+    const { stdout: filesOutput } = await execAsync(
+      `git diff-tree --no-commit-id --name-only -r ${hash}`,
+      {
+        cwd: this.snapshotDir!,
+      }
+    )
 
     const files = filesOutput.split('\n').filter(Boolean)
 
@@ -337,11 +342,10 @@ class SnapshotManager {
    */
   async logSnapshot(snapshot: SnapshotInfo): Promise<void> {
     const manifestPath = path.join(this.snapshotDir!, 'manifest.jsonl')
-    const entry =
-      JSON.stringify({
-        type: 'snapshot',
-        ...snapshot,
-      }) + '\n'
+    const entry = `${JSON.stringify({
+      type: 'snapshot',
+      ...snapshot,
+    })}\n`
 
     await fs.appendFile(manifestPath, entry)
   }
@@ -351,13 +355,12 @@ class SnapshotManager {
    */
   async logRestore(hash: string, files: string[]): Promise<void> {
     const manifestPath = path.join(this.snapshotDir!, 'manifest.jsonl')
-    const entry =
-      JSON.stringify({
-        type: 'restore',
-        hash,
-        files,
-        timestamp: new Date().toISOString(),
-      }) + '\n'
+    const entry = `${JSON.stringify({
+      type: 'restore',
+      hash,
+      files,
+      timestamp: new Date().toISOString(),
+    })}\n`
 
     await fs.appendFile(manifestPath, entry)
   }

package/core/domain/task-stack.ts

@@ -3,23 +3,22 @@
  * Manages task breakdown and hierarchical task tracking.
  */
 
-import path from 'path'
-import fs from 'fs/promises'
-import { exec } from 'child_process'
-import { promisify } from 'util'
-import log from '../utils/logger'
-import { isNotFoundError } from '../types/fs'
+import { exec } from 'node:child_process'
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import { promisify } from 'node:util'
 import type {
-  TaskStackEntry,
   ParsedNowFile,
+  TaskStackEntry,
   TaskStackMigrationResult,
-  TaskSwitchResult,
   TaskStackSummary,
+  TaskSwitchResult,
 } from '../types'
+import { isNotFoundError } from '../types/fs'
+import log from '../utils/logger'
 
 const execAsync = promisify(exec)
 
-
 // =============================================================================
 // Parser
 // =============================================================================
@@ -129,7 +128,7 @@ export async function ensureStackFile(stackPath: string): Promise<void> {
  */
 export async function appendToStack(stackPath: string, entry: TaskStackEntry): Promise<void> {
   await ensureStackFile(stackPath)
-  const line = JSON.stringify(entry) + '\n'
+  const line = `${JSON.stringify(entry)}\n`
   await fs.appendFile(stackPath, line)
 }
 
@@ -162,14 +161,18 @@ export async function readStack(stackPath: string): Promise<TaskStackEntry[]> {
  * Write full stack to file
  */
 export async function writeStack(stackPath: string, stack: TaskStackEntry[]): Promise<void> {
-  const content = stack.map((task) => JSON.stringify(task)).join('\n') + '\n'
+  const content = `${stack.map((task) => JSON.stringify(task)).join('\n')}\n`
   await fs.writeFile(stackPath, content)
 }
 
 /**
  * Generate now.md content for a task
  */
-export function generateNowContent(task: TaskStackEntry | null, customContent: string | null, formatDurationFn: (ms: number) => string): string {
+export function generateNowContent(
+  task: TaskStackEntry | null,
+  customContent: string | null,
+  formatDurationFn: (ms: number) => string
+): string {
   if (customContent !== undefined && customContent !== null) {
     return customContent
   }
@@ -340,7 +343,11 @@ export class TaskStack {
   /**
    * Start a new task
    */
-  async startTask(description: string, agent: string = 'general', complexity: string = 'moderate'): Promise<TaskStackEntry> {
+  async startTask(
+    description: string,
+    agent: string = 'general',
+    complexity: string = 'moderate'
+  ): Promise<TaskStackEntry> {
     // Check if there's already an active task
     const active = await this.getActiveTask()
     if (active) {
@@ -524,7 +531,10 @@ export class TaskStack {
   /**
    * Update now.md to reflect current state
    */
-  async updateNowFile(task: TaskStackEntry | null, customContent: string | null = null): Promise<void> {
+  async updateNowFile(
+    task: TaskStackEntry | null,
+    customContent: string | null = null
+  ): Promise<void> {
     await updateNowFile(this.nowPath, task, customContent, formatDuration)
   }
 

package/core/errors.ts

@@ -13,7 +13,7 @@
  * @version 2.0.0
  */
 
-import { z, type ZodType } from 'zod'
+import { type ZodType, z } from 'zod'
 
 // =============================================================================
 // Named Error Pattern (Zod-based)

package/core/events/events.ts

@@ -6,10 +6,9 @@
  */
 
 import pathManager from '../infrastructure/path-manager'
-import * as fileHelper from '../utils/file-helper'
+import type { SyncEvent, SyncEventType } from '../types'
 import { getTimestamp } from '../utils/date-helper'
-
-import type { SyncEventType, SyncEvent } from '../types'
+import * as fileHelper from '../utils/file-helper'
 
 /**
  * Infer event type from path and action
@@ -84,4 +83,3 @@ class EventBus {
 
 export const eventBus = new EventBus()
 export default eventBus
-

package/core/events/index.ts

@@ -4,6 +4,5 @@
  * Barrel export for events module
  */
 
-export { eventBus, inferEventType } from './events'
-export { default } from './events'
 export type { SyncEvent, SyncEventType } from '../types'
+export { default, eventBus, inferEventType } from './events'