raggrep 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 RAGgrep Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,15 @@
+# raggrep
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run index.ts
+```
+
+This project was created using `bun init` in bun v1.3.0. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

package/dist/application/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Application Layer
+ *
+ * Contains use cases that orchestrate the application's business logic.
+ * Use cases depend on domain entities and infrastructure ports (not concrete implementations).
+ */
+export * from './usecases';

package/dist/application/usecases/cleanupIndex.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Cleanup Index Use Case
+ *
+ * Removes stale index entries for files that no longer exist.
+ */
+import type { Config, ModuleManifest } from '../../domain/entities';
+import type { FileSystem } from '../../domain/ports';
+import type { IndexModule } from '../../types';
+/**
+ * Result of cleanup for a single module
+ */
+export interface CleanupResult {
+    moduleId: string;
+    /** Number of stale entries removed */
+    removed: number;
+    /** Number of valid entries kept */
+    kept: number;
+}
+/**
+ * Options for the cleanup use case
+ */
+export interface CleanupIndexOptions {
+    /** Show verbose output */
+    verbose?: boolean;
+    /** Callback for progress updates */
+    onProgress?: (message: string) => void;
+}
+/**
+ * Dependencies required by this use case
+ */
+export interface CleanupIndexDependencies {
+    /** Filesystem abstraction */
+    fileSystem: FileSystem;
+    /** Load configuration */
+    loadConfig: (rootDir: string) => Promise<Config>;
+    /** Get enabled modules */
+    getEnabledModules: (config: Config) => IndexModule[];
+    /** Load module manifest */
+    loadModuleManifest: (rootDir: string, moduleId: string, config: Config) => Promise<ModuleManifest | null>;
+    /** Save module manifest */
+    saveModuleManifest: (rootDir: string, moduleId: string, manifest: ModuleManifest, config: Config) => Promise<void>;
+    /** Delete file index */
+    deleteFileIndex: (rootDir: string, moduleId: string, filepath: string, config: Config) => Promise<void>;
+}
+/**
+ * Clean up stale index entries.
+ *
+ * This use case:
+ * 1. Loads configuration
+ * 2. For each module, checks if indexed files still exist
+ * 3. Removes index entries for deleted files
+ * 4. Updates manifests
+ */
+export declare function cleanupIndex(rootDir: string, deps: CleanupIndexDependencies, options?: CleanupIndexOptions): Promise<CleanupResult[]>;

package/dist/application/usecases/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Application Use Cases
+ *
+ * Business logic orchestration layer.
+ * Use cases coordinate domain entities and infrastructure services.
+ */
+export { indexDirectory, type IndexResult, type IndexDirectoryOptions, type IndexDirectoryDependencies } from './indexDirectory';
+export { searchIndex, formatSearchResults, type SearchIndexOptions, type SearchIndexDependencies } from './searchIndex';
+export { cleanupIndex, type CleanupResult, type CleanupIndexOptions, type CleanupIndexDependencies } from './cleanupIndex';

package/dist/application/usecases/indexDirectory.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Index Directory Use Case
+ *
+ * Orchestrates the indexing of a codebase directory.
+ * This is an application-level use case that coordinates domain entities
+ * and infrastructure services.
+ */
+import type { Config } from '../../domain/entities';
+import type { FileSystem } from '../../domain/ports';
+import type { IndexModule } from '../../types';
+/**
+ * Result of indexing with a single module
+ */
+export interface IndexResult {
+    moduleId: string;
+    indexed: number;
+    skipped: number;
+    errors: number;
+}
+/**
+ * Options for the index directory use case
+ */
+export interface IndexDirectoryOptions {
+    /** Override configuration */
+    config?: Partial<Config>;
+    /** Show verbose output */
+    verbose?: boolean;
+    /** Callback for progress updates */
+    onProgress?: (message: string) => void;
+}
+/**
+ * Dependencies required by this use case
+ */
+export interface IndexDirectoryDependencies {
+    /** Filesystem abstraction */
+    fileSystem: FileSystem;
+    /** Load configuration */
+    loadConfig: (rootDir: string) => Promise<Config>;
+    /** Get enabled modules */
+    getEnabledModules: (config: Config) => IndexModule[];
+    /** Initialize a module */
+    initializeModule: (module: IndexModule, config: Config) => Promise<void>;
+}
+/**
+ * Index a directory using all enabled modules.
+ *
+ * This use case:
+ * 1. Loads configuration
+ * 2. Finds all files matching extensions
+ * 3. Indexes files with each enabled module
+ * 4. Builds secondary indexes (Tier 1)
+ * 5. Updates manifests
+ */
+export declare function indexDirectory(rootDir: string, deps: IndexDirectoryDependencies, options?: IndexDirectoryOptions): Promise<IndexResult[]>;

package/dist/application/usecases/searchIndex.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Search Index Use Case
+ *
+ * Orchestrates searching the indexed codebase.
+ */
+import type { Config, SearchResult, SearchOptions } from '../../domain/entities';
+import type { FileSystem } from '../../domain/ports';
+import type { IndexModule, FileIndex } from '../../types';
+/**
+ * Options for the search use case
+ */
+export interface SearchIndexOptions extends SearchOptions {
+    /** Callback for progress updates */
+    onProgress?: (message: string) => void;
+}
+/**
+ * Dependencies required by this use case
+ */
+export interface SearchIndexDependencies {
+    /** Filesystem abstraction */
+    fileSystem: FileSystem;
+    /** Load configuration */
+    loadConfig: (rootDir: string) => Promise<Config>;
+    /** Get indexed modules from global manifest */
+    getIndexedModules: (rootDir: string, config: Config) => Promise<string[]>;
+    /** Get module by ID */
+    getModule: (moduleId: string) => IndexModule | undefined;
+    /** Initialize a module */
+    initializeModule: (module: IndexModule, config: Config) => Promise<void>;
+    /** Load file index */
+    loadFileIndex: (rootDir: string, moduleId: string, filepath: string, config: Config) => Promise<FileIndex | null>;
+    /** List indexed files for a module */
+    listIndexedFiles: (rootDir: string, moduleId: string, config: Config) => Promise<string[]>;
+}
+/**
+ * Search the indexed codebase.
+ *
+ * This use case:
+ * 1. Loads configuration
+ * 2. Finds modules that have indexes
+ * 3. Searches each module
+ * 4. Aggregates and ranks results
+ */
+export declare function searchIndex(rootDir: string, query: string, deps: SearchIndexDependencies, options?: SearchIndexOptions): Promise<SearchResult[]>;
+/**
+ * Format search results for display
+ */
+export declare function formatSearchResults(results: SearchResult[]): string;

package/dist/cli/main.d.ts

@@ -0,0 +1 @@
+export {};