Method initialize

src/core/search.ts:139–171

()

  }

  async initialize(): Promise<void> {
    if (this.initialized) return;

    try {
      // Fail closed on version mismatch/corruption before serving any results.
      this.indexMeta = await readIndexMeta(this.rootPath);
      await validateIndexArtifacts(this.rootPath, this.indexMeta);

      await this.loadKeywordIndex();
      await this.loadPatternIntelligence();

      // Use the embedding config the index was built with, not the current env-var defaults.
      // This ensures query vectors are in the same space as stored vectors.
      // Legacy indexes (no embeddingProvider stored) fall back to env-var defaults.
      const storedProvider = this.indexMeta.artifacts.vectorDb.embeddingProvider;
      const storedModel = this.indexMeta.artifacts.vectorDb.embeddingModel;
      const embeddingConfig: Partial<EmbeddingConfig> = storedProvider
        ? { provider: storedProvider as EmbeddingConfig['provider'], model: storedModel }
        : {};
      this.embeddingProvider = await getEmbeddingProvider(embeddingConfig);
      this.storageProvider = await getStorageProvider({
        path: this.storagePath
      });

      this.initialized = true;
    } catch (error) {
      if (error instanceof IndexCorruptedError) {
        throw error; // Propagate to handler for auto-heal
      }
      console.warn('Partial initialization (keyword search only):', error);
      this.initialized = true;
    }
  }

  private async loadKeywordIndex(): Promise<void> {
    try {