Method clear

src/node/services/devToolsService.ts:345–370

(workspaceId: string)

  }

  async clear(workspaceId: string): Promise<void> {
    assert(workspaceId.trim().length > 0, "DevToolsService.clear requires a workspaceId");

    // Wait for any in-flight load to finish before clearing, otherwise the
    // pending loadFromDisk can repopulate stale data after the clear.
    const pendingLoad = this.loadingPromises.get(workspaceId);
    if (pendingLoad) {
      await pendingLoad;
    }

    const data = this.getOrCreateWorkspaceData(workspaceId);
    data.runs.clear();
    data.steps.clear();
    data.clearGeneration += 1;
    data.loaded = true;
    this.pendingRunMetadata.delete(workspaceId);

    // Enqueue truncation so clear() cannot race with pending appends.
    await this.enqueueWrite(workspaceId, async () => {
      const filePath = this.getSessionFilePath(workspaceId);
      await fs.mkdir(path.dirname(filePath), { recursive: true });
      await fs.writeFile(filePath, "", "utf-8");
    });

    this.emitWorkspaceEvent(workspaceId, { type: "cleared" });
  }

  private emitWorkspaceEvent(workspaceId: string, event: DevToolsEvent): void {
    this.emit(`update:${workspaceId}`, event);