@compass-ai/nova 1.0.74 → 1.0.76

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

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

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