Method getWorkspaceStatus

src/node/services/coderService.ts:1143–1189

* Get workspace status using control-plane query. * * Note: `coder list --search 'name:X'` is prefix-based on the server, * so we must exact-match the workspace name client-side.

(
    workspaceName: string,
    options?: { timeoutMs?: number; signal?: AbortSignal }
  )

   * so we must exact-match the workspace name client-side.
   */
  async getWorkspaceStatus(
    workspaceName: string,
    options?: { timeoutMs?: number; signal?: AbortSignal }
  ): Promise<WorkspaceStatusResult> {
    const timeoutMs = options?.timeoutMs ?? 10_000;

    try {
      const result = await this.runCoderCommand(
        ["list", "--search", `name:${workspaceName}`, "--output", "json"],
        { timeoutMs, signal: options?.signal }
      );

      const interpreted = interpretCoderResult(result);
      if (!interpreted.ok) {
        return { kind: "error", error: interpreted.error };
      }

      if (!interpreted.stdout.trim()) {
        return { kind: "not_found" };
      }

      const workspaces = JSON.parse(interpreted.stdout) as Array<{
        name: string;
        latest_build: { status: string };
      }>;

      // Exact match required (search is prefix-based)
      const match = workspaces.find((w) => w.name === workspaceName);
      if (!match) {
        return { kind: "not_found" };
      }

      // Validate status against known schema values
      const status = match.latest_build.status;
      const parsed = CoderWorkspaceStatusSchema.safeParse(status);
      if (!parsed.success) {
        log.warn("Unknown Coder workspace status", { workspaceName, status });
        return { kind: "error", error: `Unknown status: ${status}` };
      }

      return { kind: "ok", status: parsed.data };
    } catch (error) {
      const message = getErrorMessage(error);
      log.debug("Failed to get Coder workspace status", { workspaceName, error: message });
      return { kind: "error", error: message };
    }
  }

  /**
   * Start a Coder workspace.