@askexenow/exe-os 0.9.268 → 0.9.270

package/deploy/compose/.env.customer.example

@@ -72,6 +72,8 @@ API_ROUTER_KEY=exe_rk_CHANGEME_API_ROUTER_KEY
 # ANTHROPIC_API_KEY=CHANGEME_ANTHROPIC_API_KEY
 GATEWAY_HTTP_HOST_PORT=3100
 GATEWAY_WS_HOST_PORT=3101
+# CRM bridge: exe-gateway reaches exe-crm through Docker service DNS.
+CRM_GRAPHQL_URL=http://exe-crm:3000/graphql
 
 # --- Monitoring hub (PocketBase — local per-customer instance) ---
 MONITOR_HUB_IMAGE_TAG=update.askexe.com/askexe/exe-monitor-hub:v0.9.4

package/deploy/compose/.env.default

@@ -69,5 +69,6 @@ EXE_GATEWAY_WHATSAPP_VERIFY_TOKEN=CHANGEME_EXE_GATEWAY_WHATSAPP_VERIFY_TOKEN
 WHATSAPP_ACCESS_TOKEN=
 API_ROUTER_URL=https://gateway.askexe.com
 API_ROUTER_KEY=exe_rk_CHANGEME_API_ROUTER_KEY
+CRM_GRAPHQL_URL=http://exe-crm:3000/graphql
 GATEWAY_HTTP_HOST_PORT=3100
 GATEWAY_WS_HOST_PORT=3101

package/deploy/compose/.env.example

@@ -66,6 +66,8 @@ GATEWAY_HTTP_HOST_PORT=3100
 GATEWAY_WS_HOST_PORT=3101
 # GoTrue SSO — enable for unified auth across all services
 GATEWAY_GOTRUE_URL=http://gotrue:9999
+# CRM bridge: exe-gateway reaches exe-crm through Docker service DNS.
+CRM_GRAPHQL_URL=http://exe-crm:3000/graphql
 # Error forwarding to exe-monitor-hub (strongly recommended for production)
 ERROR_REPORTING_ENABLED=true
 MONITOR_ERROR_URL=http://exe-monitor-hub:8090/api/exe-monitor/errors

package/deploy/compose/docker-compose.yml

@@ -418,6 +418,7 @@ services:
       API_ROUTER_KEY: ${API_ROUTER_KEY:-}
       EXED_MCP_URL: http://exe-os:48739/mcp
       EXED_MCP_TOKEN: ${EXED_MCP_TOKEN:?EXED_MCP_TOKEN is required}
