Method createStep

src/node/services/devToolsService.ts:208–243

(workspaceId: string, step: DevToolsStep)

  }

  async createStep(workspaceId: string, step: DevToolsStep): Promise<void> {
    if (!this.enabled) {
      return;
    }

    assert(workspaceId.trim().length > 0, "DevToolsService.createStep requires a workspaceId");
    assert(step.runId.trim().length > 0, "DevToolsService.createStep requires step.runId");

    await this.ensureLoaded(workspaceId);
    const data = this.getOrCreateWorkspaceData(workspaceId);

    // Self-healing: if the run was cleared during an active stream,
    // recreate it so steps aren't orphaned.
    if (!data.runs.has(step.runId)) {
      const autoRun: DevToolsRun = {
        id: step.runId,
        workspaceId,
        startedAt: step.startedAt,
      };
      data.runs.set(autoRun.id, autoRun);
      await this.appendToFile(workspaceId, { type: "run", run: autoRun });
      this.emitWorkspaceEvent(workspaceId, {
        type: "run-created",
        run: this.buildRunSummary(data, autoRun.id),
      });
    }

    data.steps.set(step.id, step);
    await this.appendToFile(workspaceId, { type: "step", step });

    this.emitWorkspaceEvent(workspaceId, { type: "step-created", step });
    if (data.runs.has(step.runId)) {
      const summary = this.buildRunSummary(data, step.runId);
      this.emitWorkspaceEvent(workspaceId, { type: "run-updated", run: summary });
    }
  }

  async updateStep(
    workspaceId: string,