Method getFileCompletions

src/node/services/workspaceService.ts:8470–8529

(
    workspaceId: string,
    query: string,
    limit = 20
  )

  }

  async getFileCompletions(
    workspaceId: string,
    query: string,
    limit = 20
  ): Promise<{ paths: string[] }> {
    assert(workspaceId, "workspaceId is required");
    assert(typeof query === "string", "query must be a string");

    const resolvedLimit = Math.min(Math.max(1, Math.trunc(limit)), 50);

    const metadata = await this.getInfo(workspaceId);
    if (!metadata) {
      return { paths: [] };
    }

    const now = Date.now();
    const CACHE_TTL_MS = 10_000;

    let cached = this.fileCompletionsCache.get(workspaceId);
    if (!cached) {
      cached = { index: EMPTY_FILE_COMPLETIONS_INDEX, fetchedAt: 0 };
      this.fileCompletionsCache.set(workspaceId, cached);
    }

    const cacheEntry = cached;

    const isStale = cacheEntry.fetchedAt === 0 || now - cacheEntry.fetchedAt > CACHE_TTL_MS;
    if (isStale && !cacheEntry.refreshing) {
      cacheEntry.refreshing = (async () => {
        const previousIndex = cacheEntry.index;

        try {
          const workspace = this.config.findWorkspace(workspaceId);
          const files = await this.listWorkspacePathsForFileCompletions(
            metadata,
            workspace?.workspacePath
          );
          cacheEntry.index = files === null ? previousIndex : buildFileCompletionsIndex(files);
          cacheEntry.fetchedAt = Date.now();
        } catch (error) {
          log.debug("getFileCompletions: failed to list files", {
            workspaceId,
            error: getErrorMessage(error),
          });

          // Keep any previously indexed data, but avoid retrying in a tight loop.
          cacheEntry.index = previousIndex;
          cacheEntry.fetchedAt = Date.now();
        }
      })().finally(() => {
        cacheEntry.refreshing = undefined;
      });
    }

    if (cacheEntry.fetchedAt === 0 && cacheEntry.refreshing) {
      await cacheEntry.refreshing;
    }