+      CRM_GRAPHQL_URL: ${CRM_GRAPHQL_URL:-http://exe-crm:3000/graphql}
       ERROR_REPORTING_ENABLED: "true"
       MONITOR_ERROR_URL: http://exe-monitor-hub:8090/api/exe-monitor/errors
       EXE_DAEMON_TOKEN: ${EXED_MCP_TOKEN:?EXED_MCP_TOKEN is required}
@@ -543,8 +544,11 @@ services:
     restart: unless-stopped
     # Token mode: `tunnel run --token <TOKEN>` — no local credentials file needed.
     # The token embeds the tunnel ID + credentials; routes are managed in the CF dashboard.
+    # --metrics exposes a local HTTP endpoint used by the healthcheck.
     command: >
-      tunnel run
+      tunnel
+      --metrics localhost:2000
+      run
       --token ${CLOUDFLARE_TUNNEL_TOKEN}
     depends_on:
       exe-crm:
@@ -560,11 +564,15 @@ services:
         ipv4_address: 10.42.0.31
       frontend:
         ipv4_address: 10.43.0.31
-    # No Docker healthcheck here. `cloudflared tunnel run --token ...` does not
-    # expose a local health endpoint by default, and `cloudflared tunnel info`
-    # can report failure in token-mode even while public hostnames are serving.
-    # stack-update verifies app health before starting the tunnel; tunnel
-    # reachability should be verified externally by the routed hostnames.
+    healthcheck:
+      # `tunnel info` requires API credentials unavailable in token mode.
+      # The command above exposes cloudflared's local metrics endpoint; use it
+      # for container liveness without hitting the Cloudflare control plane.
+      test: ["CMD-SHELL", "pgrep -x cloudflared && wget -q --spider http://localhost:2000/ready || exit 1"]
+      interval: 30s
+      timeout: 5s
+      start_period: 30s
+      retries: 5
     logging:
       driver: json-file
       options: { max-size: "10m", max-file: "3" }

package/deploy/compose/generate-env.ts

@@ -35,6 +35,7 @@ const LICENSE_KEY_COMMENT = "# injected by deploy_client";
 const MANUAL_VALUE_COMMENT = "# SET_MANUALLY";
 const EXAMPLE_LICENSE_KEY = "CHANGEME_EXE_LICENSE_KEY";
 const DEFAULT_API_ROUTER_URL = "https://gateway.askexe.com";
+const DEFAULT_CRM_GRAPHQL_URL = "http://exe-crm:3000/graphql";
 const DEFAULT_MONITOR_HUB_URL = "http://exe-monitor-hub:8090";
 const DEFAULT_MONITOR_AGENT_LISTEN = ":45876";
 const DEFAULT_EXE_MCP_HOST_BIND = "127.0.0.1";
@@ -115,6 +116,8 @@ export function generateEnv(options: GenerateEnvOptions): string {
     `GATEWAY_WS_HOST_PORT=${GATEWAY_WS_HOST_PORT}`,
     "# GoTrue SSO — enable for unified auth across all services",
     "GATEWAY_GOTRUE_URL=http://gotrue:9999",
+    "# CRM bridge: exe-gateway reaches exe-crm through Docker service DNS.",
+    `CRM_GRAPHQL_URL=${DEFAULT_CRM_GRAPHQL_URL}`,
     "# Error forwarding to exe-monitor-hub (strongly recommended for production)",
     "ERROR_REPORTING_ENABLED=true",
     "MONITOR_ERROR_URL=http://exe-monitor-hub:8090/api/exe-monitor/errors",
@@ -234,6 +237,8 @@ export function generateExampleEnv(): string {
     `GATEWAY_WS_HOST_PORT=${GATEWAY_WS_HOST_PORT}`,
     "# GoTrue SSO — enable for unified auth across all services",
     "GATEWAY_GOTRUE_URL=http://gotrue:9999",
+    "# CRM bridge: exe-gateway reaches exe-crm through Docker service DNS.",
+    `CRM_GRAPHQL_URL=${DEFAULT_CRM_GRAPHQL_URL}`,
     "# Error forwarding to exe-monitor-hub (strongly recommended for production)",
     "ERROR_REPORTING_ENABLED=true",
     "MONITOR_ERROR_URL=http://exe-monitor-hub:8090/api/exe-monitor/errors",

package/deploy/compose/init-db.sql

@@ -49,6 +49,75 @@ CREATE SCHEMA IF NOT EXISTS auth;
 CREATE SCHEMA IF NOT EXISTS billing;
 CREATE SCHEMA IF NOT EXISTS erp;
 
+-- Helpers for upgrading existing customer volumes. CREATE TABLE IF NOT EXISTS
+-- does not add columns to tables created by older init-db.sql versions, and
+-- CREATE INDEX IF NOT EXISTS still fails if the target column is missing.
+CREATE OR REPLACE FUNCTION pg_temp.exe_add_column_if_missing(
+  p_schema_name TEXT,
+  p_table_name TEXT,
+  p_column_name TEXT,
+  p_column_sql TEXT
+) RETURNS VOID LANGUAGE plpgsql AS $$
+BEGIN
+  IF to_regclass(format('%I.%I', p_schema_name, p_table_name)) IS NULL THEN
+    RETURN;
+  END IF;
+
+  IF NOT EXISTS (
+    SELECT 1
+    FROM information_schema.columns
+    WHERE table_schema = p_schema_name
+      AND table_name = p_table_name
+      AND column_name = p_column_name
+  ) THEN
+    EXECUTE format('ALTER TABLE %I.%I ADD COLUMN %s', p_schema_name, p_table_name, p_column_sql);
+  END IF;
+END $$;
+
+CREATE OR REPLACE FUNCTION pg_temp.exe_create_index_if_columns_exist(
+  p_index_name TEXT,
+  p_schema_name TEXT,
+  p_table_name TEXT,
+  p_column_names TEXT[],
+  p_create_sql TEXT
+) RETURNS VOID LANGUAGE plpgsql AS $$
+DECLARE
+  missing_column TEXT;
+BEGIN
+  IF to_regclass(format('%I.%I', p_schema_name, p_table_name)) IS NULL THEN
+    RETURN;
+  END IF;
+
+  SELECT c INTO missing_column
+  FROM unnest(p_column_names) AS c
+  WHERE NOT EXISTS (
+    SELECT 1
+    FROM information_schema.columns
+    WHERE table_schema = p_schema_name
+      AND table_name = p_table_name
+      AND column_name = c
+  )
+  LIMIT 1;
+
+  IF missing_column IS NOT NULL THEN
+    RAISE NOTICE 'Skipping index %.% because %.% is missing column %',
+      p_schema_name, p_index_name, p_schema_name, p_table_name, missing_column;
+    RETURN;
+  END IF;
+
+  IF to_regclass(format('%I.%I', p_schema_name, p_index_name)) IS NOT NULL THEN
+    RETURN;
+  END IF;
+
+  BEGIN
+    EXECUTE p_create_sql;
+  EXCEPTION
+    WHEN unique_violation THEN
+      RAISE NOTICE 'Skipping unique index %.% because existing rows are not unique',
+        p_schema_name, p_index_name;
+  END;
+END $$;
+
 -- Grant exe full access to all schemas
 DO $$ DECLARE s text; BEGIN
   FOR s IN SELECT schema_name FROM information_schema.schemata
@@ -79,9 +148,9 @@ CREATE TABLE IF NOT EXISTS raw.raw_events (
   projections JSONB DEFAULT '{}'::jsonb
 );
 
-CREATE INDEX IF NOT EXISTS idx_raw_events_unprocessed ON raw.raw_events (created_at) WHERE processed_at IS NULL;
-CREATE INDEX IF NOT EXISTS idx_raw_events_retryable ON raw.raw_events (failed_at) WHERE processed_at IS NULL AND failed_at IS NOT NULL AND retry_count < 5;
-CREATE UNIQUE INDEX IF NOT EXISTS uq_raw_events_dedup ON raw.raw_events (source, source_id, event_type);
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_raw_events_unprocessed', 'raw', 'raw_events', ARRAY['created_at', 'processed_at'], 'CREATE INDEX IF NOT EXISTS idx_raw_events_unprocessed ON raw.raw_events (created_at) WHERE processed_at IS NULL');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_raw_events_retryable', 'raw', 'raw_events', ARRAY['failed_at', 'processed_at', 'retry_count'], 'CREATE INDEX IF NOT EXISTS idx_raw_events_retryable ON raw.raw_events (failed_at) WHERE processed_at IS NULL AND failed_at IS NOT NULL AND retry_count < 5');
+SELECT pg_temp.exe_create_index_if_columns_exist('uq_raw_events_dedup', 'raw', 'raw_events', ARRAY['source', 'source_id', 'event_type'], 'CREATE UNIQUE INDEX IF NOT EXISTS uq_raw_events_dedup ON raw.raw_events (source, source_id, event_type)');
 
 -- ---------------------------------------------------------------------------
 -- Graph schema — Company Brain memory + GraphRAG projection targets.
@@ -114,10 +183,33 @@ CREATE TABLE IF NOT EXISTS graph.memory_records (
   created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
   updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
 );
-CREATE INDEX IF NOT EXISTS idx_graph_memory_records_agent ON graph.memory_records(agent_id);
-CREATE INDEX IF NOT EXISTS idx_graph_memory_records_project_time ON graph.memory_records(project_name, timestamp DESC);
-CREATE INDEX IF NOT EXISTS idx_graph_memory_records_status ON graph.memory_records(status);
-CREATE INDEX IF NOT EXISTS idx_graph_memory_records_source_type ON graph.memory_records(source_type);
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'id', 'id UUID DEFAULT gen_random_uuid()');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'agent_id', 'agent_id TEXT NOT NULL DEFAULT ''system''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'agent_role', 'agent_role TEXT NOT NULL DEFAULT ''ingest''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'session_id', 'session_id TEXT NOT NULL DEFAULT ''projection-worker''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'timestamp', 'timestamp TIMESTAMPTZ NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'tool_name', 'tool_name TEXT NOT NULL DEFAULT ''projection_worker''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'project_name', 'project_name TEXT NOT NULL DEFAULT ''exe-os''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'has_error', 'has_error BOOLEAN NOT NULL DEFAULT false');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'raw_text', 'raw_text TEXT NOT NULL DEFAULT ''''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'vector', 'vector vector(1024)');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'version', 'version INTEGER NOT NULL DEFAULT 0');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'task_id', 'task_id TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'intent', 'intent TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'outcome', 'outcome TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'domain', 'domain TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'trajectory', 'trajectory TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'memory_type', 'memory_type TEXT NOT NULL DEFAULT ''raw''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'source_type', 'source_type TEXT NOT NULL DEFAULT ''unknown''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'importance', 'importance INTEGER NOT NULL DEFAULT 5');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'status', 'status TEXT NOT NULL DEFAULT ''active''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'metadata', 'metadata JSONB NOT NULL DEFAULT ''{}''::jsonb');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'created_at', 'created_at TIMESTAMPTZ NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'memory_records', 'updated_at', 'updated_at TIMESTAMPTZ NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_graph_memory_records_agent', 'graph', 'memory_records', ARRAY['agent_id'], 'CREATE INDEX IF NOT EXISTS idx_graph_memory_records_agent ON graph.memory_records(agent_id)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_graph_memory_records_project_time', 'graph', 'memory_records', ARRAY['project_name', 'timestamp'], 'CREATE INDEX IF NOT EXISTS idx_graph_memory_records_project_time ON graph.memory_records(project_name, timestamp DESC)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_graph_memory_records_status', 'graph', 'memory_records', ARRAY['status'], 'CREATE INDEX IF NOT EXISTS idx_graph_memory_records_status ON graph.memory_records(status)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_graph_memory_records_source_type', 'graph', 'memory_records', ARRAY['source_type'], 'CREATE INDEX IF NOT EXISTS idx_graph_memory_records_source_type ON graph.memory_records(source_type)');
 
 CREATE TABLE IF NOT EXISTS graph.entities (
   id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
@@ -128,8 +220,14 @@ CREATE TABLE IF NOT EXISTS graph.entities (
   properties JSONB NOT NULL DEFAULT '{}'::jsonb,
   UNIQUE(name, type)
 );
-CREATE INDEX IF NOT EXISTS idx_graph_entities_type ON graph.entities(type);
-CREATE INDEX IF NOT EXISTS idx_graph_entities_last_seen ON graph.entities(last_seen DESC);
+SELECT pg_temp.exe_add_column_if_missing('graph', 'entities', 'id', 'id UUID DEFAULT gen_random_uuid()');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'entities', 'name', 'name TEXT NOT NULL DEFAULT ''''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'entities', 'type', 'type TEXT NOT NULL DEFAULT ''unknown''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'entities', 'first_seen', 'first_seen TIMESTAMPTZ NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'entities', 'last_seen', 'last_seen TIMESTAMPTZ NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'entities', 'properties', 'properties JSONB NOT NULL DEFAULT ''{}''::jsonb');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_graph_entities_type', 'graph', 'entities', ARRAY['type'], 'CREATE INDEX IF NOT EXISTS idx_graph_entities_type ON graph.entities(type)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_graph_entities_last_seen', 'graph', 'entities', ARRAY['last_seen'], 'CREATE INDEX IF NOT EXISTS idx_graph_entities_last_seen ON graph.entities(last_seen DESC)');
 
 CREATE TABLE IF NOT EXISTS graph.relationships (
   id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
@@ -143,16 +241,26 @@ CREATE TABLE IF NOT EXISTS graph.relationships (
   properties JSONB NOT NULL DEFAULT '{}'::jsonb,
   UNIQUE(source_entity_id, target_entity_id, type)
 );
-CREATE INDEX IF NOT EXISTS idx_graph_relationships_source ON graph.relationships(source_entity_id);
-CREATE INDEX IF NOT EXISTS idx_graph_relationships_target ON graph.relationships(target_entity_id);
-CREATE INDEX IF NOT EXISTS idx_graph_relationships_type ON graph.relationships(type);
+SELECT pg_temp.exe_add_column_if_missing('graph', 'relationships', 'source_entity_id', 'source_entity_id UUID');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'relationships', 'target_entity_id', 'target_entity_id UUID');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'relationships', 'type', 'type TEXT NOT NULL DEFAULT ''related_to''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'relationships', 'weight', 'weight DOUBLE PRECISION NOT NULL DEFAULT 1.0');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'relationships', 'confidence', 'confidence DOUBLE PRECISION NOT NULL DEFAULT 0.8');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'relationships', 'confidence_label', 'confidence_label TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'relationships', 'timestamp', 'timestamp TIMESTAMPTZ NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'relationships', 'properties', 'properties JSONB NOT NULL DEFAULT ''{}''::jsonb');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_graph_relationships_source', 'graph', 'relationships', ARRAY['source_entity_id'], 'CREATE INDEX IF NOT EXISTS idx_graph_relationships_source ON graph.relationships(source_entity_id)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_graph_relationships_target', 'graph', 'relationships', ARRAY['target_entity_id'], 'CREATE INDEX IF NOT EXISTS idx_graph_relationships_target ON graph.relationships(target_entity_id)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_graph_relationships_type', 'graph', 'relationships', ARRAY['type'], 'CREATE INDEX IF NOT EXISTS idx_graph_relationships_type ON graph.relationships(type)');
 
 CREATE TABLE IF NOT EXISTS graph.entity_memories (
   entity_id UUID NOT NULL REFERENCES graph.entities(id) ON DELETE CASCADE,
   memory_id UUID NOT NULL REFERENCES graph.memory_records(id) ON DELETE CASCADE,
   PRIMARY KEY(entity_id, memory_id)
 );
