npm install -g @ez-corp/ez-search

ez-search index .

ez-search query "authentication logic"

ez-search index .

ez-search index . --type code

ez-search index . --clear -q

ez-search query "authentication logic"

ez-search query "error handling" --type code -k 5 --dir src

ez-search query "database connection" --threshold 0.7

ez-search status

ez-search status --format text

import { index } from '@ez-corp/ez-search';

const stats = await index('/path/to/project');
console.log(`Indexed ${stats.filesIndexed} files in ${stats.durationMs}ms`);

const stats = await index('.', { type: 'code', clear: true });

import { query } from '@ez-corp/ez-search';

const results = await query('authentication logic', {
  projectDir: '/path/to/project',
  topK: 5,
});

for (const match of results.code) {
  console.log(`${match.file}:${match.lines.start}-${match.lines.end} (score: ${match.score})`);
}

const results = await query('database connection', {
  threshold: 0.7,
  type: 'code',
});

import { status } from '@ez-corp/ez-search';

const info = await status({ projectDir: '/path/to/project' });
console.log(`${info.fileCount} files, ${info.chunkCount} chunks`);
console.log(`Last indexed: ${info.lastIndexed}`);

if (info.staleFileCount > 0) {
  console.warn(`${info.staleFileCount} files have changed since last index`);
}

interface IndexStats {
  status: string;
  path: string;
  filesScanned: number;
  filesIndexed: number;
  filesSkipped: number;
  chunksCreated: number;
  chunksReused: number;
  chunksRemoved: number;
  durationMs: number;
  storageDir: string;
}

interface IndexOptions {
  ignore?: boolean;
  type?: 'code' | 'text' | 'image';
  clear?: boolean;
}

interface QueryResult {
  query: string;
  totalIndexed: number;
  searchScope: string;
  indexing?: { status: string; filesIndexed: number; durationMs: number };
  stale?: boolean;
  staleFileCount?: number;
  code: CodeQueryResult[];
  text: TextQueryResult[];
  image: ImageQueryResult[];
}

interface CodeQueryResult {
  file: string;
  lines: { start: number; end: number };
  score: number;
  text: string;
}

interface TextQueryResult {
  file: string;
  score: number;
  text: string;
}

interface ImageQueryResult {
  file: string;
  score: number;
}

interface QueryOptions {
  projectDir?: string;
  topK?: number;
  dir?: string;
  threshold?: number;
  type?: 'code' | 'text' | 'image';
  autoIndex?: boolean;
}

interface StatusResult {
  fileCount: number;
  chunkCount: number;
  lastIndexed: string;
  modelTypes: string[];
  indexSizeBytes: number;
  storagePath: string;
  staleFileCount: number;
  byType: Record<'code' | 'text' | 'image', TypeBreakdown>;
  warning?: string;
  suggestion?: string;
}

interface TypeBreakdown {
  files: number;
  chunks: number;
}

interface StatusOptions {
  projectDir?: string;
  ignore?: boolean;
}

class EzSearchError extends Error {
  readonly code: ErrorCode;
  readonly suggestion: string;

  constructor(code: ErrorCode, message: string, suggestion: string);
}

type ErrorCode =
  | 'NO_INDEX'
  | 'EMPTY_DIR'
  | 'UNSUPPORTED_TYPE'
  | 'CORRUPT_MANIFEST'
  | 'GENERAL_ERROR';

type FileType = 'code' | 'text' | 'image';