Search locally without model downloads and follow imports

[PatrickSys]

New repositories search locally without downloading embedding models; existing indexes keep their successful mode.
Search preserves current source context and follows directed imports and re-exports up to three hops.
Setup detects supported coding tools, configures them together, and saves a pinned launch for the selected repository.
The guides explain how to reindex through the CBC installation that owns the optional runtimes.
Tested: 74 focused setup, CLI, entrypoint and release checks pass, along with type checks, build and scoped lint.
Model-free search can miss loosely phrased concepts; import relationships describe source navigation.
Multi-tool setup still needs native Cursor and OpenCode verification and is awaiting publication.
One full-suite test still expects the removed setup preview; this remains a draft.

[PatrickSys]

Every get_symbol_references call now reads and Tree-sitter-parses every indexed file: the chunk prefilter is gone, and findIdentifierOccurrences parses without a cheap text check first. Testing the word on the current file text before parsing would keep current-source truth without the full scan.

• codebase-context/src/core/symbol-references.ts

  Lines 123 to 145 in 129ad6b

  	const candidateFiles = new Map<string, string>();
  	for (const chunkRaw of chunks) {
  	const chunk = chunkRaw as IndexedChunk;
  	const absPath = resolveAbsoluteChunkPath(rootPath, chunk);
  	if (!absPath) {
  	return {
  	status: 'error',
  	message:
  	'Indexed source location is invalid. Refresh the index before trusting reference results.'
  	};
  	}
  	const relPath = path.relative(rootPath, absPath).replace(/\\/g, '/');
  	candidateFiles.set(relPath, absPath);
  	}
  	let realRootPath: string;
  	try {
  	realRootPath = await fs.realpath(rootPath);
  	} catch {
  	return { status: 'error', message: 'Selected project path is missing or unreadable.' };
  	}
  	for (const [relativePath, absolutePath] of candidateFiles) {

• codebase-context/src/core/symbol-references.ts

  Line 173 in 129ad6b

  const occurrences = await findIdentifierOccurrences(

• codebase-context/src/utils/tree-sitter.ts

  Line 455 in 129ad6b

  tree = parser.parse(content);

[PatrickSys]

If any of the ~30 search candidates was edited after indexing (before the watcher catches up, or from the CLI), search throws IndexCorruptedError, starts a full re-index and returns status: indexing, while get_code_relationships keeps answering and just marks drifted edges stale. Dropping or flagging the drifted candidate would keep search working.

• codebase-context/src/core/search.ts

  Lines 230 to 266 in 129ad6b

  	private async validateCandidateSources(
  	chunks: Iterable<CodeChunk>,
  	checkedSources: Map<string, string>
  	): Promise<void> {
  	if (!this.sourceManifest) {
  	throw new IndexCorruptedError('Source manifest is unavailable. Full rebuild required.');
  	}
  	let realRootPath: string | undefined;
  	for (const chunk of chunks) {
  	const sourcePath = this.getIndexedSourcePath(chunk);
  	const sourceKey = path.resolve(this.rootPath, chunk.filePath);
  	if (checkedSources.has(sourceKey)) continue;
  	const relativePath = path.relative(this.rootPath, sourcePath).replace(/\\/g, '/');
  	const expectedHash = this.sourceManifest.files[relativePath];
  	if (typeof expectedHash !== 'string') {
  	throw new IndexCorruptedError(
  	'Indexed source is absent from its manifest. Full rebuild required.'
  	);
  	}
  	try {
  	realRootPath ??= await fs.realpath(this.rootPath);
  	const realSourcePath = await fs.realpath(sourcePath);
  	if (!isPathWithin(realRootPath, realSourcePath)) {
  	throw new Error('Source resolves outside the selected project');
  	}
  	if (!(await fs.stat(realSourcePath)).isFile()) {
  	throw new Error('Source is not a regular file');
  	}
  	const content = await fs.readFile(realSourcePath, 'utf-8');
  	if (hashFileContent(content) !== expectedHash) throw new Error('Source content changed');
  	checkedSources.set(sourceKey, content);
  	} catch {
  	throw new IndexCorruptedError(
  	`Indexed source is changed or unreadable (${relativePath}). Full rebuild required.`
  	);
  	}
  	}

• codebase-context/src/core/search.ts

  Line 1035 in 129ad6b

  await this.validateCandidateSources(

• codebase-context/src/tools/search-codebase.ts

  Lines 225 to 227 in 129ad6b

  	if (error instanceof IndexCorruptedError) {
  	console.error('[Auto-Heal] Index corrupted. Triggering background re-index...');
  	void ctx.performIndexing();

• codebase-context/src/tools/get-code-relationships.ts

  Line 26 in 129ad6b

  const collectionKeys = ['paths', 'unresolved', 'staleEdges', 'staleUnresolvedEdges'];