-CREATE INDEX IF NOT EXISTS idx_graph_entity_memories_memory ON graph.entity_memories(memory_id);
+SELECT pg_temp.exe_add_column_if_missing('graph', 'entity_memories', 'entity_id', 'entity_id UUID');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'entity_memories', 'memory_id', 'memory_id UUID');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_graph_entity_memories_memory', 'graph', 'entity_memories', ARRAY['memory_id'], 'CREATE INDEX IF NOT EXISTS idx_graph_entity_memories_memory ON graph.entity_memories(memory_id)');
 
 CREATE TABLE IF NOT EXISTS graph.agent_sessions (
   id TEXT PRIMARY KEY,
@@ -163,7 +271,13 @@ CREATE TABLE IF NOT EXISTS graph.agent_sessions (
   event_count INTEGER NOT NULL DEFAULT 0,
   properties JSONB NOT NULL DEFAULT '{}'::jsonb
 );
-CREATE INDEX IF NOT EXISTS idx_agent_sessions_agent_time ON graph.agent_sessions(agent_id, started_at);
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_sessions', 'agent_id', 'agent_id TEXT NOT NULL DEFAULT ''system''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_sessions', 'project_name', 'project_name TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_sessions', 'started_at', 'started_at TIMESTAMP(3) NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_sessions', 'last_event_at', 'last_event_at TIMESTAMP(3) NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_sessions', 'event_count', 'event_count INTEGER NOT NULL DEFAULT 0');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_sessions', 'properties', 'properties JSONB NOT NULL DEFAULT ''{}''::jsonb');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_agent_sessions_agent_time', 'graph', 'agent_sessions', ARRAY['agent_id', 'started_at'], 'CREATE INDEX IF NOT EXISTS idx_agent_sessions_agent_time ON graph.agent_sessions(agent_id, started_at)');
 
 CREATE TABLE IF NOT EXISTS graph.agent_goals (
   id TEXT PRIMARY KEY,
@@ -181,7 +295,20 @@ CREATE TABLE IF NOT EXISTS graph.agent_goals (
   updated_at TIMESTAMP(3) NOT NULL,
   source_memory_id TEXT
 );
-CREATE INDEX IF NOT EXISTS idx_agent_goals_project_status ON graph.agent_goals(project_name, status, priority);
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goals', 'statement', 'statement TEXT NOT NULL DEFAULT ''''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goals', 'owner_agent_id', 'owner_agent_id TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goals', 'project_name', 'project_name TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goals', 'status', 'status TEXT NOT NULL DEFAULT ''open''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goals', 'priority', 'priority INTEGER NOT NULL DEFAULT 5');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goals', 'success_criteria', 'success_criteria TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goals', 'parent_goal_id', 'parent_goal_id TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goals', 'due_at', 'due_at TIMESTAMP(3)');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goals', 'achieved_at', 'achieved_at TIMESTAMP(3)');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goals', 'supersedes_id', 'supersedes_id TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goals', 'created_at', 'created_at TIMESTAMP(3) NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goals', 'updated_at', 'updated_at TIMESTAMP(3) NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goals', 'source_memory_id', 'source_memory_id TEXT');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_agent_goals_project_status', 'graph', 'agent_goals', ARRAY['project_name', 'status', 'priority'], 'CREATE INDEX IF NOT EXISTS idx_agent_goals_project_status ON graph.agent_goals(project_name, status, priority)');
 
 CREATE TABLE IF NOT EXISTS graph.agent_events (
   id TEXT PRIMARY KEY,
@@ -202,10 +329,26 @@ CREATE TABLE IF NOT EXISTS graph.agent_events (
   payload JSONB NOT NULL DEFAULT '{}'::jsonb,
   created_at TIMESTAMP(3) NOT NULL
 );
-CREATE INDEX IF NOT EXISTS idx_agent_events_time ON graph.agent_events(occurred_at, sequence_index);
-CREATE INDEX IF NOT EXISTS idx_agent_events_session_seq ON graph.agent_events(session_id, sequence_index);
-CREATE INDEX IF NOT EXISTS idx_agent_events_goal_time ON graph.agent_events(goal_id, occurred_at);
-CREATE INDEX IF NOT EXISTS idx_agent_events_memory ON graph.agent_events(evidence_memory_id);
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_events', 'event_type', 'event_type TEXT NOT NULL DEFAULT ''event''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_events', 'occurred_at', 'occurred_at TIMESTAMP(3) NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_events', 'sequence_index', 'sequence_index INTEGER NOT NULL DEFAULT 0');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_events', 'actor_agent_id', 'actor_agent_id TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_events', 'agent_role', 'agent_role TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_events', 'project_name', 'project_name TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_events', 'session_id', 'session_id TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_events', 'task_id', 'task_id TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_events', 'goal_id', 'goal_id TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_events', 'parent_event_id', 'parent_event_id TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_events', 'intention', 'intention TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_events', 'outcome', 'outcome TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_events', 'evidence_memory_id', 'evidence_memory_id TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_events', 'impact', 'impact TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_events', 'payload', 'payload JSONB NOT NULL DEFAULT ''{}''::jsonb');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_events', 'created_at', 'created_at TIMESTAMP(3) NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_agent_events_time', 'graph', 'agent_events', ARRAY['occurred_at', 'sequence_index'], 'CREATE INDEX IF NOT EXISTS idx_agent_events_time ON graph.agent_events(occurred_at, sequence_index)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_agent_events_session_seq', 'graph', 'agent_events', ARRAY['session_id', 'sequence_index'], 'CREATE INDEX IF NOT EXISTS idx_agent_events_session_seq ON graph.agent_events(session_id, sequence_index)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_agent_events_goal_time', 'graph', 'agent_events', ARRAY['goal_id', 'occurred_at'], 'CREATE INDEX IF NOT EXISTS idx_agent_events_goal_time ON graph.agent_events(goal_id, occurred_at)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_agent_events_memory', 'graph', 'agent_events', ARRAY['evidence_memory_id'], 'CREATE INDEX IF NOT EXISTS idx_agent_events_memory ON graph.agent_events(evidence_memory_id)');
 
 CREATE TABLE IF NOT EXISTS graph.agent_goal_links (
   id TEXT PRIMARY KEY,
@@ -215,7 +358,12 @@ CREATE TABLE IF NOT EXISTS graph.agent_goal_links (
   target_type TEXT NOT NULL,
   created_at TIMESTAMP(3) NOT NULL
 );
-CREATE INDEX IF NOT EXISTS idx_agent_goal_links_goal ON graph.agent_goal_links(goal_id, target_type);
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goal_links', 'goal_id', 'goal_id TEXT NOT NULL DEFAULT ''''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goal_links', 'link_type', 'link_type TEXT NOT NULL DEFAULT ''related''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goal_links', 'target_id', 'target_id TEXT NOT NULL DEFAULT ''''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goal_links', 'target_type', 'target_type TEXT NOT NULL DEFAULT ''unknown''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_goal_links', 'created_at', 'created_at TIMESTAMP(3) NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_agent_goal_links_goal', 'graph', 'agent_goal_links', ARRAY['goal_id', 'target_type'], 'CREATE INDEX IF NOT EXISTS idx_agent_goal_links_goal ON graph.agent_goal_links(goal_id, target_type)');
 
 CREATE TABLE IF NOT EXISTS graph.agent_semantic_labels (
   id TEXT PRIMARY KEY,
@@ -228,8 +376,16 @@ CREATE TABLE IF NOT EXISTS graph.agent_semantic_labels (
   created_at TIMESTAMP(3) NOT NULL,
   updated_at TIMESTAMP(3) NOT NULL
 );
-CREATE INDEX IF NOT EXISTS idx_agent_semantic_labels_memory ON graph.agent_semantic_labels(source_memory_id, labeler);
-CREATE INDEX IF NOT EXISTS idx_agent_semantic_labels_event ON graph.agent_semantic_labels(event_id);
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_semantic_labels', 'source_memory_id', 'source_memory_id TEXT NOT NULL DEFAULT ''''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_semantic_labels', 'event_id', 'event_id TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_semantic_labels', 'labeler', 'labeler TEXT NOT NULL DEFAULT ''system''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_semantic_labels', 'schema_version', 'schema_version INTEGER NOT NULL DEFAULT 1');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_semantic_labels', 'confidence', 'confidence DOUBLE PRECISION NOT NULL DEFAULT 0');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_semantic_labels', 'labels', 'labels JSONB NOT NULL DEFAULT ''[]''::jsonb');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_semantic_labels', 'created_at', 'created_at TIMESTAMP(3) NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_semantic_labels', 'updated_at', 'updated_at TIMESTAMP(3) NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_agent_semantic_labels_memory', 'graph', 'agent_semantic_labels', ARRAY['source_memory_id', 'labeler'], 'CREATE INDEX IF NOT EXISTS idx_agent_semantic_labels_memory ON graph.agent_semantic_labels(source_memory_id, labeler)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_agent_semantic_labels_event', 'graph', 'agent_semantic_labels', ARRAY['event_id'], 'CREATE INDEX IF NOT EXISTS idx_agent_semantic_labels_event ON graph.agent_semantic_labels(event_id)');
 
 CREATE TABLE IF NOT EXISTS graph.agent_reflection_checkpoints (
   id TEXT PRIMARY KEY,
@@ -249,8 +405,23 @@ CREATE TABLE IF NOT EXISTS graph.agent_reflection_checkpoints (
   confidence DOUBLE PRECISION NOT NULL DEFAULT 0,
   created_at TIMESTAMP(3) NOT NULL
 );
-CREATE INDEX IF NOT EXISTS idx_agent_reflection_project_time ON graph.agent_reflection_checkpoints(project_name, window_end_at);
-CREATE INDEX IF NOT EXISTS idx_agent_reflection_session_time ON graph.agent_reflection_checkpoints(session_id, window_end_at);
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_reflection_checkpoints', 'project_name', 'project_name TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_reflection_checkpoints', 'session_id', 'session_id TEXT');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_reflection_checkpoints', 'window_start_at', 'window_start_at TIMESTAMP(3) NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_reflection_checkpoints', 'window_end_at', 'window_end_at TIMESTAMP(3) NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_reflection_checkpoints', 'event_count', 'event_count INTEGER NOT NULL DEFAULT 0');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_reflection_checkpoints', 'goal_count', 'goal_count INTEGER NOT NULL DEFAULT 0');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_reflection_checkpoints', 'success_count', 'success_count INTEGER NOT NULL DEFAULT 0');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_reflection_checkpoints', 'failure_count', 'failure_count INTEGER NOT NULL DEFAULT 0');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_reflection_checkpoints', 'risk_count', 'risk_count INTEGER NOT NULL DEFAULT 0');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_reflection_checkpoints', 'summary', 'summary TEXT NOT NULL DEFAULT ''''');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_reflection_checkpoints', 'learnings', 'learnings JSONB NOT NULL DEFAULT ''[]''::jsonb');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_reflection_checkpoints', 'next_actions', 'next_actions JSONB NOT NULL DEFAULT ''[]''::jsonb');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_reflection_checkpoints', 'evidence_event_ids', 'evidence_event_ids JSONB NOT NULL DEFAULT ''[]''::jsonb');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_reflection_checkpoints', 'confidence', 'confidence DOUBLE PRECISION NOT NULL DEFAULT 0');
+SELECT pg_temp.exe_add_column_if_missing('graph', 'agent_reflection_checkpoints', 'created_at', 'created_at TIMESTAMP(3) NOT NULL DEFAULT now()');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_agent_reflection_project_time', 'graph', 'agent_reflection_checkpoints', ARRAY['project_name', 'window_end_at'], 'CREATE INDEX IF NOT EXISTS idx_agent_reflection_project_time ON graph.agent_reflection_checkpoints(project_name, window_end_at)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_agent_reflection_session_time', 'graph', 'agent_reflection_checkpoints', ARRAY['session_id', 'window_end_at'], 'CREATE INDEX IF NOT EXISTS idx_agent_reflection_session_time ON graph.agent_reflection_checkpoints(session_id, window_end_at)');
 
 -- Minimal wiki projection tables used by projection-worker.ts before the
 -- full exe-wiki service has accepted API-ingested documents.
@@ -262,6 +433,7 @@ CREATE TABLE IF NOT EXISTS wiki.workspaces (
   created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
   updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
 );
+SELECT pg_temp.exe_add_column_if_missing('wiki', 'workspaces', 'id', 'id INTEGER GENERATED BY DEFAULT AS IDENTITY');
 
 CREATE TABLE IF NOT EXISTS wiki.workspace_documents (
   id BIGSERIAL PRIMARY KEY,
@@ -274,8 +446,10 @@ CREATE TABLE IF NOT EXISTS wiki.workspace_documents (
   created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
   updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
 );
-CREATE INDEX IF NOT EXISTS idx_wiki_workspace_documents_workspace ON wiki.workspace_documents(workspace_id);
-CREATE INDEX IF NOT EXISTS idx_wiki_workspace_documents_docpath ON wiki.workspace_documents(docpath);
+SELECT pg_temp.exe_add_column_if_missing('wiki', 'workspace_documents', 'workspace_id', 'workspace_id INTEGER');
+SELECT pg_temp.exe_add_column_if_missing('wiki', 'workspace_documents', 'docpath', 'docpath TEXT NOT NULL DEFAULT ''''');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_wiki_workspace_documents_workspace', 'wiki', 'workspace_documents', ARRAY['workspace_id'], 'CREATE INDEX IF NOT EXISTS idx_wiki_workspace_documents_workspace ON wiki.workspace_documents(workspace_id)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_wiki_workspace_documents_docpath', 'wiki', 'workspace_documents', ARRAY['docpath'], 'CREATE INDEX IF NOT EXISTS idx_wiki_workspace_documents_docpath ON wiki.workspace_documents(docpath)');
 
 -- Filtered schema — curated, deduplicated, entity-resolved data.
 -- Projected from raw.raw_events by daemon workers.
