Method triggerRun

src/lib/http.ts:234–248

* POST /api/cli/v1/tests/{testId}/runs * Trigger a run and return the queued-run envelope. * The caller must supply an `idempotencyKey` which is sent as the * `Idempotency-Key` header per M3.2 piece-1 §2 contract.

(
    testId: string,
    body: TriggerRunBody,
    options: { idempotencyKey: string; signal?: AbortSignal },
  )

   * `Idempotency-Key` header per M3.2 piece-1 §2 contract.
   */
  async triggerRun(
    testId: string,
    body: TriggerRunBody,
    options: { idempotencyKey: string; signal?: AbortSignal },
  ): Promise<TriggerRunResponse> {
    return this.postWithMeta<TriggerRunResponse>(`/tests/${encodeURIComponent(testId)}/runs`, {
      body,
      headers: { 'idempotency-key': options.idempotencyKey },
      signal: options.signal,
      // 409 on POST /runs means "another run is already in flight" — a
      // persistent condition, not a transient snapshot conflict. Retrying
      // would enqueue a second run once the first finishes.
      retryOnConflict: false,
    }).then(r => r.body);
  }

  /**
   * Like `triggerRun` but returns the full `RequestResult` so the caller