@obsunified/collector 2.0.1

package/src/migrations-postgres/015_metrics.sql

@@ -0,0 +1,47 @@
+CREATE TABLE IF NOT EXISTS metric_series (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  name TEXT NOT NULL,
+  description TEXT,
+  unit TEXT,
+  type TEXT NOT NULL,
+  is_monotonic INTEGER,
+  temporality INTEGER,
+  scope_name TEXT,
+  scope_version TEXT,
+  service_name TEXT,
+  resource_attrs_json JSONB,
+  attributes_json JSONB,
+  identity TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  UNIQUE(project_id, identity)
+);
+
+CREATE INDEX IF NOT EXISTS idx_metric_series_project_name
+  ON metric_series (project_id, name);
+
+CREATE TABLE IF NOT EXISTS metric_point (
+  id TEXT PRIMARY KEY,
+  series_id TEXT NOT NULL,
+  project_id TEXT NOT NULL,
+  ts_ns TEXT NOT NULL,
+  start_ts_ns TEXT,
+  value DOUBLE PRECISION,
+  count BIGINT,
+  sum DOUBLE PRECISION,
+  min DOUBLE PRECISION,
+  max DOUBLE PRECISION,
+  bounds_json JSONB,
+  bucket_counts_json JSONB,
+  exemplars_json JSONB,
+  received_at TEXT NOT NULL,
+  expires_at TEXT NOT NULL,
+  FOREIGN KEY (series_id) REFERENCES metric_series(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_metric_point_series_ts
+  ON metric_point (series_id, ts_ns);
+CREATE INDEX IF NOT EXISTS idx_metric_point_expires
+  ON metric_point (expires_at);
+CREATE INDEX IF NOT EXISTS idx_metric_point_project_received
+  ON metric_point (project_id, received_at DESC);

package/src/migrations-postgres/016_metrics_exp_histogram_summary.sql

@@ -0,0 +1 @@
+ALTER TABLE metric_point ADD COLUMN IF NOT EXISTS extra_json JSONB;

package/src/migrations-postgres/017_span_dropped_counts.sql

@@ -0,0 +1,4 @@
+ALTER TABLE telemetry_spans ADD COLUMN IF NOT EXISTS trace_state TEXT;
+ALTER TABLE telemetry_spans ADD COLUMN IF NOT EXISTS dropped_attributes_count INTEGER NOT NULL DEFAULT 0;
+ALTER TABLE telemetry_spans ADD COLUMN IF NOT EXISTS dropped_events_count INTEGER NOT NULL DEFAULT 0;
+ALTER TABLE telemetry_spans ADD COLUMN IF NOT EXISTS dropped_links_count INTEGER NOT NULL DEFAULT 0;

package/src/migrations-postgres/018_log_flags.sql

@@ -0,0 +1,2 @@
+ALTER TABLE logs ADD COLUMN IF NOT EXISTS flags INTEGER NOT NULL DEFAULT 0;
+ALTER TABLE logs ADD COLUMN IF NOT EXISTS dropped_attributes_count INTEGER NOT NULL DEFAULT 0;

package/src/migrations-postgres/019_ai_span_payloads.sql

@@ -0,0 +1,18 @@
+CREATE TABLE IF NOT EXISTS ai_span_payloads (
+  project_id TEXT NOT NULL,
+  trace_id TEXT NOT NULL,
+  span_id TEXT NOT NULL,
+  span_kind TEXT NOT NULL,
+  input_json JSONB,
+  output_json JSONB,
+  received_at TEXT NOT NULL,
+  expires_at TEXT NOT NULL,
+  PRIMARY KEY (trace_id, span_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_ai_payloads_received
+  ON ai_span_payloads (received_at DESC);
+CREATE INDEX IF NOT EXISTS idx_ai_payloads_project
+  ON ai_span_payloads (project_id, received_at DESC);
+CREATE INDEX IF NOT EXISTS idx_ai_payloads_kind
+  ON ai_span_payloads (project_id, span_kind, received_at DESC);

package/src/migrations-postgres/020_ai_span_evaluations.sql

@@ -0,0 +1,21 @@
+CREATE TABLE IF NOT EXISTS ai_span_evaluations (
+  evaluation_id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  trace_id TEXT NOT NULL,
+  span_id TEXT NOT NULL,
+  name TEXT NOT NULL,
+  score DOUBLE PRECISION,
+  label TEXT,
+  explanation TEXT,
+  source TEXT NOT NULL,
+  metadata_json JSONB,
+  created_at TEXT NOT NULL,
+  expires_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_ai_evals_span
+  ON ai_span_evaluations (trace_id, span_id);
+CREATE INDEX IF NOT EXISTS idx_ai_evals_project_created
+  ON ai_span_evaluations (project_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_ai_evals_project_name
+  ON ai_span_evaluations (project_id, name, created_at DESC);

package/src/migrations-postgres/021_ai_span_session.sql

@@ -0,0 +1,7 @@
+ALTER TABLE ai_span_payloads ADD COLUMN IF NOT EXISTS session_id TEXT;
+ALTER TABLE ai_span_payloads ADD COLUMN IF NOT EXISTS user_id TEXT;
+
+CREATE INDEX IF NOT EXISTS idx_ai_payloads_session
+  ON ai_span_payloads (project_id, session_id, received_at DESC);
+CREATE INDEX IF NOT EXISTS idx_ai_payloads_user
+  ON ai_span_payloads (project_id, user_id, received_at DESC);

package/src/migrations-postgres/022_span_log_session_id.sql

@@ -0,0 +1,7 @@
+ALTER TABLE telemetry_spans ADD COLUMN IF NOT EXISTS session_id TEXT;
+ALTER TABLE logs ADD COLUMN IF NOT EXISTS session_id TEXT;
+
+CREATE INDEX IF NOT EXISTS idx_spans_session
+  ON telemetry_spans (project_id, session_id, received_at DESC);
+CREATE INDEX IF NOT EXISTS idx_logs_session
+  ON logs (project_id, session_id, received_at DESC);

package/src/migrations-postgres/023_service_map_indexes.sql

@@ -0,0 +1,9 @@
+CREATE INDEX IF NOT EXISTS idx_spans_project_received
+  ON telemetry_spans (project_id, received_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_spans_with_links
+  ON telemetry_spans (project_id, received_at DESC)
+  WHERE links_json IS NOT NULL AND links_json <> '[]'::jsonb;
+
+CREATE INDEX IF NOT EXISTS idx_spans_project_service_received
+  ON telemetry_spans (project_id, service_name, received_at DESC);

package/src/migrations-postgres/024_analysis_results.sql

@@ -0,0 +1,41 @@
+CREATE TABLE IF NOT EXISTS analysis_definitions (
+  project_id TEXT NOT NULL,
+  id TEXT NOT NULL,
+  title TEXT NOT NULL,
+  "group" TEXT NOT NULL,
+  source TEXT NOT NULL,
+  view TEXT NOT NULL,
+  refresh_seconds INTEGER,
+  sql TEXT,
+  scope_json JSONB,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  last_run_at TEXT,
+  PRIMARY KEY (project_id, id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_analysis_definitions_group
+  ON analysis_definitions (project_id, "group", id);
+
+CREATE TABLE IF NOT EXISTS analysis_results (
+  id BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  analysis_id TEXT NOT NULL,
+  generated_at BIGINT NOT NULL,
+  params_hash TEXT,
+  status TEXT NOT NULL,
+  primary_value DOUBLE PRECISION,
+  baseline_value DOUBLE PRECISION,
+  delta_pct DOUBLE PRECISION,
+  payload_json JSONB NOT NULL,
+  narrative TEXT,
+  narrative_signature TEXT,
+  duration_ms INTEGER NOT NULL,
+  expires_at BIGINT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_analysis_results_latest
+  ON analysis_results (project_id, analysis_id, generated_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_analysis_results_expires
+  ON analysis_results (expires_at);

package/src/migrations-postgres/025_stage6_autopinning_alerts.sql

@@ -0,0 +1,17 @@
+CREATE TABLE IF NOT EXISTS ask_evidence_events (
+  id BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  analysis_id TEXT NOT NULL,
+  asked_at BIGINT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_ask_evidence_events_recent
+  ON ask_evidence_events (project_id, asked_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_ask_evidence_events_analysis
+  ON ask_evidence_events (project_id, analysis_id, asked_at DESC);
+
+ALTER TABLE alert_rules ADD COLUMN IF NOT EXISTS analysis_id TEXT;
+
+CREATE INDEX IF NOT EXISTS idx_alert_rules_analysis
+  ON alert_rules (project_id, analysis_id);

package/src/migrations-postgres/026_obs_dashboard_project_seed.sql

@@ -0,0 +1,14 @@
+INSERT INTO projects (id, name, slug, created_at)
+VALUES ('obs-dashboard', 'Obs Dashboard', 'obs-dashboard', now()::text)
+ON CONFLICT (id) DO NOTHING;
+
+INSERT INTO ingest_keys (id, project_id, key_hash, key_prefix, name, created_at)
+VALUES (
+  'obs-dashboard-bootstrap',
+  'obs-dashboard',
+  decode('6aa18dc1261b312e98b236d5a7dae698d1a90ecbe33d8024744063a066a35b9b', 'hex'),
+  'obs_dashboard_65',
+  'bootstrap',
+  now()::text
+)
+ON CONFLICT (id) DO NOTHING;

package/src/migrations-postgres/027_identity_propagation.sql

@@ -0,0 +1,27 @@
+ALTER TABLE telemetry_spans ADD COLUMN IF NOT EXISTS interaction_id TEXT;
+ALTER TABLE logs ADD COLUMN IF NOT EXISTS interaction_id TEXT;
+ALTER TABLE usage_events ADD COLUMN IF NOT EXISTS interaction_id TEXT;
+ALTER TABLE ai_calls ADD COLUMN IF NOT EXISTS interaction_id TEXT;
+ALTER TABLE ai_span_payloads ADD COLUMN IF NOT EXISTS interaction_id TEXT;
+
+ALTER TABLE ai_calls ADD COLUMN IF NOT EXISTS session_id TEXT;
+
+CREATE INDEX IF NOT EXISTS idx_spans_interaction
+  ON telemetry_spans (project_id, interaction_id, received_at DESC)
+  WHERE interaction_id IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_logs_interaction
+  ON logs (project_id, interaction_id, received_at DESC)
+  WHERE interaction_id IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_usage_interaction
+  ON usage_events (project_id, interaction_id, received_at DESC)
+  WHERE interaction_id IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_ai_calls_interaction
+  ON ai_calls (project_id, interaction_id, received_at DESC)
+  WHERE interaction_id IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_ai_calls_session
+  ON ai_calls (project_id, session_id, received_at DESC)
+  WHERE session_id IS NOT NULL;

package/src/migrations-postgres/028_profile_blobs.sql

@@ -0,0 +1,48 @@
+-- RFC 0007 — pprof profiling receiver storage.
+--
+-- Postgres translation of the D1 profile metadata/index tables. Blob bytes live
+-- in S3-compatible storage; these tables make profiles discoverable by id,
+-- service, and trace.
+
+CREATE TABLE IF NOT EXISTS profile_blobs (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  service_name TEXT,
+  profile_type TEXT NOT NULL,
+  start_ts TEXT NOT NULL,
+  end_ts TEXT NOT NULL,
+  duration_ms BIGINT NOT NULL,
+  blob_size_bytes BIGINT NOT NULL,
+  blob_url TEXT NOT NULL,
+  sample_count BIGINT,
+  agent TEXT,
+  resource_attrs_json JSONB,
+  received_at TEXT NOT NULL,
+  expires_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_profile_blobs_service_ts
+  ON profile_blobs (project_id, service_name, end_ts DESC);
+
+CREATE INDEX IF NOT EXISTS idx_profile_blobs_expires
+  ON profile_blobs (expires_at);
+
+-- Postgres-only GIN index so the dashboard read paths can query against
+-- resource attributes (service.version, deployment.environment, etc.).
+-- Matches the JSONB+GIN pattern from 001 and 031.
+CREATE INDEX IF NOT EXISTS idx_profile_blobs_resource_attrs_gin
+  ON profile_blobs USING GIN (resource_attrs_json);
+
+CREATE TABLE IF NOT EXISTS profile_trace_index (
+  profile_id TEXT NOT NULL,
+  trace_id TEXT NOT NULL,
+  project_id TEXT NOT NULL,
+  PRIMARY KEY (profile_id, trace_id),
+  FOREIGN KEY (profile_id) REFERENCES profile_blobs(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_profile_trace_index_trace
+  ON profile_trace_index (project_id, trace_id);
+
+CREATE INDEX IF NOT EXISTS idx_profile_trace_index_profile
+  ON profile_trace_index (profile_id);

package/src/migrations-postgres/029_telemetry_sdk_name.sql

@@ -0,0 +1,5 @@
+ALTER TABLE telemetry_spans ADD COLUMN IF NOT EXISTS telemetry_sdk_name TEXT;
+
+CREATE INDEX IF NOT EXISTS idx_spans_sdk_name
+  ON telemetry_spans (project_id, telemetry_sdk_name, received_at DESC)
+  WHERE telemetry_sdk_name IS NOT NULL;

package/src/migrations-postgres/030_analysis_claim.sql

@@ -0,0 +1,5 @@
+ALTER TABLE analysis_definitions ADD COLUMN IF NOT EXISTS last_started_at TEXT;
+
+CREATE INDEX IF NOT EXISTS idx_analysis_definitions_started
+  ON analysis_definitions (project_id, last_started_at)
+  WHERE last_started_at IS NOT NULL;

package/src/migrations-postgres/031_agent_action_graph.sql

@@ -0,0 +1,190 @@
+-- RFC 0010: Agent Action Graph Spine Schema (Phase 1)
+--
+-- Creates the action spine and detail leaf tables, and extends existing tables 
+-- to support higher-level causal action tracing for agentic systems.
+
+-- 1. General Action Spine
+CREATE TABLE IF NOT EXISTS actions (
+  id TEXT PRIMARY KEY,                       -- Unique ULID / ID for this action
+  project_id TEXT NOT NULL,                  -- Project scope
+  root_action_id TEXT NOT NULL,              -- ULID of the root causal action
+  caused_by_action_id TEXT,                  -- ULID of the parent causal action
+  actor_type TEXT NOT NULL,                  -- human, agent, service, workflow, system
+  actor_id TEXT,                             -- ID of the actor initiating this action
+  action_kind TEXT NOT NULL,                 -- agent.run, agent.step, llm.call, tool.call, retrieval, eval, etc.
+  name TEXT,                                 -- Human readable name
+  status TEXT NOT NULL DEFAULT 'ok',         -- ok, error
+  started_at TEXT NOT NULL,                  -- ISO8601 timestamp
+  ended_at TEXT,                             -- ISO8601 timestamp
+  duration_ms INTEGER,                       -- Execution duration
+  trace_id TEXT,                             -- Optional linked OTel trace ID
+  span_id TEXT,                              -- Optional linked OTel span ID
+  session_id TEXT,                           -- Optional browser/user session
+  interaction_id TEXT,                       -- Optional click-scoped correlation key
+  user_id TEXT,                              -- Optional user ID
+  agent_run_id TEXT,                         -- Optional linked Agent Run ID
+  step_id TEXT,                              -- Optional linked Step ID
+  tool_call_id TEXT,                         -- Optional linked Tool Call ID
+  prompt_version TEXT,                       -- Denormalized prompt version
+  model_name TEXT,                           -- Denormalized LLM model name
+  provider TEXT,                             -- Denormalized LLM provider name
+  total_cost_usd DOUBLE PRECISION,           -- Denormalized token/tool cost
+  attrs_json JSONB                           -- Arbitrary JSON key-value store for plugin/custom data
+);
+
+-- Indices for fast spine traversal
+CREATE INDEX IF NOT EXISTS idx_actions_project_root
+  ON actions (project_id, root_action_id, started_at);
+
+CREATE INDEX IF NOT EXISTS idx_actions_project_actor
+  ON actions (project_id, actor_type, actor_id, started_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_actions_project_trace
+  ON actions (project_id, trace_id)
+  WHERE trace_id IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_actions_project_interaction
+  ON actions (project_id, interaction_id)
+  WHERE interaction_id IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_actions_project_agent_run
+  ON actions (project_id, agent_run_id, started_at)
+  WHERE agent_run_id IS NOT NULL;
+
+-- Postgres-only GIN index
+CREATE INDEX IF NOT EXISTS idx_actions_attrs_gin
+  ON actions USING GIN (attrs_json);
+
+
+-- 2. Detail Leaf: Agent Runs
+CREATE TABLE IF NOT EXISTS agent_runs (
+  id TEXT PRIMARY KEY,                       -- Matches actions.id for the run's root action
+  project_id TEXT NOT NULL,
+  agent_id TEXT NOT NULL,                    -- Stable identifier of the agent template/codebase
+  agent_name TEXT NOT NULL,                  -- Human-readable name of the agent
+  agent_version TEXT NOT NULL,               -- Version of agent configuration/strategy
+  goal TEXT,                                 -- High-level prompt or goal of the run
+  outcome TEXT,                              -- Final answer, result summary, or output
+  autonomy_level TEXT NOT NULL,              -- read_only, suggested_action, human_approved_write, autonomous_write, blocked_by_policy
+  status TEXT NOT NULL DEFAULT 'running',    -- running, success, failed
+  error_message TEXT,                        -- Optional error string
+  total_cost_usd DOUBLE PRECISION DEFAULT 0.0,
+  total_duration_ms INTEGER,
+  metadata_json JSONB                        -- Opt-in debug metadata
+);
+
+CREATE INDEX IF NOT EXISTS idx_agent_runs_project_agent
+  ON agent_runs (project_id, agent_id, status);
+
+CREATE INDEX IF NOT EXISTS idx_agent_runs_metadata_gin
+  ON agent_runs USING GIN (metadata_json);
+
+
+-- 3. Detail Leaf: Tool Calls
+CREATE TABLE IF NOT EXISTS tool_calls (
+  id TEXT PRIMARY KEY,                       -- Unique identifier (often matches OTel span_id or actions.id)
+  action_id TEXT NOT NULL,                   -- Links back to actions.id
+  project_id TEXT NOT NULL,
+  tool_name TEXT NOT NULL,                   -- Named tool (e.g. sql_query, fetch_invoice)
+  args_hash TEXT NOT NULL,                   -- SHA256 of args for privacy-preserving cache key
+  result_hash TEXT NOT NULL,                 -- SHA256 of result for parity verification
+  error_type TEXT,                           -- Optional error classifier (e.g. timeout, auth)
+  side_effect INTEGER NOT NULL DEFAULT 0,    -- Boolean (0/1): does this tool mutate state?
+  approval_state TEXT,                       -- suggested, human_approved, bypassed, blocked
+  args_redacted JSONB,                       -- Opt-in redacted parameters JSON
+  result_redacted JSONB                      -- Opt-in redacted result JSON
+);
+
+CREATE INDEX IF NOT EXISTS idx_tool_calls_action
+  ON tool_calls (action_id);
+
+CREATE INDEX IF NOT EXISTS idx_tool_calls_name
+  ON tool_calls (project_id, tool_name);
+
+CREATE INDEX IF NOT EXISTS idx_tool_calls_args_redacted_gin
+  ON tool_calls USING GIN (args_redacted);
+
+CREATE INDEX IF NOT EXISTS idx_tool_calls_result_redacted_gin
+  ON tool_calls USING GIN (result_redacted);
+
+
+-- 4. Detail Leaf: Retrieval Events
+CREATE TABLE IF NOT EXISTS retrieval_events (
+  id TEXT PRIMARY KEY,
+  action_id TEXT NOT NULL,                   -- Links back to actions.id
+  project_id TEXT NOT NULL,
+  retriever_name TEXT NOT NULL,              -- Name of vector DB or retriever system
+  query_hash TEXT NOT NULL,                  -- SHA-256 of the retrieval query string
+  documents_json JSONB,                      -- Array of { docId, score, sourceId, snippet_preview }
+  total_results INTEGER NOT NULL DEFAULT 0,
+  max_relevance_score DOUBLE PRECISION,
+  duration_ms INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS idx_retrieval_events_action
+  ON retrieval_events (action_id);
+
+CREATE INDEX IF NOT EXISTS idx_retrieval_events_docs_gin
+  ON retrieval_events USING GIN (documents_json);
+
+
+-- 5. Detail Leaf: Evaluation & Guardrail Results
+CREATE TABLE IF NOT EXISTS eval_results (
+  id TEXT PRIMARY KEY,
+  action_id TEXT NOT NULL,                   -- Links back to actions.id
+  project_id TEXT NOT NULL,
+  evaluator_name TEXT NOT NULL,              -- Name of the evaluator or guardrail (e.g. groundedness)
+  evaluator_version TEXT NOT NULL,           -- Grader version
+  score DOUBLE PRECISION,                    -- Numeric metric between 0.0 and 1.0
+  passed INTEGER NOT NULL DEFAULT 1,         -- Boolean (0/1) for binary policy gates
+  reasoning TEXT,                            -- Explanation or chain-of-thought of the grader
+  rubric_json JSONB                          -- Optional grader schema or rubric details
+);
+
+CREATE INDEX IF NOT EXISTS idx_eval_results_action
+  ON eval_results (action_id);
+
+CREATE INDEX IF NOT EXISTS idx_eval_results_rubric_gin
+  ON eval_results USING GIN (rubric_json);
+
+
+-- 6. Detail Leaf: Generated Artifacts
+CREATE TABLE IF NOT EXISTS artifacts (
+  id TEXT PRIMARY KEY,
+  action_id TEXT NOT NULL,                   -- Links back to actions.id
+  project_id TEXT NOT NULL,
+  artifact_name TEXT NOT NULL,               -- e.g. "invoice-pdf"
+  artifact_type TEXT NOT NULL,               -- file, patch, text, message, data
+  storage_ref TEXT,                          -- S3 / Blob reference
+  size_bytes INTEGER,
+  sha256_hash TEXT,
+  content_preview TEXT                       -- Redacted preview or summary
+);
+
+CREATE INDEX IF NOT EXISTS idx_artifacts_action
+  ON artifacts (action_id);
+
+
+-- 7. Extend Existing AI Span Payloads Table
+--
+-- NOTE: `ai_span_payloads` is created by migration 019, which has not yet been
+-- translated to Postgres (migrations 011-030 land alongside the first hosted-
+-- Postgres deployment; see migrations-postgres/README.md). Until 019 exists in
+-- this directory, a bare `ALTER TABLE ai_span_payloads` would abort the whole
+-- run with `relation "ai_span_payloads" does not exist`.
+--
+-- We guard the extension on the table actually existing. On a fresh DB without
+-- 019 the block is a no-op; once 019 is translated it sorts before 031, so the
+-- column + index are added as intended. Both inner statements are idempotent
+-- (`IF NOT EXISTS`), so re-running after 019 lands is safe.
+DO $$
+BEGIN
+  IF to_regclass('ai_span_payloads') IS NOT NULL THEN
+    ALTER TABLE ai_span_payloads ADD COLUMN IF NOT EXISTS action_id TEXT;
+
+    CREATE INDEX IF NOT EXISTS idx_ai_payloads_action
+      ON ai_span_payloads (project_id, action_id)
+      WHERE action_id IS NOT NULL;
+  END IF;
+END
+$$;

package/src/migrations-postgres/032_payload_capture_flags.sql

@@ -0,0 +1,8 @@
+ALTER TABLE projects
+  ADD COLUMN IF NOT EXISTS payload_capture_enabled BOOLEAN NOT NULL DEFAULT FALSE;
+
+ALTER TABLE ai_span_payloads
+  ADD COLUMN IF NOT EXISTS input_hash TEXT;
+
+ALTER TABLE ai_span_payloads
+  ADD COLUMN IF NOT EXISTS output_hash TEXT;

package/src/migrations-postgres/033_eval_cases.sql

@@ -0,0 +1,55 @@
+-- RFC 0010 Phase 7: production-to-eval case persistence.
+--
+-- Eval cases are reusable fixtures captured from production telemetry. They
+-- retain stable source links back to the production entity that created the
+-- case while keeping prompts/payloads in explicitly redacted JSON fields.
+
+CREATE TABLE IF NOT EXISTS eval_cases (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  source_entity_type TEXT NOT NULL,
+  source_entity_id TEXT NOT NULL,
+  source_agent_run_id TEXT,
+  source_action_id TEXT,
+  source_ai_call_id TEXT,
+  source_tool_call_id TEXT,
+  source_trace_id TEXT,
+  source_span_id TEXT,
+  name TEXT NOT NULL,
+  expected_outcome TEXT,
+  rubric_json JSONB,
+  redacted_prompt_json JSONB,
+  reference_payload_json JSONB,
+  metadata_json JSONB NOT NULL DEFAULT '{}'::jsonb,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_eval_cases_project_created
+  ON eval_cases (project_id, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_eval_cases_project_source
+  ON eval_cases (project_id, source_entity_type, source_entity_id, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_eval_cases_agent_run
+  ON eval_cases (project_id, source_agent_run_id)
+  WHERE source_agent_run_id IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_eval_cases_action
+  ON eval_cases (project_id, source_action_id)
+  WHERE source_action_id IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_eval_cases_ai_call
+  ON eval_cases (project_id, source_ai_call_id)
+  WHERE source_ai_call_id IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_eval_cases_tool_call
+  ON eval_cases (project_id, source_tool_call_id)
+  WHERE source_tool_call_id IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_eval_cases_trace
+  ON eval_cases (project_id, source_trace_id)
+  WHERE source_trace_id IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_eval_cases_metadata_gin
+  ON eval_cases USING GIN (metadata_json);

package/src/migrations-postgres/034_eval_case_results.sql

@@ -0,0 +1,26 @@
+-- RFC 0010 Phase 7: reusable eval-case run results.
+--
+-- Results are produced by offline or CI evaluators against a saved production
+-- eval case. They intentionally store compact comparison metadata rather than
+-- raw prompts or completions.
+
+CREATE TABLE IF NOT EXISTS eval_case_results (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  eval_case_id TEXT NOT NULL,
+  run_id TEXT NOT NULL,
+  passed INTEGER NOT NULL,
+  score REAL,
+  actual_outcome TEXT,
+  details_json JSONB,
+  created_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_eval_case_results_case_created
+  ON eval_case_results (project_id, eval_case_id, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_eval_case_results_run
+  ON eval_case_results (project_id, run_id);
+
+CREATE INDEX IF NOT EXISTS idx_eval_case_results_details_gin
+  ON eval_case_results USING GIN (details_json);

package/src/migrations-postgres/035_metric_exemplars.sql

@@ -0,0 +1,31 @@
+-- Reverse index for OTLP metric exemplars.
+--
+-- metric_point.exemplars_json preserves the raw exemplar payload on the point,
+-- but investigation flows need trace/span lookup without scanning JSON blobs.
+-- This table turns exemplars into first-class correlation edges.
+
+CREATE TABLE IF NOT EXISTS metric_exemplars (
+  id TEXT PRIMARY KEY,
+  point_id TEXT NOT NULL REFERENCES metric_point(id),
+  series_id TEXT NOT NULL REFERENCES metric_series(id),
+  project_id TEXT NOT NULL,
+  metric_name TEXT NOT NULL,
+  service_name TEXT,
+  trace_id TEXT,
+  span_id TEXT,
+  ts_ns TEXT NOT NULL,
+  value DOUBLE PRECISION NOT NULL,
+  received_at TIMESTAMPTZ NOT NULL,
+  expires_at TIMESTAMPTZ NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_metric_exemplars_project_trace
+  ON metric_exemplars (project_id, trace_id, ts_ns)
+  WHERE trace_id IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_metric_exemplars_project_span
+  ON metric_exemplars (project_id, trace_id, span_id, ts_ns)
+  WHERE trace_id IS NOT NULL AND span_id IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_metric_exemplars_expires
+  ON metric_exemplars (expires_at);

package/src/migrations-postgres/036_trace_instrumentation_gaps.sql

@@ -0,0 +1,19 @@
+-- Postgres migration 036_trace_instrumentation_gaps.sql
+-- Computes and persists uninstrumented trace gaps during span ingestion.
+
+CREATE TABLE IF NOT EXISTS trace_instrumentation_gaps (
+  trace_id TEXT NOT NULL,
+  parent_span_id TEXT NOT NULL,
+  parent_service_name TEXT NOT NULL,
+  parent_span_name TEXT NOT NULL,
+  offset_ms INTEGER NOT NULL,
+  duration_ms INTEGER NOT NULL,
+  ratio_of_parent REAL NOT NULL,
+  child_span_count INTEGER NOT NULL,
+  async_parent INTEGER NOT NULL, -- 0/1 boolean
+  recommendation TEXT NOT NULL,
+  PRIMARY KEY (trace_id, parent_span_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_trace_gaps_duration 
+  ON trace_instrumentation_gaps (duration_ms DESC);

package/src/migrations-postgres/037_eval_runs.sql

@@ -0,0 +1,40 @@
+-- RFC 0010 Phase 7: durable eval runner records.
+--
+-- Eval runs group one or more eval case results under a candidate agent,
+-- prompt, and model configuration so production behavior can be compared with
+-- attempted fixes across repeatable runs.
+
+CREATE TABLE IF NOT EXISTS eval_runs (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL,
+  eval_case_id TEXT,
+  candidate_agent_id TEXT,
+  candidate_agent_version TEXT,
+  candidate_prompt_id TEXT,
+  candidate_prompt_version TEXT,
+  candidate_model_provider TEXT,
+  candidate_model TEXT,
+  candidate_model_version TEXT,
+  status TEXT NOT NULL,
+  started_at TEXT,
+  ended_at TEXT,
+  total_count INTEGER NOT NULL DEFAULT 0,
+  pass_count INTEGER NOT NULL DEFAULT 0,
+  fail_count INTEGER NOT NULL DEFAULT 0,
+  average_score REAL,
+  metadata_json JSONB NOT NULL DEFAULT '{}'::jsonb,
+  created_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_eval_runs_project_created
+  ON eval_runs (project_id, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_eval_runs_case_created
+  ON eval_runs (project_id, eval_case_id, created_at DESC)
+  WHERE eval_case_id IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_eval_runs_project_status_created
+  ON eval_runs (project_id, status, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_eval_runs_metadata_gin
+  ON eval_runs USING GIN (metadata_json);