@@ -295,9 +469,10 @@ CREATE TABLE IF NOT EXISTS filtered.contacts (
   last_seen TIMESTAMPTZ NOT NULL DEFAULT now(),
   UNIQUE(platform, platform_id)
 );
+SELECT pg_temp.exe_add_column_if_missing('filtered', 'contacts', 'id', 'id UUID DEFAULT gen_random_uuid()');
 
-CREATE INDEX IF NOT EXISTS idx_filtered_contacts_phone ON filtered.contacts (phone);
-CREATE INDEX IF NOT EXISTS idx_filtered_contacts_platform ON filtered.contacts (platform);
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_filtered_contacts_phone', 'filtered', 'contacts', ARRAY['phone'], 'CREATE INDEX IF NOT EXISTS idx_filtered_contacts_phone ON filtered.contacts (phone)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_filtered_contacts_platform', 'filtered', 'contacts', ARRAY['platform'], 'CREATE INDEX IF NOT EXISTS idx_filtered_contacts_platform ON filtered.contacts (platform)');
 
 -- Normalized chat threads across platforms
 -- Column names match projection-worker.ts ensureFilteredSchema (source of truth)
@@ -315,9 +490,9 @@ CREATE TABLE IF NOT EXISTS filtered.conversations (
   UNIQUE(platform, source_ref)
 );
 
