@genn-inc/cluebase-cli 0.0.1

package/src/setup-doctor-probe.mjs

@@ -0,0 +1,719 @@
+// setup-doctor ingest probe + payload builders.
+// Extracted from setup-doctor for file-size limits; content is unchanged.
+
+import {
+  CLUEBASE_TEST_SETUP_SDK_VERSION,
+  FRONTEND_SOURCE_IDENTIFIER,
+  BATCH_VISIBILITY_POLL_INTERVAL_MS,
+  optionalString,
+  trimTrailingSlash,
+  joinUrl,
+  batchStatusPathFor,
+  manifestDetectedServices,
+} from "./setup-doctor-env.mjs";
+
+export const firstTargetBackendTargetId = (manifest) => {
+  for (const target of manifestDetectedServices(manifest, "backend")) {
+    const targetId = optionalString(target.target_id);
+    if (targetId) return targetId;
+  }
+  return null;
+};
+
+export const readTextResponse = async (response) => {
+  try {
+    return await response.text();
+  } catch {
+    return "";
+  }
+};
+
+export const parseJsonText = (text) => {
+  try {
+    return text.trim() ? JSON.parse(text) : null;
+  } catch {
+    return null;
+  }
+};
+
+export const postJson = async ({ body, fetchImpl, headers = {}, url }) => {
+  try {
+    const response = await fetchImpl(url, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        ...headers,
+      },
+      body: JSON.stringify(body),
+    });
+    const text = await readTextResponse(response);
+    return {
+      transportOk: true,
+      response,
+      text,
+      json: parseJsonText(text),
+    };
+  } catch (error) {
+    return {
+      transportOk: false,
+      error: error instanceof Error ? error.message : String(error),
+    };
+  }
+};
+
+export const compactFailure = (result) => {
+  if (!result.transportOk) return result.error ?? "request failed";
+  const jsonMessage =
+    typeof result.json?.message === "string"
+      ? result.json.message
+      : typeof result.json?.error === "string"
+        ? result.json.error
+        : null;
+  return jsonMessage ?? result.text?.slice(0, 240) ?? "request failed";
+};
+
+export const tokenFromResult = (result) =>
+  result.transportOk &&
+  result.response.ok &&
+  typeof result.json?.token === "string" &&
+  result.json.token.trim() &&
+  typeof result.json?.expiresAt === "string" &&
+  result.json.expiresAt.trim()
+    ? result.json.token.trim()
+    : null;
+
+export const observationBatchIdFromResult = (result) => {
+  if (!result.transportOk || !result.response.ok) return null;
+  const json = result.json;
+  return typeof json?.observation_ingest_batch_id === "string" &&
+    json.observation_ingest_batch_id.trim()
+    ? json.observation_ingest_batch_id.trim()
+    : null;
+};
+
+// A 401 whose body says the project key is invalid means the manifest's
+// project_key can no longer be resolved by the Cluebase backend (e.g. the project
+// was re-provisioned and the stored key rotated). This is a self-healing
+// customer state, NOT an endpoint bug — surface the recovery path so the
+// failure is not misdiagnosed as a Cluebase API defect (Round 1 was misdiagnosed
+// this way). The fail verdict is unchanged; this only adds guidance.
+// A batch that is accepted (201) but not yet published within the polling
+// window is often just slow local materialization (worker / pipeline latency),
+// not a genuine failure. Point the user at the timeout override before they
+// assume the pipeline is broken.
+export const BATCH_TIMEOUT_HINT =
+  " ローカルで worker / pipeline の処理に時間がかかる場合は、環境変数 CLUEBASE_SETUP_VERIFICATION_BATCH_TIMEOUT_MS を延長して /cluebase-doctor を再実行してください。";
+
+export const STALE_PROJECT_KEY_REMEDIATION =
+  "`.cluebase/setup-manifest.json` の project_key が Cluebase backend で解決できません (鍵が古い / 再発行された可能性)。setup 画面から現行の project key を再取得して setup をやり直すか、クリーンな状態で /cluebase-discover を実行して manifest を再生成してください。これは endpoint 側のコードではなく、manifest の鍵と Cluebase backend の不一致が原因です。";
+
+export const staleProjectKeyRemediation = (result) => {
+  if (!result?.transportOk || result.response?.status !== 401) return null;
+  const message = (
+    (typeof result.json?.message === "string" && result.json.message) ||
+    (typeof result.json?.error === "string" && result.json.error) ||
+    result.text ||
+    ""
+  ).toLowerCase();
+  return message.includes("invalid project key")
+    ? STALE_PROJECT_KEY_REMEDIATION
+    : null;
+};
+
+export const buildCheck = ({
+  error = null,
+  id,
+  method = "POST",
+  passed,
+  result = null,
+  url,
+}) => {
+  const check = {
+    id,
+    // API 疎通 check は production reach への前提条件 (= 認証 / network) なので
+    // failure 時は ERROR + halt。 quality checks (= setup-doctor-quality.mjs) は
+    // severity を独立に付与する。
+    severity: "error",
+    method,
+    url,
+    passed: Boolean(passed),
+    status: result?.transportOk ? result.response.status : null,
+    error: passed ? null : (error ?? compactFailure(result)),
+  };
+  if (!check.passed) {
+    const remediation = staleProjectKeyRemediation(result);
+    if (remediation) check.remediation_prompt = remediation;
+  }
+  return check;
+};
+
+export const typedEvidenceCountsFrom = (json) => {
+  const value = json?.typed_evidence_counts;
+  if (!value || typeof value !== "object") return null;
+  const count = (key) =>
+    typeof value[key] === "number" && Number.isFinite(value[key])
+      ? value[key]
+      : null;
+  return {
+    typed_observation_count: count("typed_observation_count"),
+    identity_link_count: count("identity_link_count"),
+    backend_operation_count: count("backend_operation_count"),
+    backend_data_operation_count: count("backend_data_operation_count"),
+    backend_decision_count: count("backend_decision_count"),
+    backend_dependency_count: count("backend_dependency_count"),
+  };
+};
+
+export const dataUsabilityFrom = ({ checkId, typedEvidenceCounts }) => {
+  if (!typedEvidenceCounts) {
+    return {
+      available: false,
+      passed: false,
+      reason: "batch-status response does not include typed_evidence_counts",
+    };
+  }
+  const typedObservationCount =
+    typedEvidenceCounts.typed_observation_count ?? 0;
+  if (checkId === "browser_ingest_reached_ledger") {
+    const identityLinkCount = typedEvidenceCounts.identity_link_count ?? 0;
+    return {
+      available: true,
+      passed: typedObservationCount > 0 && identityLinkCount > 0,
+      required_counts: {
+        typed_observation_count: typedObservationCount,
+        identity_link_count: identityLinkCount,
+      },
+    };
+  }
+  if (checkId === "backend_ingest_reached_ledger") {
+    const backendOperationCount =
+      typedEvidenceCounts.backend_operation_count ?? 0;
+    const backendDataOperationCount =
+      typedEvidenceCounts.backend_data_operation_count ?? 0;
+    const backendDecisionCount =
+      typedEvidenceCounts.backend_decision_count ?? 0;
+    const backendDependencyCount =
+      typedEvidenceCounts.backend_dependency_count ?? 0;
+    return {
+      available: true,
+      passed:
+        typedObservationCount > 0 &&
+        backendOperationCount > 0 &&
+        backendDataOperationCount > 0 &&
+        backendDecisionCount > 0 &&
+        backendDependencyCount > 0,
+      required_counts: {
+        typed_observation_count: typedObservationCount,
+        backend_operation_count: backendOperationCount,
+        backend_data_operation_count: backendDataOperationCount,
+        backend_decision_count: backendDecisionCount,
+        backend_dependency_count: backendDependencyCount,
+      },
+    };
+  }
+  return {
+    available: true,
+    passed: typedObservationCount > 0,
+    required_counts: {
+      typed_observation_count: typedObservationCount,
+    },
+  };
+};
+
+export const pollBatchVisibility = async ({
+  apiKey,
+  batchId,
+  checkId,
+  cluebaseApiBaseUrl,
+  fetchImpl,
+  projectKey,
+  timeoutMs,
+}) => {
+  const statusUrl = joinUrl(cluebaseApiBaseUrl, batchStatusPathFor(batchId));
+  const intervalMs = BATCH_VISIBILITY_POLL_INTERVAL_MS;
+  const maxAttempts = Math.max(1, Math.ceil(timeoutMs / intervalMs));
+  let pollResult = null;
+  let observedStatus = "accepted";
+  let observedError = null;
+  let observedStage = "accepted";
+  let published = false;
+  let publishedObservationCount = null;
+  let typedEvidenceCounts = null;
+  let dataUsability = dataUsabilityFrom({
+    checkId,
+    typedEvidenceCounts: null,
+  });
+
+  for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
+    const response = await fetchImpl(statusUrl, {
+      method: "GET",
+      headers: {
+        "x-cluebase-project-key": projectKey,
+        "x-cluebase-api-key": apiKey,
+      },
+    })
+      .then(async (r) => {
+        const text = await r.text();
+        let json = null;
+        try {
+          json = text ? JSON.parse(text) : null;
+        } catch {
+          json = null;
+        }
+        return { response: r, text, json, transportOk: true };
+      })
+      .catch((error) => ({
+        transportOk: false,
+        error: error instanceof Error ? error.message : String(error),
+      }));
+    pollResult = response;
+
+    if (!response.transportOk) break;
+    if (response.response.status === 404) {
+      observedStatus = "accepted";
+      observedStage = "accepted";
+    } else if (response.response.ok) {
+      observedStatus =
+        typeof response.json?.status === "string"
+          ? response.json.status
+          : "unknown";
+      observedError =
+        typeof response.json?.error_message === "string"
+          ? response.json.error_message
+          : null;
+      publishedObservationCount =
+        typeof response.json?.published_observation_count === "number"
+          ? response.json.published_observation_count
+          : null;
+      published =
+        response.json?.published === true &&
+        typeof publishedObservationCount === "number" &&
+        publishedObservationCount > 0;
+      typedEvidenceCounts = typedEvidenceCountsFrom(response.json);
+      dataUsability = dataUsabilityFrom({ checkId, typedEvidenceCounts });
+
+      if (observedStatus === "completed" && published) {
+        observedStage = "published";
+        break;
+      }
+      if (
+        observedStatus === "received" ||
+        observedStatus === "completed" ||
+        observedStatus === "failed"
+      ) {
+        observedStage = observedStatus;
+      } else {
+        observedStage = "accepted";
+      }
+      if (observedStatus === "failed") break;
+    } else {
+      break;
+    }
+
+    if (attempt < maxAttempts - 1) {
+      await (fetchImpl.waitForPollInterval?.(intervalMs) ?? new Promise((resolve) => setTimeout(resolve, intervalMs)));
+    }
+  }
+
+  const publishedPassed = observedStage === "published";
+  const dataUsabilityPassed = dataUsability.passed === true;
+  const passed = publishedPassed && dataUsabilityPassed;
+  const error = passed
+    ? null
+    : publishedPassed
+      ? `batch reached published state but typed data usability failed: ${dataUsability.reason ?? "required typed evidence count is missing"}`
+      : observedStatus === "failed"
+        ? `worker normalize failed: ${observedError ?? "no error message"}`
+        : observedStage === "accepted"
+          ? `batch was accepted but did not reach published state within ${timeoutMs / 1000}s.${BATCH_TIMEOUT_HINT}`
+          : observedStage === "completed"
+            ? "batch completed but was not reported as published"
+            : `batch did not reach published completion within ${timeoutMs / 1000}s (last stage: ${observedStage}).${BATCH_TIMEOUT_HINT}`;
+
+  const remediationPrompt = passed
+    ? null
+    : staleProjectKeyRemediation(pollResult);
+  return {
+    id: checkId,
+    severity: "error",
+    method: "GET",
+    url: statusUrl,
+    passed,
+    status: pollResult?.transportOk ? pollResult.response.status : null,
+    error,
+    ...(remediationPrompt ? { remediation_prompt: remediationPrompt } : {}),
+    observed_batch_id: batchId,
+    observed_status: observedStatus,
+    observed_stage: observedStage,
+    published,
+    published_observation_count: publishedObservationCount,
+    typed_evidence_counts: typedEvidenceCounts,
+    data_usability: dataUsability,
+    timeout_ms: timeoutMs,
+  };
+};
+
+export const hexId = (value, length) => {
+  let hex = "";
+  for (const char of String(value)) {
+    hex += char.charCodeAt(0).toString(16).padStart(2, "0");
+  }
+  return hex.padEnd(length, "0").slice(0, length).toLowerCase();
+};
+
+export const buildSetupCorrelation = () => {
+  const id = `cluebase_test_${Date.now()}`;
+  const traceId = hexId(`${id}_trace`, 32);
+  return {
+    id,
+    anonymous_id: `anon_${id}`,
+    user_id: `user_${id}`,
+    organization_id: `org_${id}`,
+    session_id: `session_${id}`,
+    tab_id: `tab_${id}`,
+    interaction_id: `interaction_${id}`,
+    request_id: `request_${id}`,
+    request_span_id: `request_span_${id}`,
+    trace_id: traceId,
+  };
+};
+
+export const nanosFromNow = (offsetMs = 0) =>
+  (BigInt(Date.now() + offsetMs) * 1_000_000n).toString();
+
+export const sourceSignalEvent = ({
+  attributes,
+  context = {},
+  endMs = 25,
+  events = [],
+  name,
+  parentSpanId = null,
+  resource = {},
+  sourceEventId,
+  spanId,
+  spanKind,
+  startMs = 0,
+  statusCode = 1,
+  surface,
+}) => ({
+  source_event_id: sourceEventId,
+  source_event_type: "sdk_source_signal",
+  source_event_kind: "sdk_source_signal",
+  event_name: "sdk_source_signal_observed",
+  event_category: "context",
+  occurred_at: new Date().toISOString(),
+  sdk_signal: {
+    surface,
+    kind: "span",
+    name,
+    span_kind: spanKind,
+    trace_id: context.trace_id ?? attributes["cluebase.trace_id"] ?? null,
+    span_id: spanId,
+    parent_span_id: parentSpanId,
+    start_time_unix_nano: nanosFromNow(startMs),
+    end_time_unix_nano: nanosFromNow(endMs),
+    status_code: statusCode,
+    status_message: statusCode === 2 ? "ERROR" : null,
+    instrumentation_scope_name:
+      surface === "backend"
+        ? "@cluebase/setup-doctor/backend"
+        : "@cluebase/setup-doctor/frontend",
+    attributes,
+    events,
+    resource,
+    context,
+  },
+});
+
+export const browserSignalContext = (correlation) => ({
+  producer_id: FRONTEND_SOURCE_IDENTIFIER,
+  anonymous_id: correlation.anonymous_id,
+  user_id: correlation.user_id,
+  organization_id: correlation.organization_id,
+  session_id: correlation.session_id,
+  tab_id: correlation.tab_id,
+  interaction_id: correlation.interaction_id,
+  trace_id: correlation.trace_id,
+  sdk_collection_mode: "standard",
+  frontend_release: CLUEBASE_TEST_SETUP_SDK_VERSION,
+});
+
+export const buildBrowserEventPayload = ({ correlation, origin = null }) => {
+  const timestamp = new Date().toISOString();
+  const id = `${correlation.id}_browser`;
+  const pageUrl = origin
+    ? `${trimTrailingSlash(origin)}/cluebase/setup-doctor`
+    : null;
+  const context = browserSignalContext(correlation);
+  return {
+    batchId: `batch_${id}`,
+    idempotencyKey: `idem_${id}`,
+    sentAt: timestamp,
+    sourceType: "frontend_sdk",
+    sourceSchemaVersion: "1",
+    producerMetadata: {
+      producer_id: FRONTEND_SOURCE_IDENTIFIER,
+      sdk_type: "browser",
+      sdk_version: CLUEBASE_TEST_SETUP_SDK_VERSION,
+    },
+    events: [
+      sourceSignalEvent({
+        sourceEventId: `event_${id}_click`,
+        surface: "frontend",
+        name: "element_clicked",
+        spanKind: "INTERNAL",
+        spanId: hexId(`${id}_click`, 16),
+        attributes: {
+          "cluebase.event_name": "cluebase_test_browser_connectivity",
+          "cluebase.event_category": "custom",
+          "cluebase.status": "observed",
+          "cluebase.event_source": "frontend_sdk",
+          "cluebase.trace_id": correlation.trace_id,
+          "cluebase.interaction.id": correlation.interaction_id,
+          "cluebase.actor.anonymous_id": correlation.anonymous_id,
+          "cluebase.actor.user_id": correlation.user_id,
+          "cluebase.subject.organization_id": correlation.organization_id,
+          "cluebase.session.id": correlation.session_id,
+          "cluebase.tab.id": correlation.tab_id,
+          ...(pageUrl ? { "cluebase.page.url": pageUrl } : {}),
+          "cluebase.raw_event.payload": {
+            path: "/cluebase/setup-doctor",
+            currentUrl: pageUrl ?? "/cluebase/setup-doctor",
+            stableKey: "setup-doctor.browser-connectivity",
+            stableKeyQuality: "official",
+            event_name: "cluebase_test_browser_connectivity",
+            source_event_type: "cluebase_test_browser_connectivity",
+            elementTag: "button",
+            elementRole: "button",
+            clickTargetText: "Cluebase setup doctor",
+            primaryActionKey: "cluebase_test_browser_connectivity.clicked",
+          },
+        },
+        context,
+      }),
+      sourceSignalEvent({
+        sourceEventId: `event_${id}_identity`,
+        surface: "frontend",
+        name: "custom_emitted",
+        spanKind: "INTERNAL",
+        spanId: hexId(`${id}_identity`, 16),
+        startMs: 30,
+        endMs: 35,
+        attributes: {
+          "cluebase.event_source": "frontend_sdk",
+          "cluebase.trace_id": correlation.trace_id,
+          "cluebase.custom_event_name": "identity_identified",
+          "cluebase.custom_event_origin": "official_sdk_lifecycle",
+          "cluebase.actor.anonymous_id": correlation.anonymous_id,
+          "cluebase.actor.user_id": correlation.user_id,
+          "cluebase.subject.organization_id": correlation.organization_id,
+          "cluebase.session.id": correlation.session_id,
+          "cluebase.tab.id": correlation.tab_id,
+          "cluebase.interaction.id": correlation.interaction_id,
+          "cluebase.raw_event.payload": {
+            userId: correlation.user_id,
+            anonymousId: correlation.anonymous_id,
+            organizationId: correlation.organization_id,
+          },
+        },
+        context,
+      }),
+      sourceSignalEvent({
+        sourceEventId: `event_${id}_request`,
+        surface: "frontend",
+        name: "request_finished",
+        spanKind: "INTERNAL",
+        spanId: hexId(`${id}_request`, 16),
+        startMs: 40,
+        endMs: 65,
+        attributes: {
+          component: "fetch",
+          "http.method": "GET",
+          "http.request.method": "GET",
+          "http.route": "/cluebase/setup-doctor/backend-connectivity",
+          ...(pageUrl
+            ? {
+                "http.url": `${trimTrailingSlash(origin)}/cluebase/setup-doctor/backend-connectivity`,
+                "url.full": `${trimTrailingSlash(origin)}/cluebase/setup-doctor/backend-connectivity`,
+              }
+            : {}),
+          "http.status_code": 200,
+          "http.response.status_code": 200,
+          "cluebase.event_category": "request",
+          "cluebase.event_name": "request_finished",
+          "cluebase.status": "finished",
+          "cluebase.event_source": "frontend_sdk",
+          "cluebase.trace_id": correlation.trace_id,
+          "cluebase.request.id": correlation.request_id,
+          "cluebase.request_span_id": correlation.request_span_id,
+          "cluebase.interaction.id": correlation.interaction_id,
+          "cluebase.interaction.initiator": "human_user",
+          "cluebase.interaction.start_event_kind": "element_clicked",
+          "cluebase.actor.anonymous_id": correlation.anonymous_id,
+          "cluebase.actor.user_id": correlation.user_id,
+          "cluebase.subject.organization_id": correlation.organization_id,
+          "cluebase.session.id": correlation.session_id,
+          "cluebase.tab.id": correlation.tab_id,
+          "cluebase.raw_event.payload": {
+            path: "/cluebase/setup-doctor",
+            currentUrl: pageUrl ?? "/cluebase/setup-doctor",
+            method: "GET",
+            pathTemplate: "/cluebase/setup-doctor/backend-connectivity",
+            statusCode: 200,
+            durationMs: 25,
+            requestKind: "user_action",
+          },
+        },
+        context: {
+          ...context,
+          request_id: correlation.request_id,
+          request_span_id: correlation.request_span_id,
+        },
+      }),
+    ],
+  };
+};
+
+export const buildBackendEventPayload = ({
+  backendServiceKey,
+  correlation,
+  projectKey,
+}) => {
+  const timestamp = new Date().toISOString();
+  const id = `${correlation.id}_backend`;
+  const requestSpanId = hexId(`${id}_request_span`, 16);
+  const backendContext = {
+    producer_id: backendServiceKey,
+    anonymous_id: correlation.anonymous_id,
+    user_id: correlation.user_id,
+    organization_id: correlation.organization_id,
+    session_id: correlation.session_id,
+    tab_id: correlation.tab_id,
+    interaction_id: correlation.interaction_id,
+    request_id: correlation.request_id,
+    request_span_id: correlation.request_span_id,
+    trace_id: correlation.trace_id,
+  };
+  const resource = {
+    "service.name": backendServiceKey,
+    "telemetry.sdk.language": "nodejs",
+    "service.version": CLUEBASE_TEST_SETUP_SDK_VERSION,
+  };
+  return {
+    projectKey,
+    batchId: `batch_${id}`,
+    idempotencyKey: `idem_${id}`,
+    sentAt: timestamp,
+    sourceType: "backend_sdk",
+    sourceSchemaVersion: "1",
+    producerMetadata: {
+      producer_id: backendServiceKey,
+      service_name: backendServiceKey,
+      service_key: backendServiceKey,
+      sdk_type: "nodejs",
+      sdk_version: CLUEBASE_TEST_SETUP_SDK_VERSION,
+    },
+    events: [
+      sourceSignalEvent({
+        sourceEventId: `event_${id}_request`,
+        surface: "backend",
+        name: "GET /cluebase/setup-doctor/backend-connectivity",
+        spanKind: "SERVER",
+        spanId: requestSpanId,
+        attributes: {
+          "http.method": "GET",
+          "http.request.method": "GET",
+          "http.route": "/cluebase/setup-doctor/backend-connectivity",
+          "url.path": "/cluebase/setup-doctor/backend-connectivity",
+          "http.status_code": 200,
+          "http.response.status_code": 200,
+          "cluebase.event_name": "cluebase_test_backend_connectivity",
+          "cluebase.event_source": "backend_sdk",
+          "cluebase.trace_id": correlation.trace_id,
+          "cluebase.request.id": correlation.request_id,
+          "cluebase.request_span_id": correlation.request_span_id,
+          "cluebase.interaction.id": correlation.interaction_id,
+          "cluebase.actor.anonymous_id": correlation.anonymous_id,
+          "cluebase.actor.user_id": correlation.user_id,
+          "cluebase.subject.organization_id": correlation.organization_id,
+          "cluebase.session.id": correlation.session_id,
+          "cluebase.tab.id": correlation.tab_id,
+          "cluebase.decision.type": "permission",
+          "cluebase.decision.result": "allowed",
+          "cluebase.decision.reason_code": "cluebase_test_backend_connectivity_probe",
+          "cluebase.raw_event.payload": {
+            event_name: "cluebase_test_backend_connectivity",
+            pathTemplate: "/cluebase/setup-doctor/backend-connectivity",
+          },
+        },
+        context: backendContext,
+        resource,
+      }),
+      sourceSignalEvent({
+        sourceEventId: `event_${id}_data`,
+        surface: "backend",
+        name: "UPDATE cluebase_test_connectivity",
+        spanKind: "INTERNAL",
+        spanId: hexId(`${id}_data_span`, 16),
+        parentSpanId: requestSpanId,
+        startMs: 30,
+        endMs: 40,
+        attributes: {
+          "db.system": "postgresql",
+          "db.operation.name": "UPDATE",
+          "db.collection.name": "cluebase_test_connectivity",
+          "cluebase.data.resource.type": "table",
+          "cluebase.data.resource.key": "cluebase_test_connectivity",
+          "cluebase.changed_fields_schema": [
+            { field_key: "last_checked_at", field_type: "timestamp" },
+          ],
+          "cluebase.event_source": "backend_sdk",
+          "cluebase.trace_id": correlation.trace_id,
+          "cluebase.request.id": correlation.request_id,
+          "cluebase.request_span_id": correlation.request_span_id,
+          "cluebase.interaction.id": correlation.interaction_id,
+          "cluebase.actor.anonymous_id": correlation.anonymous_id,
+          "cluebase.actor.user_id": correlation.user_id,
+          "cluebase.subject.organization_id": correlation.organization_id,
+          "cluebase.session.id": correlation.session_id,
+          "cluebase.tab.id": correlation.tab_id,
+        },
+        context: backendContext,
+        resource,
+      }),
+      sourceSignalEvent({
+        sourceEventId: `event_${id}_dependency`,
+        surface: "backend",
+        name: "GET /api/v1/ingest/batch-status/:batchId",
+        spanKind: "CLIENT",
+        spanId: hexId(`${id}_dependency_span`, 16),
+        parentSpanId: requestSpanId,
+        startMs: 45,
+        endMs: 55,
+        attributes: {
+          "http.method": "GET",
+          "http.request.method": "GET",
+          "http.route": "/api/v1/ingest/batch-status/:batchId",
+          "url.path": "/api/v1/ingest/batch-status/:batchId",
+          "url.full":
+            "https://api.cluebase.example/api/v1/ingest/batch-status/test",
+          "server.address": "api.cluebase.example",
+          "http.status_code": 200,
+          "http.response.status_code": 200,
+          "cluebase.event_source": "backend_sdk",
+          "cluebase.trace_id": correlation.trace_id,
+          "cluebase.request.id": correlation.request_id,
+          "cluebase.request_span_id": correlation.request_span_id,
+          "cluebase.interaction.id": correlation.interaction_id,
+          "cluebase.actor.anonymous_id": correlation.anonymous_id,
+          "cluebase.actor.user_id": correlation.user_id,
+          "cluebase.subject.organization_id": correlation.organization_id,
+          "cluebase.session.id": correlation.session_id,
+          "cluebase.tab.id": correlation.tab_id,
+        },
+        context: backendContext,
+        resource,
+      }),
+    ],
+  };
+};