@compass-ai/nova 1.0.73 → 1.0.74

package/dist/core/context-builder.d.ts

@@ -0,0 +1,264 @@
+/**
+ * Context building logic for assembling relevant codebase context for LLM queries.
+ * This module is responsible for gathering and organizing project files, code snippets,
+ * and metadata to provide Claude with the necessary context for development tasks.
+ */
+import { DEFAULT_IGNORE_PATTERNS } from '../utils/ignore-patterns.js';
+/**
+ * Represents a file with its content and metadata for context building
+ */
+export interface ContextFile {
+    path: string;
+    relativePath: string;
+    content: string;
+    tokenCount: number;
+    size: number;
+    lastModified: Date;
+    language: string;
+}
+/**
+ * Represents the assembled context ready for LLM consumption
+ */
+export interface AssembledContext {
+    files: ContextFile[];
+    totalTokens: number;
+    summary: string;
+    projectRoot: string;
+    timestamp: string;
+}
+/**
+ * Options for context building
+ */
+export interface ContextBuilderOptions {
+    maxTokens?: number;
+    maxFiles?: number;
+    includePatterns?: string[];
+    excludePatterns?: string[];
+    priorityFiles?: string[];
+    projectRoot?: string;
+}
+/**
+ * Detected project type based on marker files
+ */
+export type ProjectType = 'nodejs' | 'typescript' | 'python' | 'go' | 'rust' | 'java' | 'csharp' | 'ruby' | 'php' | 'unknown';
+/**
+ * Marker files used to detect project type
+ */
+declare const PROJECT_MARKERS: Record<ProjectType, string[]>;
+/**
+ * Summary of project configuration files
+ */
+export interface ConfigSummary {
+    /** Package name (from package.json, Cargo.toml, etc.) */
+    name?: string;
+    /** Package description */
+    description?: string;
+    /** Package version */
+    version?: string;
+    /** Available scripts/commands */
+    scripts?: Record<string, string>;
+    /** Dependency names (not versions, to save tokens) */
+    dependencies?: string[];
+    /** Dev dependency names */
+    devDependencies?: string[];
+    /** Main entry point */
+    main?: string;
+    /** Raw config for other project types */
+    raw?: Record<string, unknown>;
+}
+/**
+ * Lightweight project summary for system prompts
+ */
+export interface ProjectSummary {
+    /** Detected project type */
+    projectType: ProjectType;
+    /** Project name */
+    name: string;
+    /** Project root directory */
+    projectRoot: string;
+    /** Directory tree in markdown format */
+    directoryTree: string;
+    /** Compact directory tree (shallow depth + summaries) for classifier prompts */
+    compactDirectoryTree: string;
+    /** Configuration summary */
+    config: ConfigSummary;
+    /** Primary language(s) detected */
+    languages: string[];
+    /** Total file count */
+    fileCount: number;
+    /** Formatted string ready for system prompt injection */
+    formatted: string;
+}
+/**
+ * Language detection mapping based on file extensions
+ */
+declare const EXTENSION_TO_LANGUAGE: Record<string, string>;
+/**
+ * ContextBuilder class for assembling relevant codebase context for LLM queries.
+ * Handles file discovery, content loading, token estimation, and context optimization.
+ */
+declare class ContextBuilder {
+    private projectRoot;
+    private maxTokens;
+    private maxFiles;
+    private includePatterns;
+    private excludePatterns;
+    private priorityFiles;
+    private fileCache;
+    constructor(options?: ContextBuilderOptions);
+    /**
+     * Sets the project root directory
+     */
+    setProjectRoot(projectRoot: string): void;
+    /**
+     * Sets the maximum token limit for context
+     */
+    setMaxTokens(maxTokens: number): void;
+    /**
+     * Sets the maximum number of files to include
+     */
+    setMaxFiles(maxFiles: number): void;
+    /**
+     * Adds files to the priority list
+     */
+    addPriorityFiles(files: string[]): void;
+    /**
+     * Clears the file cache
+     */
+    clearCache(): void;
+    /**
+     * Gets the effective exclude patterns including session exclusions.
+     * If custom excludePatterns were provided in constructor options, uses those.
+     * Otherwise loads patterns from .gitignore files (including nested ones).
+     */
+    private getEffectiveExcludePatterns;
+    /**
+     * Discovers all relevant files in the project
+     */
+    discoverFiles(): Promise<string[]>;
+    /**
+     * Loads a file and creates a ContextFile object
+     */
+    loadFile(relativePath: string): Promise<ContextFile | null>;
+    /**
+     * Loads multiple files in parallel
+     */
+    loadFiles(relativePaths: string[]): Promise<ContextFile[]>;
+    /**
+     * Builds context from specified files
+     */
+    buildContext(files?: string[]): Promise<AssembledContext>;
+    /**
+     * Builds context for specific file patterns
+     */
+    buildContextForPatterns(patterns: string[]): Promise<AssembledContext>;
+    /**
+     * Builds context including specific files with priority
+     */
+    buildContextWithPriority(priorityFiles: string[], additionalFiles?: string[]): Promise<AssembledContext>;
+    /**
+     * Formats context for LLM consumption
+     */
+    formatContextForLLM(context: AssembledContext): string;
+    /**
+     * Formats context as a compact summary
+     */
+    formatContextSummary(context: AssembledContext): string;
+    /**
+     * Gets context usage statistics
+     */
+    getContextStats(context: AssembledContext, contextWindow: number): {
+        usedTokens: number;
+        remainingTokens: number;
+        usagePercent: number;
+        fileCount: number;
+    };
+    /**
+     * Detects the programming language based on file extension
+     */
+    private detectLanguage;
+    /**
+     * Checks if a file is likely a text file based on extension
+     */
+    private isTextFile;
+    /**
+     * Sorts files by priority for context inclusion
+     */
+    private sortFilesByPriority;
+    /**
+     * Calculates priority score for a file
+     */
+    private calculateFilePriority;
+    /**
+     * Selects files that fit within the token budget
+     */
+    private selectFilesWithinBudget;
+    /**
+     * Generates a summary of the context
+     */
+    private generateContextSummary;
+    /**
+     * Detects the project type based on marker files present in the project root
+     */
+    detectProjectType(): Promise<ProjectType>;
+    /**
+     * Generates a directory tree in markdown format
+     * @param maxDepth - Maximum depth to traverse (default: 6)
+     * @param maxItems - Maximum items per directory to show (default: 20)
+     */
+    getDirectoryTree(maxDepth?: number, maxItems?: number): Promise<string>;
+    /**
+     * Generates a compact directory tree for classifier/routing prompts.
+     * Uses shallow traversal and emits summary lines at the depth boundary
+     * instead of enumerating every file.
+     * @param maxDepth - Maximum depth to traverse (default: 3)
+     * @param maxItems - Maximum items per directory to show (default: 15)
+     */
+    getCompactDirectoryTree(maxDepth?: number, maxItems?: number): Promise<string>;
+    /**
+     * Recursively builds a compact directory tree.
+     * At the depth boundary, directories are summarized with file/subdir counts
+     * instead of being traversed further.
+     */
+    private buildCompactTreeRecursive;
+    /**
+     * Summarizes a directory by counting subdirectories and files recursively.
+     * Returns a string like "(8 subdirs, 42 files)".
+     */
+    private summarizeDirectory;
+    /**
+     * Recursively builds the directory tree
+     */
+    private buildTreeRecursive;
+    /**
+     * Extracts a summary of project configuration files (package.json, etc.)
+     * Returns only essential fields to minimize token usage
+     */
+    getConfigSummary(): Promise<ConfigSummary>;
+    /**
+     * Gets a complete lightweight project summary suitable for system prompt injection
+     */
+    getProjectSummary(): Promise<ProjectSummary>;
+    /**
+     * Formats the project summary as a string suitable for system prompt injection
+     */
+    private formatProjectSummaryForPrompt;
+}
+/**
+ * Gets the singleton ContextBuilder instance.
+ * Creates the instance on first call with default options.
+ *
+ * @param options - Optional configuration options
+ * @returns The ContextBuilder instance
+ */
+export declare function getContextBuilder(options?: ContextBuilderOptions): ContextBuilder;
+/**
+ * Creates a new ContextBuilder instance with the specified options.
+ * Use this when you need a separate instance from the singleton.
+ *
+ * @param options - Configuration options
+ * @returns A new ContextBuilder instance
+ */
+export declare function createContextBuilder(options?: ContextBuilderOptions): ContextBuilder;
+export { ContextBuilder, DEFAULT_IGNORE_PATTERNS, EXTENSION_TO_LANGUAGE, PROJECT_MARKERS, };
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/core/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../src/core/context-builder.ts"],"names":[],"mappings":"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"}