-CREATE INDEX IF NOT EXISTS idx_filtered_conversations_contact ON filtered.conversations (contact_id, sent_at DESC);
-CREATE INDEX IF NOT EXISTS idx_filtered_conversations_ts ON filtered.conversations (sent_at DESC);
-CREATE INDEX IF NOT EXISTS idx_filtered_conversations_thread_sent ON filtered.conversations (platform, thread_id, sent_at);
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_filtered_conversations_contact', 'filtered', 'conversations', ARRAY['contact_id', 'sent_at'], 'CREATE INDEX IF NOT EXISTS idx_filtered_conversations_contact ON filtered.conversations (contact_id, sent_at DESC)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_filtered_conversations_ts', 'filtered', 'conversations', ARRAY['sent_at'], 'CREATE INDEX IF NOT EXISTS idx_filtered_conversations_ts ON filtered.conversations (sent_at DESC)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_filtered_conversations_thread_sent', 'filtered', 'conversations', ARRAY['platform', 'thread_id', 'sent_at'], 'CREATE INDEX IF NOT EXISTS idx_filtered_conversations_thread_sent ON filtered.conversations (platform, thread_id, sent_at)');
 
 -- Knowledge documents for wiki ingestion
 -- Column names match projection-worker.ts ensureFilteredSchema (source of truth)
