@obsunified/collector 2.1.1 → 2.2.0

package/src/plugins/connected-routes/manifest.ts

@@ -1,3 +1,7 @@
+import type {
+	CausalProofTier,
+	RelationshipCertainty,
+} from "@obsunified/types";
 import type {
 	ActionRef,
 	AICallRef,
@@ -26,7 +30,10 @@ export type ConnectedEntityKind =
 	| "user"
 	| "action"
 	| "agent_run"
-	| "tool_call";
+	| "tool_call"
+	| "change"
+	| "finding"
+	| "incident";
 
 export const KNOWN_KINDS: ReadonlySet<string> = new Set<ConnectedEntityKind>([
 	"span",
@@ -41,6 +48,9 @@ export const KNOWN_KINDS: ReadonlySet<string> = new Set<ConnectedEntityKind>([
 	"action",
 	"agent_run",
 	"tool_call",
+	"change",
+	"finding",
+	"incident",
 ]);
 
 export interface ConnectedLink {
@@ -54,6 +64,8 @@ export interface ConnectedLink {
 	confidence?: number;
 	reason?: string;
 	causalConfidence?: CausalConfidence;
+	relationshipCertainty?: RelationshipCertainty;
+	causalProofTier?: CausalProofTier;
 }
 
 export interface ConnectedSection {

package/src/plugins/connected-routes.ts

@@ -1049,6 +1049,277 @@ export const connectedRoutesPlugin: CollectorPlugin = {
 						manifest.rawManifest = actionManifest;
 					}
 				}
+			} else if (kind === "change") {
+				const db = sqlDbFor(c.env);
+				const changeRow = await db
+					.prepare(
+						`SELECT * FROM change_events WHERE project_id = ? AND id = ? LIMIT 1`,
+					)
+					.bind(projectId, id)
+					.first<{
+						id: string;
+						environment: string;
+						kind: string;
+						target_node_id: string;
+						service_name: string | null;
+						version: string | null;
+						previous_version: string | null;
+						commit_sha: string | null;
+						summary: string;
+					}>();
+				if (changeRow) {
+					manifest.up = [
+						{
+							label: "Target Ontology Node",
+							links: [
+								{
+									label: `${changeRow.target_node_id} (${changeRow.environment})`,
+									href: `#/health?node=${encodeURIComponent(changeRow.target_node_id)}`,
+									relationshipCertainty: "exact",
+									reason: "Target node mutated by this change event.",
+								},
+							],
+						},
+					];
+
+					const findings = await db
+						.prepare(
+							`SELECT id, title, causal_proof_tier, confidence, incident_id
+							 FROM investigation_findings
+							 WHERE project_id = ? AND environment = ? AND contributing_change_id = ?
+							 ORDER BY created_at DESC LIMIT 10`,
+						)
+						.bind(projectId, changeRow.environment, changeRow.id)
+						.all<{
+							id: string;
+							title: string;
+							causal_proof_tier: string;
+							confidence: number;
+							incident_id: string | null;
+						}>();
+
+					manifest.down = [
+						{
+							label: "Attributed Findings",
+							links: findings.results.map((f) => ({
+								label: f.title,
+								href: `#/findings/${encodeURIComponent(f.id)}`,
+								entityKind: "finding",
+								entityId: f.id,
+								relationshipCertainty: "exact",
+								causalProofTier:
+									f.causal_proof_tier as import("@obsunified/types").CausalProofTier,
+								confidence: f.confidence,
+								reason: "Finding attributes this change event.",
+							})),
+							emptyReason:
+								findings.results.length === 0
+									? "No investigation findings cite this change event."
+									: undefined,
+						},
+					];
+
+					const spans = changeRow.version
+						? await db
+								.prepare(
+									`SELECT DISTINCT trace_id, span_id, service_name, span_name
+									 FROM telemetry_spans
+									 WHERE project_id = ? AND environment = ? AND service_version = ? AND status_code = 2
+									 ORDER BY start_time DESC LIMIT 5`,
+								)
+								.bind(projectId, changeRow.environment, changeRow.version)
+								.all<{
+									trace_id: string;
+									span_id: string;
+									service_name: string;
+									span_name: string;
+								}>()
+						: { results: [] };
+
+					manifest.across = [
+						{
+							label: "Failing Spans on Cohort Version",
+							links: spans.results.map((s) => ({
+								label: `${s.service_name} · ${s.span_name}`,
+								href: `#/traces/${s.trace_id}#span=${s.span_id}`,
+								entityKind: "span",
+								entityId: `${s.trace_id}:${s.span_id}`,
+								relationshipCertainty: "exact",
+								reason: `Span executed on version ${changeRow.version}.`,
+							})),
+							emptyReason:
+								spans.results.length === 0
+									? "No failing spans recorded on this change version."
+									: undefined,
+						},
+					];
+				}
+			} else if (kind === "finding") {
+				const db = sqlDbFor(c.env);
+				const findingRow = await db
+					.prepare(
+						`SELECT * FROM investigation_findings WHERE project_id = ? AND id = ? LIMIT 1`,
+					)
+					.bind(projectId, id)
+					.first<{
+						id: string;
+						environment: string;
+						incident_id: string | null;
+						title: string;
+						causal_proof_tier: string;
+						confidence: number;
+						symptom_entity_kind: string;
+						symptom_entity_id: string;
+						fault_locus_entity_kind: string;
+						fault_locus_entity_id: string;
+						contributing_change_id: string | null;
+						contending_trace_id: string | null;
+						agent_run_id: string | null;
+					}>();
+				if (findingRow) {
+					const proofTier =
+						findingRow.causal_proof_tier as import("@obsunified/types").CausalProofTier;
+					manifest.up = [];
+					if (findingRow.incident_id) {
+						manifest.up.push({
+							label: "Incident Investigation",
+							links: [
+								{
+									label: `incident ${findingRow.incident_id}`,
+									href: `#/incidents/${encodeURIComponent(findingRow.incident_id)}`,
+									entityKind: "incident",
+									entityId: findingRow.incident_id,
+									relationshipCertainty: "exact",
+									causalProofTier: proofTier,
+								},
+							],
+						});
+					}
+					if (findingRow.contributing_change_id) {
+						manifest.up.push({
+							label: "Contributing Change",
+							links: [
+								{
+									label: `change ${findingRow.contributing_change_id}`,
+									href: `#/changes/${encodeURIComponent(findingRow.contributing_change_id)}`,
+									entityKind: "change",
+									entityId: findingRow.contributing_change_id,
+									relationshipCertainty: "exact",
+									causalProofTier: proofTier,
+									confidence: findingRow.confidence,
+								},
+							],
+						});
+					}
+					manifest.across = [
+						{
+							label: "Fault Locus & Symptom",
+							links: [
+								{
+									label: `fault locus: ${findingRow.fault_locus_entity_id}`,
+									href: `#/traces?q=${encodeURIComponent(findingRow.fault_locus_entity_id)}`,
+									relationshipCertainty: "exact",
+									causalProofTier: proofTier,
+								},
+								...(findingRow.contending_trace_id
+									? [
+											{
+												label: `contending trace ${findingRow.contending_trace_id}`,
+												href: `#/traces/${encodeURIComponent(findingRow.contending_trace_id)}`,
+												entityKind: "trace" as const,
+												entityId: findingRow.contending_trace_id,
+												relationshipCertainty: "inferred" as const,
+												causalProofTier: proofTier,
+											},
+										]
+									: []),
+							],
+						},
+					];
+					manifest.down = [
+						{
+							label: "Agent Lineage",
+							links: [
+								...(findingRow.agent_run_id
+									? [
+											{
+												...linkToAgentRun(findingRow.agent_run_id),
+												relationshipCertainty: "exact" as const,
+												causalProofTier: proofTier,
+											},
+										]
+									: []),
+							],
+							emptyReason: !findingRow.agent_run_id
+								? "No agent run linked to this finding."
+								: undefined,
+						},
+					];
+				}
+			} else if (kind === "incident") {
+				const db = sqlDbFor(c.env);
+				const incRow = await db
+					.prepare(
+						`SELECT * FROM incident_investigations WHERE project_id = ? AND id = ? LIMIT 1`,
+					)
+					.bind(projectId, id)
+					.first<{
+						id: string;
+						environment: string;
+						target_node_id: string;
+						symptom_anchor_kind: string;
+						symptom_anchor_id: string;
+						status: string;
+					}>();
+				if (incRow) {
+					manifest.up = [
+						{
+							label: "Trigger Signal",
+							links: [
+								{
+									label: `${incRow.symptom_anchor_kind}: ${incRow.symptom_anchor_id}`,
+									href: `#/alerts?id=${encodeURIComponent(incRow.symptom_anchor_id)}`,
+									entityKind:
+										incRow.symptom_anchor_kind === "analysis"
+											? "analysis"
+											: "alert",
+									entityId: incRow.symptom_anchor_id,
+									relationshipCertainty: "exact",
+								},
+							],
+						},
+					];
+					const incFindings = await db
+						.prepare(
+							`SELECT id, title, causal_proof_tier FROM investigation_findings
+							 WHERE project_id = ? AND incident_id = ?
+							 ORDER BY created_at DESC LIMIT 5`,
+						)
+						.bind(projectId, incRow.id)
+						.all<{
+							id: string;
+							title: string;
+							causal_proof_tier: string;
+						}>();
+					manifest.across = [
+						{
+							label: "Findings",
+							links: incFindings.results.map((f) => ({
+								label: f.title,
+								href: `#/findings/${encodeURIComponent(f.id)}`,
+								entityKind: "finding" as const,
+								entityId: f.id,
+								relationshipCertainty: "exact" as const,
+								causalProofTier:
+									f.causal_proof_tier as import("@obsunified/types").CausalProofTier,
+							})),
+							emptyReason:
+								incFindings.results.length > 0
+									? undefined
+									: "No finding recorded for this incident yet.",
+						},
+					];
+				}
 			} else if (kind === "alert" || kind === "analysis") {
 				// Alerts and Analyses are topic-related, not identity-related.
 				// Their connections come from the alert_rules.analysis_id and

package/src/plugins/default-span-enrichment.ts

@@ -4,6 +4,7 @@ import {
 	SESSION_ID_KEY,
 } from "@obsunified/types/constants";
 import type { CollectorPlugin } from "../framework/collector";
+import { extractSpanLineageAndTopology } from "../lib/autosre-ontology";
 import { parseJsonRecord } from "../lib/json";
 
 export const defaultSpanEnrichmentPlugin: CollectorPlugin = {
@@ -77,7 +78,7 @@ export const defaultSpanEnrichmentPlugin: CollectorPlugin = {
 							? (resourceAttributes["telemetry.sdk.name"] as string)
 							: null;
 
-					return {
+					const candidate: StoredSpan = {
 						...span,
 						serviceName,
 						attributesJson: JSON.stringify(normalizedAttributes),
@@ -85,6 +86,17 @@ export const defaultSpanEnrichmentPlugin: CollectorPlugin = {
 						interactionId,
 						telemetrySdkName,
 					};
+
+					const lineage = extractSpanLineageAndTopology(candidate);
+
+					return {
+						...candidate,
+						environment: lineage.environment,
+						serviceVersion: lineage.serviceVersion,
+						commitSha: lineage.commitSha,
+						targetNodeId: lineage.targetNode?.id ?? null,
+						errorSignature: lineage.errorSignature,
+					};
 				});
 			},
 		});

package/src/plugins/eval-cases-routes.ts

@@ -50,6 +50,8 @@ interface EvalCaseResultResponse {
 	passed: boolean;
 	score: number | null;
 	actualOutcome: string | null;
+	inputPayloadHash: string | null;
+	failureFingerprint: string | null;
 	details: unknown;
 	createdAt: string;
 	evidenceReferences?: EvidenceReference[];
@@ -62,6 +64,12 @@ interface EvalRunRequestBody {
 	evalCaseId?: unknown;
 	status?: unknown;
 	candidate?: unknown;
+	environment?: unknown;
+	serviceVersion?: unknown;
+	commitSha?: unknown;
+	configDigest?: unknown;
+	inputPayloadHash?: unknown;
+	failureFingerprint?: unknown;
 	startedAt?: unknown;
 	endedAt?: unknown;
 	totalCount?: unknown;
@@ -294,6 +302,20 @@ export const evalCasesRoutesPlugin: CollectorPlugin = {
 				id: id ?? undefined,
 				evalCaseId,
 				status,
+				environment:
+					asOptionalString(body.environment) ??
+					asOptionalString(candidate.environment),
+				serviceVersion:
+					asOptionalString(body.serviceVersion) ??
+					asOptionalString(candidate.serviceVersion),
+				commitSha:
+					asOptionalString(body.commitSha) ??
+					asOptionalString(candidate.commitSha),
+				configDigest:
+					asOptionalString(body.configDigest) ??
+					asOptionalString(candidate.configDigest),
+				inputPayloadHash: asOptionalString(body.inputPayloadHash),
+				failureFingerprint: asOptionalString(body.failureFingerprint),
 				candidate: {
 					agentId: asOptionalString(candidate.agentId),
 					agentVersion: asOptionalString(candidate.agentVersion),
@@ -302,6 +324,18 @@ export const evalCasesRoutesPlugin: CollectorPlugin = {
 					modelProvider: asOptionalString(candidate.modelProvider),
 					model: asOptionalString(candidate.model),
 					modelVersion: asOptionalString(candidate.modelVersion),
+					environment:
+						asOptionalString(candidate.environment) ??
+						asOptionalString(body.environment),
+					serviceVersion:
+						asOptionalString(candidate.serviceVersion) ??
+						asOptionalString(body.serviceVersion),
+					commitSha:
+						asOptionalString(candidate.commitSha) ??
+						asOptionalString(body.commitSha),
+					configDigest:
+						asOptionalString(candidate.configDigest) ??
+						asOptionalString(body.configDigest),
 				},
 				startedAt: asOptionalString(body.startedAt),
 				endedAt: asOptionalString(body.endedAt),
@@ -369,6 +403,8 @@ export const evalCasesRoutesPlugin: CollectorPlugin = {
 				passed?: unknown;
 				score?: unknown;
 				actualOutcome?: unknown;
+				inputPayloadHash?: unknown;
+				failureFingerprint?: unknown;
 				details?: unknown;
 			};
 			const parsed = await readJsonObject<typeof body>(c);
@@ -411,6 +447,16 @@ export const evalCasesRoutesPlugin: CollectorPlugin = {
 					: null;
 			const actualOutcome =
 				typeof body.actualOutcome === "string" ? body.actualOutcome : null;
+			const inputPayloadHash =
+				typeof body.inputPayloadHash === "string" &&
+				body.inputPayloadHash.trim()
+					? body.inputPayloadHash.trim()
+					: null;
+			const failureFingerprint =
+				typeof body.failureFingerprint === "string" &&
+				body.failureFingerprint.trim()
+					? body.failureFingerprint.trim()
+					: null;
 			const details_json =
 				body.details === undefined ? null : JSON.stringify(body.details);
 			const now = new Date().toISOString();
@@ -418,8 +464,9 @@ export const evalCasesRoutesPlugin: CollectorPlugin = {
 			await db
 				.prepare(
 					`INSERT INTO eval_case_results (
-					id, project_id, eval_case_id, run_id, passed, score, actual_outcome, details_json, created_at
-				) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+					id, project_id, eval_case_id, run_id, passed, score, actual_outcome,
+					input_payload_hash, failure_fingerprint, details_json, created_at
+				) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
 				)
 				.bind(
 					id,
@@ -429,6 +476,8 @@ export const evalCasesRoutesPlugin: CollectorPlugin = {
 					passed,
 					score,
 					actualOutcome,
+					inputPayloadHash,
+					failureFingerprint,
 					details_json,
 					now,
 				)
@@ -446,6 +495,8 @@ export const evalCasesRoutesPlugin: CollectorPlugin = {
 				passed: body.passed,
 				score,
 				actualOutcome,
+				inputPayloadHash,
+				failureFingerprint,
 				details: body.details ?? null,
 				createdAt: now,
 				evidenceReferences: evalCaseResultEvidenceReferences(evalCase, id),
@@ -482,6 +533,8 @@ export const evalCasesRoutesPlugin: CollectorPlugin = {
 					passed: number;
 					score: number | null;
 					actual_outcome: string | null;
+					input_payload_hash?: string | null;
+					failure_fingerprint?: string | null;
 					details_json: string | null;
 					created_at: string;
 				}>();
@@ -504,6 +557,8 @@ export const evalCasesRoutesPlugin: CollectorPlugin = {
 					passed: row.passed === 1,
 					score: row.score,
 					actualOutcome: row.actual_outcome,
+					inputPayloadHash: row.input_payload_hash ?? null,
+					failureFingerprint: row.failure_fingerprint ?? null,
 					details: parseJsonMaybe(row.details_json),
 					createdAt: row.created_at,
 					evidenceReferences: evalCaseResultEvidenceReferences(