@@ -333,7 +508,7 @@ CREATE TABLE IF NOT EXISTS filtered.documents (
   UNIQUE(source, source_id)
 );
 
-CREATE INDEX IF NOT EXISTS idx_filtered_documents_type ON filtered.documents (doc_type);
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_filtered_documents_type', 'filtered', 'documents', ARRAY['doc_type'], 'CREATE INDEX IF NOT EXISTS idx_filtered_documents_type ON filtered.documents (doc_type)');
 
 -- Business events (meetings, orders, milestones)
 CREATE TABLE IF NOT EXISTS filtered.events (
@@ -348,8 +523,8 @@ CREATE TABLE IF NOT EXISTS filtered.events (
   created_at TIMESTAMPTZ DEFAULT now()
 );
 
-CREATE INDEX IF NOT EXISTS idx_filtered_events_type ON filtered.events (event_type, occurred_at DESC);
-CREATE INDEX IF NOT EXISTS idx_filtered_events_contact ON filtered.events (contact_id);
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_filtered_events_type', 'filtered', 'events', ARRAY['event_type', 'occurred_at'], 'CREATE INDEX IF NOT EXISTS idx_filtered_events_type ON filtered.events (event_type, occurred_at DESC)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_filtered_events_contact', 'filtered', 'events', ARRAY['contact_id'], 'CREATE INDEX IF NOT EXISTS idx_filtered_events_contact ON filtered.events (contact_id)');
 
 -- ---------------------------------------------------------------------------
 -- Gateway schema — WhatsApp/messaging accounts, contacts, threads, messages.
@@ -364,6 +539,7 @@ CREATE TABLE IF NOT EXISTS gateway.accounts (
   created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
   UNIQUE(platform, account_name)
 );
+SELECT pg_temp.exe_add_column_if_missing('gateway', 'accounts', 'id', 'id INTEGER GENERATED BY DEFAULT AS IDENTITY');
 
 CREATE TABLE IF NOT EXISTS gateway.contacts (
   id SERIAL PRIMARY KEY,
@@ -386,10 +562,11 @@ CREATE TABLE IF NOT EXISTS gateway.contacts (
   updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
   UNIQUE(platform, platform_jid)
 );
-CREATE INDEX IF NOT EXISTS idx_gw_contacts_phone ON gateway.contacts(phone);
-CREATE INDEX IF NOT EXISTS idx_gw_contacts_phone_jid ON gateway.contacts(phone_jid);
-CREATE INDEX IF NOT EXISTS idx_gw_contacts_lid_jid ON gateway.contacts(lid_jid);
-CREATE INDEX IF NOT EXISTS idx_gw_contacts_crm_person ON gateway.contacts(crm_person_id);
+SELECT pg_temp.exe_add_column_if_missing('gateway', 'contacts', 'id', 'id INTEGER GENERATED BY DEFAULT AS IDENTITY');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_gw_contacts_phone', 'gateway', 'contacts', ARRAY['phone'], 'CREATE INDEX IF NOT EXISTS idx_gw_contacts_phone ON gateway.contacts(phone)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_gw_contacts_phone_jid', 'gateway', 'contacts', ARRAY['phone_jid'], 'CREATE INDEX IF NOT EXISTS idx_gw_contacts_phone_jid ON gateway.contacts(phone_jid)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_gw_contacts_lid_jid', 'gateway', 'contacts', ARRAY['lid_jid'], 'CREATE INDEX IF NOT EXISTS idx_gw_contacts_lid_jid ON gateway.contacts(lid_jid)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_gw_contacts_crm_person', 'gateway', 'contacts', ARRAY['crm_person_id'], 'CREATE INDEX IF NOT EXISTS idx_gw_contacts_crm_person ON gateway.contacts(crm_person_id)');
 
 CREATE TABLE IF NOT EXISTS gateway.contact_identities (
   id SERIAL PRIMARY KEY,
@@ -403,8 +580,8 @@ CREATE TABLE IF NOT EXISTS gateway.contact_identities (
   last_seen TIMESTAMPTZ NOT NULL DEFAULT now(),
   UNIQUE(platform, identity_type, identity_value)
 );
-CREATE INDEX IF NOT EXISTS idx_gw_ci_contact ON gateway.contact_identities(contact_id);
-CREATE INDEX IF NOT EXISTS idx_gw_ci_value ON gateway.contact_identities(identity_value);
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_gw_ci_contact', 'gateway', 'contact_identities', ARRAY['contact_id'], 'CREATE INDEX IF NOT EXISTS idx_gw_ci_contact ON gateway.contact_identities(contact_id)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_gw_ci_value', 'gateway', 'contact_identities', ARRAY['identity_value'], 'CREATE INDEX IF NOT EXISTS idx_gw_ci_value ON gateway.contact_identities(identity_value)');
 
 CREATE TABLE IF NOT EXISTS gateway.threads (
   id SERIAL PRIMARY KEY,
@@ -440,8 +617,8 @@ CREATE TABLE IF NOT EXISTS gateway.messages (
   created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
   UNIQUE(account_id, message_id)
 );
-CREATE INDEX IF NOT EXISTS idx_gw_msg_thread_ts ON gateway.messages(thread_id, timestamp);
-CREATE INDEX IF NOT EXISTS idx_gw_msg_account ON gateway.messages(account_id, message_id);
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_gw_msg_thread_ts', 'gateway', 'messages', ARRAY['thread_id', 'timestamp'], 'CREATE INDEX IF NOT EXISTS idx_gw_msg_thread_ts ON gateway.messages(thread_id, timestamp)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_gw_msg_account', 'gateway', 'messages', ARRAY['account_id', 'message_id'], 'CREATE INDEX IF NOT EXISTS idx_gw_msg_account ON gateway.messages(account_id, message_id)');
 
 CREATE TABLE IF NOT EXISTS gateway.groups (
   id SERIAL PRIMARY KEY,
@@ -456,6 +633,7 @@ CREATE TABLE IF NOT EXISTS gateway.groups (
   updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
   UNIQUE(platform, group_jid)
 );
+SELECT pg_temp.exe_add_column_if_missing('gateway', 'groups', 'id', 'id INTEGER GENERATED BY DEFAULT AS IDENTITY');
 
 CREATE TABLE IF NOT EXISTS gateway.group_members (
   id SERIAL PRIMARY KEY,
@@ -469,8 +647,8 @@ CREATE TABLE IF NOT EXISTS gateway.group_members (
   updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
   UNIQUE(group_id, member_jid)
 );
-CREATE INDEX IF NOT EXISTS idx_gw_gm_member ON gateway.group_members(member_jid);
-CREATE INDEX IF NOT EXISTS idx_gw_gm_phone ON gateway.group_members(phone_jid);
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_gw_gm_member', 'gateway', 'group_members', ARRAY['member_jid'], 'CREATE INDEX IF NOT EXISTS idx_gw_gm_member ON gateway.group_members(member_jid)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_gw_gm_phone', 'gateway', 'group_members', ARRAY['phone_jid'], 'CREATE INDEX IF NOT EXISTS idx_gw_gm_phone ON gateway.group_members(phone_jid)');
 
 CREATE TABLE IF NOT EXISTS gateway.provider_keys (
   id SERIAL PRIMARY KEY,
@@ -488,6 +666,7 @@ CREATE TABLE IF NOT EXISTS gateway.customers (
   last_seen_at TIMESTAMPTZ NOT NULL DEFAULT now(),
   interaction_count INT NOT NULL DEFAULT 0
 );
+SELECT pg_temp.exe_add_column_if_missing('gateway', 'customers', 'id', 'id UUID DEFAULT gen_random_uuid()');
 
 CREATE TABLE IF NOT EXISTS gateway.customer_identities (
   id SERIAL PRIMARY KEY,
@@ -510,8 +689,8 @@ CREATE TABLE IF NOT EXISTS gateway.sessions (
   total_output_tokens INT NOT NULL DEFAULT 0,
   status TEXT NOT NULL DEFAULT 'active'
 );
-CREATE INDEX IF NOT EXISTS idx_gw_sess_cust ON gateway.sessions(customer_id, bot_id);
-CREATE INDEX IF NOT EXISTS idx_gw_sess_status ON gateway.sessions(status);
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_gw_sess_cust', 'gateway', 'sessions', ARRAY['customer_id', 'bot_id'], 'CREATE INDEX IF NOT EXISTS idx_gw_sess_cust ON gateway.sessions(customer_id, bot_id)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_gw_sess_status', 'gateway', 'sessions', ARRAY['status'], 'CREATE INDEX IF NOT EXISTS idx_gw_sess_status ON gateway.sessions(status)');
 
 -- ---------------------------------------------------------------------------
 -- Billing schema — licenses, stack releases, entitlements, deploy audits.
@@ -533,10 +712,11 @@ CREATE TABLE IF NOT EXISTS billing.licenses (
   created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
   created_by TEXT NOT NULL DEFAULT 'system'
 );
+SELECT pg_temp.exe_add_column_if_missing('billing', 'licenses', 'key', 'key TEXT');
 
-CREATE INDEX IF NOT EXISTS idx_billing_licenses_key ON billing.licenses (key);
-CREATE INDEX IF NOT EXISTS idx_billing_licenses_status ON billing.licenses (status);
-CREATE INDEX IF NOT EXISTS idx_billing_licenses_email ON billing.licenses (email);
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_billing_licenses_key', 'billing', 'licenses', ARRAY['key'], 'CREATE INDEX IF NOT EXISTS idx_billing_licenses_key ON billing.licenses (key)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_billing_licenses_status', 'billing', 'licenses', ARRAY['status'], 'CREATE INDEX IF NOT EXISTS idx_billing_licenses_status ON billing.licenses (status)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_billing_licenses_email', 'billing', 'licenses', ARRAY['email'], 'CREATE INDEX IF NOT EXISTS idx_billing_licenses_email ON billing.licenses (email)');
 
 CREATE TABLE IF NOT EXISTS billing.stack_releases (
   id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
@@ -550,8 +730,8 @@ CREATE TABLE IF NOT EXISTS billing.stack_releases (
   created_by TEXT NOT NULL DEFAULT 'system'
 );
 
-CREATE INDEX IF NOT EXISTS idx_billing_stack_releases_status ON billing.stack_releases (status);
-CREATE INDEX IF NOT EXISTS idx_billing_stack_releases_version ON billing.stack_releases (version);
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_billing_stack_releases_status', 'billing', 'stack_releases', ARRAY['status'], 'CREATE INDEX IF NOT EXISTS idx_billing_stack_releases_status ON billing.stack_releases (status)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_billing_stack_releases_version', 'billing', 'stack_releases', ARRAY['version'], 'CREATE INDEX IF NOT EXISTS idx_billing_stack_releases_version ON billing.stack_releases (version)');
 
 CREATE TABLE IF NOT EXISTS billing.stack_entitlements (
   id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
@@ -567,8 +747,8 @@ CREATE TABLE IF NOT EXISTS billing.stack_entitlements (
   created_at TIMESTAMPTZ NOT NULL DEFAULT now()
 );
 
-CREATE INDEX IF NOT EXISTS idx_billing_entitlements_token ON billing.stack_entitlements (token_hash);
-CREATE INDEX IF NOT EXISTS idx_billing_entitlements_status ON billing.stack_entitlements (status);
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_billing_entitlements_token', 'billing', 'stack_entitlements', ARRAY['token_hash'], 'CREATE INDEX IF NOT EXISTS idx_billing_entitlements_token ON billing.stack_entitlements (token_hash)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_billing_entitlements_status', 'billing', 'stack_entitlements', ARRAY['status'], 'CREATE INDEX IF NOT EXISTS idx_billing_entitlements_status ON billing.stack_entitlements (status)');
 
 CREATE TABLE IF NOT EXISTS billing.stack_deploy_audits (
   id TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
@@ -584,6 +764,6 @@ CREATE TABLE IF NOT EXISTS billing.stack_deploy_audits (
   created_at TIMESTAMPTZ NOT NULL DEFAULT now()
 );
 
-CREATE INDEX IF NOT EXISTS idx_billing_deploy_audits_license ON billing.stack_deploy_audits (license_key);
-CREATE INDEX IF NOT EXISTS idx_billing_deploy_audits_status ON billing.stack_deploy_audits (status);
-CREATE INDEX IF NOT EXISTS idx_billing_deploy_audits_started ON billing.stack_deploy_audits (started_at DESC NULLS LAST);
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_billing_deploy_audits_license', 'billing', 'stack_deploy_audits', ARRAY['license_key'], 'CREATE INDEX IF NOT EXISTS idx_billing_deploy_audits_license ON billing.stack_deploy_audits (license_key)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_billing_deploy_audits_status', 'billing', 'stack_deploy_audits', ARRAY['status'], 'CREATE INDEX IF NOT EXISTS idx_billing_deploy_audits_status ON billing.stack_deploy_audits (status)');
+SELECT pg_temp.exe_create_index_if_columns_exist('idx_billing_deploy_audits_started', 'billing', 'stack_deploy_audits', ARRAY['started_at'], 'CREATE INDEX IF NOT EXISTS idx_billing_deploy_audits_started ON billing.stack_deploy_audits (started_at DESC NULLS LAST)');